Metodo: privilegiodwrap

Restituisce una chiave di crittografia dei dati (DEK) sottoposta a wrapping e i dati associati. Utilizza questo metodo per criptare in blocco i dati importati in Google Drive da un amministratore di dominio.

Per maggiori dettagli, vedi Criptare e decriptare i dati.

Richiesta HTTP

POST https://KACLS_URL/privilegedwrap

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,
  "key": string,
  "perimeter_id": string,
  "reason": string,
  "resource_name": string
}
Campi
authentication

string

Un JWT emesso dal provider di identità (IdP) che dichiara l'identità dell'utente. Vedi Token di autenticazione.
key

string

La DEK con codifica in base64. Dimensione massima: 128 byte.
perimeter_id

string (UTF-8)

Un valore facoltativo collegato alla posizione del documento che può essere utilizzato per scegliere il perimetro da controllare durante l'annullamento del wrapping.
reason

string (UTF-8)

Una stringa JSON pass-through che fornisce un contesto aggiuntivo sull' operazione. Il JSON fornito deve essere sottoposto a sanitizzazione prima di essere visualizzato. Dimensione massima: 1 KB.
resource_name

string (UTF-8)

Un identificatore per l'oggetto criptato dalla DEK.

Corpo della risposta

In caso di esito positivo, questo metodo restituisce un oggetto binario opaco archiviato da Google Workspace insieme all'oggetto criptato e inviato così com'è in qualsiasi operazione di annullamento del wrapping della chiave successiva.

Se l'operazione non riesce, viene restituita una risposta di errore strutturata.

L'oggetto binario deve contenere l'unica copia della DEK criptata e può contenere dati specifici dell'implementazione.

Non archiviare la DEK nel sistema del servizio Key Access Control List (KACLS), ma criptala e restituiscila nell'oggetto wrapped_key. In questo modo si evitano discrepanze nella durata tra il documento e le relative chiavi. Ad esempio, per assicurarti che i dati dell'utente vengano eliminati completamente quando l'utente lo richiede o per assicurarti che le versioni precedenti ripristinate da un backup siano decriptabili.

Rappresentazione JSON 
{
  "wrapped_key": string
}
Campi
wrapped_key

string

L'oggetto binario con codifica in base64. Dimensione massima: 1 KB.

Esempio

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

Richiesta

POST https://mykacls.example.com/v1/privilegedwrap

{
   "key":"wHrlNOTI9mU6PBdqiq7EQA==",
   "resource_name": "wdwqd…",
   "authentication": "eyJhbGciOi…",
   "reason": "admin import"
}

Risposta

{
    "wrapped_key": "3qTh6Mp+svPwYPlnZMyuj8WHTrM59wl/UI50jo61Qt/QubZ9tfsUc1sD62xdg3zgxC9quV4r+y7AkbfIDhbmxGqP64pWbZgFzOkP0JcSn+1xm/CB2E5IknKsAbwbYREGpiHM3nzZu+eLnvlfbzvTnJuJwBpLoPYQcnPvcgm+5gU1j1BjUaNKS/uDn7VbVm7hjbKA3wkniORC2TU2MiHElutnfrEVZ8wQfrCEpuWkOXs98H8QxUK4pBM2ea1xxGj7vREAZZg1x/Ci/E77gHxymnZ/ekhUIih6Pwu75jf+dvKcMnpmdLpwAVlE1G4dNginhFVyV/199llf9jmHasQQuaMFzQ9UMWGjA1Hg2KsaD9e3EL74A5fLkKc2EEmBD5v/aP+1RRZ3ISbTOXvxqYIFCdSFSCfPbUhkc9I2nHS0obEH7Q7KiuagoDqV0cTNXWfCGJ1DtIlGQ9IA6mPDAjX8Lg=="
}