Skip to content

Quitar una declaración BYOK

Retira el backend de protección de claves propio de tu tenant antes de que se vincule, para que el tenant vuelva a estar protegido por el backend del nivel superior: el nivel gestionado de su edición, o el del despliegue.

Quién puede hacerlo

Un administrador del tenant o un gestor de claves del tenant, o un superadministrador de plataforma que trabaja dentro del tenant. La consola muestra Retirar la declaración a cualquiera que pueda leer el panel, y la deja no disponible, con el motivo, para quien no tiene el permiso para gestionar el backend de protección de claves del tenant.

Antes de empezar

  • El backend está declarado y todavía no está vinculado. Solo se puede retirar en ese intervalo. Una vez vinculado el backend, la consola indica que retirar la declaración ya no está disponible y que no hay una forma de autoservicio para volver atrás: a partir de entonces, tus claves salen de tu propio KMS solo mediante un traslado de custodia de claves (consulta Trasladar las claves del tenant a otro backend).
  • Para corregir una coordenada de clave o una credencial equivocada antes de la vinculación, no tienes que retirar: Cambiar backend vuelve a declarar el backend, sus coordenadas y su credencial a la vez.

Pasos

  1. Abre Configuración en la navegación de tu tenant y luego la pestaña Integraciones.
  2. En la fila Protección de claves, selecciona su acción. El panel de protección de claves se abre sobre la página.
  3. Selecciona Retirar la declaración.
  4. Lee la confirmación ¿Retirar el backend declarado de este tenant?, que nombra el tenant, y selecciona Retirar y descartar.

Qué ves cuando funcionó

La consola indica Se retiró la declaración. Este tenant vuelve a estar protegido por el nivel superior. El panel vuelve al estado en que no hay nada declarado, muestra qué backend protege ahora al tenant y vuelve a ofrecer Configurar un backend BYOK para este tenant. La credencial sellada se descarta con la declaración, y el retiro se escribe en tu registro de auditoría.

Si falla

Qué ves Causa Qué hacer
No disponible para este tenant: el backend ya está activo, así que la declaración ya no se puede retirar El backend está vinculado Traslada las claves del tenant a otro backend con un traslado de custodia de claves
No disponible para ti: tu rol no incluye el permiso para gestionar el backend de protección de claves de este tenant A tu rol le falta el permiso Pídeselo a un administrador del tenant o a un gestor de claves del tenant
Se rechaza el retiro al confirmar El backend se vinculó después de leer el panel, o todavía hay en curso una declaración del mismo tenant Vuelve a cargar el panel y lee su estado actual

Sin la consola

Superficie Cómo
CLI de gestión de claves Ningún comando
Admin SDK No disponible
API DELETE /api/v3/admin/tenants/{tenantId}/key-backend/byok (operación deleteByok)

Relacionado