Devuelve una clave de encriptación de datos (DEK) unida y los datos asociados. Usar esta método para encriptar datos importados a Google Drive de forma masiva por un dominio administrador.
Para obtener más detalles, consulta Encriptar y desencriptar datos
Solicitud HTTP
POST https://BASE_URL/privilegedwrap
Reemplaza BASE_URL
por la URL base.
Parámetros de ruta
Ninguno
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON | |
---|---|
{ "authentication": string, "key": string, "perimeter_id": string, "reason": string, "resource_name": string } |
Campos | |
---|---|
authentication |
Un JWT emitido por el proveedor de identidad (IdP) que confirma quién es el usuario. Consulta los tokens de autenticación. |
key |
La DEK codificada en base64. Tamaño máximo: 128 bytes |
perimeter_id |
Un valor opcional vinculado a la ubicación del documento que se puede usar para elegir qué perímetro se marca cuando se desenvuelve. |
reason |
Una cadena JSON de transferencia que proporciona contexto adicional sobre la operación. Se debe limpiar el JSON proporcionado antes de mostrarlo. Tamaño máximo: 1 KB |
resource_name |
Un identificador para el objeto encriptado por la DEK. |
Cuerpo de la respuesta
Si se aplica correctamente, este método muestra un objeto binario opaco que se almacena por Google Workspace junto con el objeto encriptado y se envían como están en cualquier instancia una operación de desenvolvimiento de claves.
Si la operación falla, se genera una respuesta estructurada de error el resultado.
El objeto binario debe contener la única copia de la DEK encriptada. en la que se pueden almacenar datos específicos para la implementación.
No almacenes la DEK en el sistema de Key Access Control List Service (KACLS).
En su lugar, lo encriptarás y lo mostrarás en el objeto wrapped_key
. Esto evita
discrepancias del ciclo de vida entre el documento y sus claves. Por ejemplo:
para garantizar que los datos del usuario
se borran por completo cuando los solicita
o asegurarse de que las versiones anteriores restablecidas a partir de una copia de seguridad puedan desencriptarse.
Representación JSON | |
---|---|
{ "wrapped_key": string } |
Campos | |
---|---|
wrapped_key |
El objeto binario codificado en base64. Tamaño máximo: 1 KB |
Ejemplo
En este ejemplo, se proporciona una solicitud de muestra y una respuesta para privilegedwrap
.
.
Solicitud
POST https://mykacls.example.com/v1/privilegedwrap
{
"key":"wHrlNOTI9mU6PBdqiq7EQA==",
"resource_name": "wdwqd…",
"authentication": "eyJhbGciOi…",
"reason": "admin import"
}
Respuesta
{
"wrapped_key": "3qTh6Mp+svPwYPlnZMyuj8WHTrM59wl/UI50jo61Qt/QubZ9tfsUc1sD62xdg3zgxC9quV4r+y7AkbfIDhbmxGqP64pWbZgFzOkP0JcSn+1xm/CB2E5IknKsAbwbYREGpiHM3nzZu+eLnvlfbzvTnJuJwBpLoPYQcnPvcgm+5gU1j1BjUaNKS/uDn7VbVm7hjbKA3wkniORC2TU2MiHElutnfrEVZ8wQfrCEpuWkOXs98H8QxUK4pBM2ea1xxGj7vREAZZg1x/Ci/E77gHxymnZ/ekhUIih6Pwu75jf+dvKcMnpmdLpwAVlE1G4dNginhFVyV/199llf9jmHasQQuaMFzQ9UMWGjA1Hg2KsaD9e3EL74A5fLkKc2EEmBD5v/aP+1RRZ3ISbTOXvxqYIFCdSFSCfPbUhkc9I2nHS0obEH7Q7KiuagoDqV0cTNXWfCGJ1DtIlGQ9IA6mPDAjX8Lg=="
}