Método: wrapprivatekey

Une la clave privada de un usuario. Esta es una operación con privilegios y solo se puede que realizan administradores autorizados del Servicio de listas de control de acceso a las claves (KACLS). Esta API es opcional. Ni Google ni el cliente de Gmail llaman a esta API. La especificación proporcionada es una recomendación, no un requisito.

Solicitud HTTP

POST https://BASE_URL/wrapprivatekey

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,
  "perimeter_id": string,
  "private_key": string
}
Campos
authentication

string

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

perimeter_id

string (UTF-8)

El ID de perímetro para encriptar con la clave.

private_key

string

La DEK codificada en base64. Tamaño máximo: 128 bytes

Cuerpo de la respuesta

Si se aplica correctamente, este método muestra la clave privada unida.

Si la operación falla, se genera una respuesta estructurada de error el resultado.

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

string

La clave privada unida codificada en base64. Tamaño máximo: 8 KB.

Ejemplo

En este ejemplo, se proporciona una solicitud de muestra y una respuesta para wrapprivatekey. .

Solicitud

POST https://mykacls.example.org/v1/wrapprivatekey

{
  "private_key": "-----BEGIN RSA PRIVATE KEY-----\\nMIIJ......\\n-----END RSA PRIVATE KEY-----",
  "perimeter_id": ""
}

Respuesta

{
  "wrapped_private_key": "LpyCSy5ddy82PIp/87JKaMF4Jmt1KdrbfT1iqpB7uhVd3OwZiu+oq8kxIzB7Lr0iX4aOcxM6HiUyMrGP2PG8x0HkpykbUKQxBVcfm6SLdsqigT9ho5RYw20M6ZXNWVRetFSleKex4SRilTRny38e2ju/lUy0KDaCt1hDUT89nLZ1wsO3D1F3xk8J7clXv5fe7GPRd1ojo82Ny0iyVO7y7h1lh2PACHUFXOMzsdURYFCnxhKAsadccCxpCxKh5x8p78PdoenwY1tnT3/X4O/4LAGfT4fo98Frxy/xtI49WDRNZi6fsL6BQT4vS/WFkybBX9tXaenCqlRBDyZSFhatPQ==",
}