Metodo: wrapprivatekey

Cripta la chiave privata di un utente. Si tratta di un'operazione con privilegi che può essere eseguita solo da amministratori autorizzati del servizio elenchi di controllo dell'accesso per le chiavi (KACLS). Questa API è facoltativa. Né Google né il client Gmail chiamano questa API. La specifica fornita è un consiglio, non un requisito.

Richiesta HTTP

POST https://KACLS_URL/wrapprivatekey

Sostituisci KACLS_URL con l'URL del servizio Key Access Control List (KACLS).

Parametri del percorso

Nessuno.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "authentication": string,
  "perimeter_id": string,
  "private_key": string
}
Campi
authentication

string

Un JWT emesso dal provider di identità che dichiara l'identità dell'utente. Vedi token di autenticazione.
perimeter_id

string (UTF-8)

L'ID perimetro da criptare con la chiave.
private_key

string

La DEK con codifica Base64. Dimensione massima: 128 byte.

Corpo della risposta

In caso di esito positivo, questo metodo restituisce la chiave privata sottoposta a wrapping.

Se l'operazione non va a buon fine, viene restituita una risposta di errore strutturata.

Rappresentazione JSON 
{
  "wrapped_private_key": string
}
Campi
wrapped_private_key

string

La chiave privata con wrapping codificata in base64. Dimensioni massime: 8 kB.

Esempio

Questo esempio fornisce una richiesta e una risposta di esempio per il metodo wrapprivatekey.

Richiesta

POST https://mykacls.example.org/v1/wrapprivatekey

{
  "private_key": "-----BEGIN RSA PRIVATE KEY-----\\nMIIJ......\\n-----END RSA PRIVATE KEY-----",
  "perimeter_id": ""
}

Risposta

{
  "wrapped_private_key": "LpyCSy5ddy82PIp/87JKaMF4Jmt1KdrbfT1iqpB7uhVd3OwZiu+oq8kxIzB7Lr0iX4aOcxM6HiUyMrGP2PG8x0HkpykbUKQxBVcfm6SLdsqigT9ho5RYw20M6ZXNWVRetFSleKex4SRilTRny38e2ju/lUy0KDaCt1hDUT89nLZ1wsO3D1F3xk8J7clXv5fe7GPRd1ojo82Ny0iyVO7y7h1lh2PACHUFXOMzsdURYFCnxhKAsadccCxpCxKh5x8p78PdoenwY1tnT3/X4O/4LAGfT4fo98Frxy/xtI49WDRNZi6fsL6BQT4vS/WFkybBX9tXaenCqlRBDyZSFhatPQ==",
}