Método: unwrap

Devuelve la clave de encriptación de datos (DEK) desencriptada.

Para obtener más información, consulta Encripta y desencripta datos.

Solicitud HTTP

POST https://KACLS_URL/unwrap

Reemplaza KACLS_URL por la URL del servicio de lista de control de acceso a 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,
  "authorization": string,
  "reason": string,
  "wrapped_key": string
}
Campos
authentication

string

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

string

Un JWT que confirme que el usuario tiene permiso para separar una clave para resource_name Consulta los tokens de autorización.
reason

string (UTF-8)

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

string

El objeto binario 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 unwrap.

Solicitud

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

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

Respuesta

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