Skip to content

Importar una clave existente

Trae a tu tenant la clave pública de una clave que ya existe en otro lugar, como la clave de cifrado o de verificación de un socio, para que las aplicaciones puedan cifrar para ella o verificar con ella con un solo identificador.

Quién puede hacerlo

Un administrador del tenant, un gestor de claves del tenant o un superadministrador de plataforma que trabaja dentro del tenant. La consola ofrece Importar clave a quien tiene el permiso para importar una clave pública o el permiso para importar un keystore, y habilita la pestaña Importar desde JSON solo con el permiso para importar una clave pública.

Antes de empezar

  • Esta importación solo acepta material de clave pública. Aquí nunca se acepta una clave privada; para traer una clave privada al tenant, migra un keystore.
  • Prepara un archivo .json que describa la clave. Debe llevar kid (el Key ID que la clave tendrá de por vida), kty (un tipo de clave publicado) y alg. Una clave simple lleva publicKey en Base64; una clave compuesta nombra en alg una combinación que incluye el catálogo de este despliegue y proporciona una clave pública por componente.
  • Solo se pueden solicitar operaciones de clave pública: encrypt, verify, wrapKey y deriveKey, y solo las que admite el algoritmo.
  • El algoritmo debe ser uno que admita la política de algoritmos de tu tenant.
  • Hay una licencia del despliegue vigente, y el estado del ciclo de vida del tenant todavía permite las operaciones del ciclo de vida de las claves.

Pasos

  1. Abre Importar clave desde la navegación de tu tenant.
  2. Selecciona Importar desde JSON. Es la pestaña con la que se abre la pantalla cuando tienes el permiso para ella.
  3. En Paso 1 — Subir archivo, arrastra el archivo .json al área de carga, o selecciona el área para buscarlo. Selecciona Eliminar para elegir otro archivo.
  4. En Paso 2 — Previsualizar y validar, revisa lo que la consola leyó del archivo: el Key ID, el tipo, el algoritmo y las operaciones de clave. La consola solo comprueba que el archivo sea JSON válido y que lleve kid, kty y alg; todas las demás decisiones corresponden al servidor.
  5. Selecciona Importar clave. Solo se habilita cuando ambas comprobaciones se cumplen.

Qué ves cuando funcionó

La consola muestra Clave importada correctamente con el Key ID, el tipo y el algoritmo de la clave, y el estado y el origen que devolvió el servidor para ella. El origen de una clave importada es IMPORTED. La importación queda registrada en la auditoría.

Selecciona Ver en el inventario para abrir Inventario de claves, donde la clave se gestiona a partir de entonces como cualquier otra. Importar no autoriza a nadie a usar la clave: el uso se autoriza por separado.

Si falla

Qué ves Causa Qué hacer
"JSON no válido: no se pudo analizar el contenido del archivo." El archivo no es JSON válido Corrige el archivo y vuelve a subirlo
"Falta el campo kid, kty o alg" Falta uno de los tres miembros obligatorios Agrega el miembro que falta
Se rechaza la importación por una entrada no válida Base64 mal formado, una operación de clave privada solicitada, un tipo de clave fuera del vocabulario publicado, o una combinación compuesta que el catálogo no incluye Corrige el archivo como indica el mensaje
Se rechaza la importación nombrando la política de algoritmos La política de algoritmos del tenant no admite el algoritmo Usa un algoritmo admitido, o pide a un administrador que revise la política de algoritmos
Se rechaza la importación por un conflicto Existe una clave con este Key ID con un material público distinto, o el Key ID ya está en uso Elige otro Key ID
Se rechaza la importación por la licencia No hay ninguna licencia del despliegue vigente Un administrador de la plataforma instala una licencia válida
La pestaña Importar desde JSON está deshabilitada, con "Tu rol no incluye esta importación" No tienes el permiso para importar una clave pública Pide el permiso a un administrador

Sin la consola

Superficie Cómo
CLI de gestión de claves ankasecure-km keys import-key --body-file <json> (- lee la entrada estándar)
Admin SDK KeyOperations.importKey(KeyImportRequest)
API POST /api/v3/admin/tenants/{tenantId}/keys/import-key (operación importKey)

Relacionado