Methode: privilegdwrap

Gibt einen umschlossenen Datenverschlüsselungsschlüssel (Data Encryption Key, DEK) und zugehörige Daten zurück. Mit dieser Methode können Sie Daten, die von einem Domainadministrator in Google Drive importiert wurden, im Bulk verschlüsseln.

Weitere Informationen finden Sie unter Daten verschlüsseln und entschlüsseln.

HTTP-Anfrage

POST https://KACLS_URL/privilegedwrap

Ersetzen Sie KACLS_URL durch die URL des Key Access Control List Service (KACLS).

Pfadparameter

Keine.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "authentication": string,
  "key": string,
  "perimeter_id": string,
  "reason": string,
  "resource_name": string
}
Felder
authentication

string

Ein JWT, das vom Identitätsanbieter (Identity Provider, IdP) ausgestellt wurde und angibt, wer der Nutzer ist. Weitere Informationen finden Sie unter Authentifizierung tokens.
key

string

Der base64-codierte DEK. Maximale Größe: 128 Byte.
perimeter_id

string (UTF-8)

Ein optionaler Wert, der mit dem Speicherort des Dokuments verknüpft ist und mit dem ausgewählt werden kann welcher Perimeter beim Entschlüsseln geprüft wird.
reason

string (UTF-8)

Ein JSON-String, der zusätzlichen Kontext zum Vorgang bietet. Das bereitgestellte JSON sollte vor der Anzeige bereinigt werden. Maximale Größe: 1 KB.
resource_name

string (UTF-8)

Eine Kennung für das Objekt, das mit dem DEK verschlüsselt wurde.

Antworttext

Bei Erfolg gibt diese Methode ein undurchsichtiges binäres Objekt zurück, das von Google Workspace zusammen mit dem verschlüsselten Objekt gespeichert und bei allen nachfolgenden Vorgängen zum Entschlüsseln des Schlüssels unverändert gesendet wird.

Wenn der Vorgang fehlschlägt, wird eine strukturierte Fehlermeldung zurückgegeben.

Das binäre Objekt sollte die einzige Kopie des verschlüsselten DEK enthalten. Implementierungsspezifische Daten können darin gespeichert werden.

Speichern Sie den DEK nicht im Key Access Control List Service (KACLS), sondern verschlüsseln Sie ihn und geben Sie ihn im Objekt wrapped_key zurück. Dadurch werden Abweichungen bei der Lebensdauer zwischen dem Dokument und seinen Schlüsseln verhindert. So kann beispielsweise sichergestellt werden, dass die Daten des Nutzers vollständig gelöscht werden, wenn er dies anfordert, oder dass frühere Versionen, die aus einer Sicherung wiederhergestellt wurden, entschlüsselt werden können.

JSON-Darstellung 
{
  "wrapped_key": string
}
Felder
wrapped_key

string

Das base64-codierte binäre Objekt. Maximale Größe: 1 KB.

Beispiel

Dieses Beispiel enthält eine Beispielanfrage und -antwort für die Methode privilegedwrap.

Anfrage

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

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

Antwort

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