Método: privilegedunwrap

Desencripta los datos que se exportan desde Google en un contexto privilegiado. Anteriormente, se conocía como TakeoutUnwrap. Devuelve la clave de encriptación de datos (DEK) que se unió con wrap sin verificar el documento original ni la lista de control de acceso (LCA) del archivo. Para ver un ejemplo de caso de uso, consulta Google Takeout.

Solicitud HTTP

POST https://KACLS_URL/privilegedunwrap

Reemplaza KACLS_URL por la URL del servicio de lista de control de acceso a las claves (KACLS).

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,
  "reason": string,
  "resource_name": string,
  "wrapped_key": string
}
Campos
authentication

string

Es un JWT emitido por el IdP que afirma quién es el usuario. Consulta tokens de autenticación.
reason

string (UTF-8)

Es una cadena JSON de transferencia que proporciona contexto adicional sobre la operación. El JSON proporcionado se debe limpiar antes de mostrarse. El tamaño máximo es de 1 KB.
resource_name

string (UTF-8)

Es un identificador del objeto encriptado por la DEK. Este valor debe coincidir con el parámetro resource_name que se usó para encapsular la clave. Tamaño máximo: 128 bytes.
wrapped_key

string

Objeto binario en base64 que devuelve wrap.

Cuerpo de la respuesta

Si se ejecuta correctamente, este método devuelve la clave de encriptación del documento.

Si la operación falla, se debe devolver una respuesta de error estructurada.

Representación JSON 
{
  "key": string
}
Campos
key

string

Es la DEK codificada en Base64.

Ejemplo

En este ejemplo, se proporciona una solicitud y una respuesta de muestra para el método privilegedunwrap.

Solicitud

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

{
   "wrapped_key": "7qTh6Mp+svVwYPlnZMyuj8WHTrM59wl/UI50jo61Qt/QubZ9tfsUc1sD62xdg3zgxC9quV4r+y7AkbfIDhbmxGqP64pWbZgFzOkP0JcSn+1xm/CB2E5IknKsAbwbYREGpiHM3nzZu+eLnvlfbzvTnJuJwBpLoPYQcnPvcgm+5gU1j1BjUaNKS/uDn7VbVm7hjbKA3wkniORC2TU2MiHElutnfrEVZ8wQfrCEpuWkOXs98H8QxUK4pBM2ea1xxGj7vREAZZg1x/Ci/E77gHxymnZ/ekhUIih6Pwu75jf+dvKcMnpmdLpwAVlE1G4dNginhFVyV/199llf9jmHasQQuaMFzQ9UMWGjA1Hg2KsaD9e3EL74A5fLkKc2EEmBD5v/aP+1RRZ3ISbTOXvxqYIFCdSFSCfPbUhkc9I2nHS0obEH7Q7KiuagoDqV0cTNXWfCGJ1DtIlGQ9IA6mPDAjX8Lg==",
   "authentication": "eyJhbGciOi…"
   "reason": "{client:'takeout' op:'read'}"
   "resource_name": "item123"
}

Respuesta

{
    "key": "0saNxttLMQULfXuTbRFJzi/QJokN1jW16u0yaNvvLdQ="
}