Método: privilegedunwrap

Desencripta los datos exportados desde Google en un contexto con privilegios. Conocido anteriormente como TakeoutUnwrap Devuelve la clave de encriptación de datos (DEK) que se unió con wrap sin revisar el documento original o la lista de control de acceso a archivos (LCA). Para ver un ejemplo de un caso de uso, consulta lo siguiente: Google Takeout.

Solicitud HTTP

POST https://KACLS_URL/privilegedunwrap

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

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

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

reason

string (UTF-8)

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

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 genera una respuesta estructurada de error debería mostrarse.

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

string

La DEK codificada en base64.

Ejemplo

En este ejemplo, se proporciona una solicitud de muestra y una respuesta para 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="
}