Método: privilegedunwrap

Desencripta los datos exportados de Google en un contexto con privilegios. Antes conocido como TakeoutUnwrap. Muestra la clave de encriptación de datos (DEK) que se unió mediante wrap sin verificar el documento original o la lista de control de acceso (LCA) a los archivos. 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 de acceso

Ningún contenido de este tipo

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

Un JWT emitido por el IdP que confirma quién es el usuario. Consulta los tokens de autenticación.

reason

string (UTF-8)

Una string JSON de transferencia que proporciona contexto adicional sobre la operación. El JSON proporcionado debe limpiarse antes de mostrarse. Tamaño máximo: 1 KB

resource_name

string (UTF-8)

Un identificador para el objeto encriptado por la DEK. Este valor debe coincidir con el resource_name que se usa para unir la clave. Tamaño máximo: 128 bytes.

wrapped_key

string

El objeto binario en base64 que muestra wrap

Cuerpo de la respuesta

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

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

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

string

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="
}