Metodo: wrapprivatekey

Esegue il wrapping della chiave privata di un utente. Si tratta di un'operazione con privilegi che può essere eseguita solo dagli amministratori autorizzati del servizio di elenco 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 di elenco di controllo dell'accesso per le chiavi (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à (IdP) che dichiara l'identità dell'utente. Consulta Token di autenticazione.
perimeter_id

string (UTF-8)

L'ID perimetro da criptare con la chiave.
private_key

string

La DEK con codifica Base64. Dimensioni massime: 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 sottoposta a wrapping con codifica 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=="
}