Skip to content

Crear una clave

Crea una clave criptográfica nueva en tu tenant, lista para que las aplicaciones cifren, descifren, firmen o verifiquen con ella.

Quién puede hacerlo

Un administrador del tenant o un gestor de claves del tenant. La consola ofrece Generar clave solo a quien tiene el permiso para crear claves.

Antes de empezar

  • El tenant tiene un backend de protección de claves. Hasta que se configure uno, la consola se niega a crear claves y lo indica.
  • Decide si quieres una clave de un solo algoritmo o una clave híbrida (compuesta). Una clave híbrida combina un algoritmo clásico y uno post-cuántico en una sola clave.

Pasos

  1. Abre Inventario de claves desde la navegación del tenant.
  2. Selecciona Generar clave.
  3. Elige cómo construir la clave:
    • Algoritmo único — Guiado responde unas preguntas sobre tu caso de uso y recomienda un algoritmo.
    • Algoritmo único — Avanzado te permite elegir cualquier algoritmo del catálogo y cada parámetro.
    • Clave híbrida / compuesta combina un algoritmo clásico y uno post-cuántico.
  4. En el camino guiado, completa cada paso y selecciona Continuar:
    1. Identificador de clave (opcional): un nombre que usarán tus aplicaciones. Si lo dejas vacío, la consola genera uno único. Solo se aceptan letras minúsculas, números, guiones y guiones bajos.
    2. Propósito: Cifrar datos o Firmar documentos.
    3. Sensibilidad: de Pública / Baja a Alto secreto / Crítica. La consola recomienda un algoritmo para esa sensibilidad y muestra las alternativas.
    4. Ciclo de vida: Desarrollo, Pruebas, Producción o Cumplimiento. Cada uno establece el vencimiento, el límite de uso y si la clave se puede exportar.
    5. Revisar y generar: revisa el Resumen de la configuración.
  5. Selecciona Generar clave.

Qué ves cuando funcionó

La consola muestra Clave generada con el identificador de la clave, y la creación queda registrada en la auditoría. Selecciona Ver clave para abrir el detalle de la clave: la muestra como activa, con su algoritmo, los límites de su ciclo de vida y su primera versión de material.

La clave aparece en Inventario de claves, y las aplicaciones pueden usarla con su identificador en cuanto estén autorizadas.

Si falla

Qué ves Causa Qué hacer
Se rechaza crear una clave porque no hay ningún backend de protección de claves configurado El tenant no tiene backend, o el nivel HSM gestionado de su edición está en un módulo PKCS#11 que no sirve el token del nivel Un administrador del tenant configura el backend de protección de claves, o un operador de la plataforma corrige el nivel, y luego vuelves a intentarlo
Se rechaza el identificador Contiene caracteres distintos de letras minúsculas, números, guiones y guiones bajos Corrígelo, o déjalo vacío
El identificador ya está en uso Existe o existió una clave con ese identificador: un identificador nunca se reutiliza en un tenant Elige otro identificador
No se puede recomendar ningún algoritmo La política de algoritmos no admite ninguno de los candidatos para ese propósito y esa sensibilidad Usa Algoritmo único — Avanzado, o pide a un administrador que revise la política de algoritmos

Sin la consola

Superficie Cómo
CLI de gestión de claves ankasecure-km keys create --kid <id> --algorithm <algorithm> --purpose <purpose>, o --body-file con la solicitud completa
Admin SDK KeyOperations.create(OrchestrationKeyRequest)
API POST /api/v3/admin/tenants/{tenantId}/keys (operación createKey)

Relacionado