Skip to content

Registrar un caso de uso criptográfico interno

Autoriza a una de tus aplicaciones a usar una clave sobre sus propios datos, por ejemplo un servicio que cifra registros y luego los descifra, en un solo paso. La plataforma crea el actor criptográfico, su credencial de cliente, un contexto de intercambio y las concesiones de capacidad que necesita el caso de uso. Esta página también explica cómo suspender, reanudar, renovar y revocar un caso de uso.

Quién puede hacerlo

Un administrador del tenant, un gestor de claves del tenant, o un superadministrador de plataforma desde dentro del tenant, donde la consola actúa como administrador del tenant. Crear, suspender, reanudar, renovar y revocar un caso de uso son permisos distintos; la consola ofrece Nuevo caso de uso solo con el permiso para crear, y Renovar por un año más solo con el permiso para renovar. Los tres roles los tienen. Generar una clave desde el diálogo también requiere el permiso para orquestar claves.

La pantalla sirve a los tenants SIMPLE, que componen aquí toda su autorización, y a los tenants STANDARD. En un tenant RAPIDAPI la consola no ofrece crear un caso de uso.

Antes de empezar

  • La aplicación existe y está activa. Cada caso de uso pertenece a exactamente una aplicación.
  • Decide qué operaciones necesita la aplicación. El caso de uso autoriza exactamente lo que marques. ENCRYPT y DECRYPT necesitan una clave de encapsulamiento, SIGN y VERIFY una clave de firma; una misma clave no puede hacer ambas cosas.
  • El caso de uso hace referencia a la clave, no la crea. La clave conserva su propio ciclo de vida, y revocar el caso de uso nunca la toca. Si no existe una clave adecuada, puedes generar una desde el diálogo.
  • El secreto de cliente se muestra una sola vez, cuando se crea el caso de uso. Ten listo un almacén de secretos seguro.

Pasos

  1. Abre Casos de uso internos.
  2. Selecciona Nuevo caso de uso. Se abre el diálogo Aprovisionar caso de uso interno.
  3. Escribe el nombre y, de forma opcional, una Descripción. Elige la aplicación.
  4. Marca las operaciones. Una operación que la clave seleccionada no puede atender no está disponible.
  5. Elige la Clave sobre la que se ejecutan las operaciones, o selecciona Generar una clave para crear una. Para REENCRYPT o RESIGN, elige una Clave de origen y una Clave de destino; usar la misma clave para ambas mueve los datos de una versión de material anterior de la clave a la actual.
  6. Selecciona Aprovisionar.
  7. En Credencial creada: guárdala ahora, copia el ID de cliente y el Secreto de cliente (se muestra UNA SOLA VEZ) en tu almacén de secretos y luego selecciona He guardado el secreto de forma segura.

Para gestionar un caso de uso existente, usa los controles de su fila:

  • Suspender caso de uso: indica un Motivo de la suspensión y selecciona Suspender. Se niega a la carga de trabajo toda operación criptográfica; no se destruye nada.
  • Reanudar caso de uso: lo restaura exactamente. No se pide confirmación.
  • Renovar por un año más: mueve su fin de validez a un año después de la fecha más tardía entre hoy y su fin actual.
  • Revocar caso de uso: escribe el nombre del caso de uso para confirmar, indica un Motivo y selecciona Revocar. Es terminal.

Qué ves cuando funcionó

La consola lo confirma con Caso de uso "<name>" aprovisionado, y el caso de uso aparece en la lista con su aplicación, su clave referenciada y su estado de autorización. Es válido durante un año desde su creación. La aplicación se autentica con el ID de cliente y el secreto que guardaste y puede ejecutar sobre la clave las operaciones que marcaste.

Las demás acciones se confirman con Caso de uso "<name>" suspendido. Reanudar lo restaura exactamente., Caso de uso "<name>" reanudado., "<name>" renovado por un año más o Caso de uso "<name>" revocado. Sus claves permanecen en el inventario. Revocar retira el actor, su credencial, el contexto de intercambio y cada concesión de capacidad que compuso el caso de uso.

Si falla

Qué ves Causa Qué hacer
El nombre, la aplicación y al menos una operación son obligatorios Un campo obligatorio está vacío Complétalo
Selecciona una clave para este caso de uso Se marcó una operación que trabaja sobre una clave y no se eligió ninguna clave Elige o genera una clave
REENCRYPT/RESIGN requieren una clave de destino Una operación de nuevo cifrado o de nueva firma no tiene clave de destino Elige la Clave de destino
El caso de uso se rechaza como duplicado, o porque la aplicación no está activa Otro caso de uso del tenant tiene ese nombre, o la aplicación no está activa Elige otro nombre, o reactiva la aplicación
El caso de uso se rechaza porque la clave no puede llevar una operación El propósito, el algoritmo o las operaciones de clave permitidas de la clave no admiten una operación que marcaste; no se crea nada Elige otra clave, o desmarca la operación
Un caso de uso revocado no se puede renovar. El caso de uso está revocado Crea un caso de uso nuevo
Generar una clave indica que a la cuenta le falta un permiso No tienes el permiso para orquestar claves Selecciona una clave que ya exista, o pregunta a un administrador del tenant

Sin la consola

Superficie Cómo
CLI de gestión de claves ankasecure-km internal-crypto-use-cases create --body-file <file>; internal-crypto-use-cases suspend --id <uuid> --reason <text>; internal-crypto-use-cases resume --id <uuid>; internal-crypto-use-cases renew --id <uuid>; internal-crypto-use-cases revoke --id <uuid> --reason <text>
Admin SDK InternalCryptoUseCaseOperations.create(CreateInternalCryptoUseCaseRequest), suspend(UUID, SuspendInternalCryptoUseCaseRequest), resume(UUID), renew(UUID), revoke(UUID, RevokeInternalCryptoUseCaseRequest)
API POST /api/v3/admin/tenants/{tenantId}/internal-crypto-use-cases (operación createInternalCryptoUseCase); PATCH /api/v3/admin/tenants/{tenantId}/internal-crypto-use-cases/{useCaseId}/suspend (operación suspendInternalCryptoUseCase); PATCH /api/v3/admin/tenants/{tenantId}/internal-crypto-use-cases/{useCaseId}/resume (operación resumeInternalCryptoUseCase); POST /api/v3/admin/tenants/{tenantId}/internal-crypto-use-cases/{useCaseId}/renew (operación renewInternalCryptoUseCase); POST /api/v3/admin/tenants/{tenantId}/internal-crypto-use-cases/{useCaseId}/revoke (operación revokeInternalCryptoUseCase)

Relacionado