Casos de Uso Internos
Para qué sirve esta pantalla
Un caso de uso interno autoriza a una de tus aplicaciones a usar una clave sobre sus propios datos, por ejemplo un servicio que cifra registros y más tarde los descifra. Tú indicas la aplicación, las operaciones y la clave. La plataforma compone todo lo que esa autorización necesita: un actor criptográfico, su credencial de cliente, un contexto de intercambio y las concesiones de capacidad de las operaciones que declaraste.
El caso de uso referencia la clave; no es su dueño. La clave permanece en el Inventario de Claves con su propio ciclo de vida, y nada de lo que hagas en esta pantalla destruye material de claves.
Un tenant SIMPLE compone aquí toda su autorización, porque las pantallas que la componen a mano no se ofrecen a los tenants SIMPLE. Un tenant STANDARD también puede usar esta pantalla, como camino corto para una aplicación que trabaja sobre sus propios datos, y compone los flujos entre varias partes en sus otras pantallas.
Qué debe existir antes
- Una aplicación en tu tenant. Cada caso de uso pertenece exactamente a una aplicación.
- Nada más. Una clave no es un requisito previo: si no tienes ninguna que sirva, la generas dentro del propio diálogo, en el paso de la clave. Lo que sigue siendo cierto es que el propósito de la clave tiene que corresponder a las operaciones que declares —una clave creada para cifrar y descifrar no puede firmar ni verificar, y una clave de firma no puede cifrar— y el diálogo solo ofrece, o genera, claves que correspondan a lo que marcaste.
- El permiso de lectura de casos de uso internos, que es lo que muestra esta pantalla. Crear, suspender, reanudar, renovar y revocar un caso de uso son permisos aparte, y cada uno puede tenerse sin los demás.
Decisiones que tomas aquí
Aprovisionar un caso de uso
Con el permiso de creación de casos de uso internos, Nuevo caso de uso te pide:
- Un nombre (Name) y, si quieres, una descripción (Description).
- La aplicación (Application) a la que pertenece la autorización.
- Las operaciones (Operations) que la aplicación puede realizar.
ENCRYPT,DECRYPT,SIGN,VERIFY,REENCRYPT,RESIGNyEXPORT_KEYtrabajan sobre una clave; las operaciones de interoperabilidad yANALYZE_PKCS7no nombran ninguna. El caso de uso autoriza exactamente lo que marques, así que declara solo lo que la aplicación necesita. - Para
CONVERT_PKCS7_TO_JOSE, las claves de la conversión PKCS#7: el abridor, el destinatario cuya clave abre el sobre; los demás destinatarios hacia los que se recifra el contenido, que necesitan un abridor; y los firmantes. Elige un abridor, al menos un firmante o ambos; sin abridor solo se convierten datos firmados. La plataforma concede un recifrado desde el abridor hacia cada uno de los demás destinatarios y una nueva firma por cada firmante, y se rechaza al convertirlo un archivo que nombre un destinatario o firmante que no figure aquí. - La Clave sobre la que se ejecutan esas operaciones. Solo se puede seleccionar una clave cuyo propósito admita todas las operaciones declaradas y, si no existe ninguna, Generate abre el mismo asistente de generación de claves que usa el resto de la consola, limitado a las operaciones que declaraste.
- La clave existe en cuanto el asistente termina con éxito, no al enviar el caso de uso: el envío no crea ninguna clave por su cuenta y un envío fallido no tiene ninguna que dejar a medias. La clave generada permanece en el Inventario de Claves con su propio ciclo de vida aunque abandones el diálogo, y aquí nada la elimina.
- Para
REENCRYPToRESIGN, una Clave de origen y una Clave de destino. Elegir la misma clave para ambas es válido: así se llevan los datos desde una versión de material anterior de la clave a la actual, bajo una única identidad de clave.
El caso de uso es válido durante un año desde su creación. Su contexto le pertenece: no se puede situar en ese contexto ningún intercambio ni ninguna otra concesión.
Cuando se crea el caso de uso, el ID de cliente y el secreto de cliente de su nueva credencial se muestran una sola vez. Guarda el secreto en tu almacén de secretos antes de cerrar el diálogo. No se puede volver a mostrar; si lo pierdes, rota la credencial para obtener uno nuevo.
Suspender y reanudar
Con el permiso de suspensión de casos de uso internos, suspender detiene la carga de trabajo de inmediato. Se le deniega toda operación criptográfica, un token que ya tiene se rechaza en su siguiente llamada y una solicitud de un token nuevo se rechaza. Debes indicar un Motivo de la suspensión, que se registra en la auditoría a nombre de tu cuenta. Un caso de uso vencido no se suspende ni se reanuda: renuévalo.
Suspender lo conserva todo: las claves referenciadas y su material, las concesiones de capacidad, la credencial de cliente y los vínculos de identidad federada. En el caso poco frecuente de que el cambio no llegue a aplicarse, la contención converge en un plazo de diez minutos.
Con el permiso de reanudación de casos de uso internos, reanudar restaura el caso de uso exactamente como estaba. No se vuelve a aprovisionar nada, y la misma credencial vuelve a funcionar.
Validez, vencimiento y renovación
La lista muestra la fecha Válido hasta de cada caso de uso y, desde 30 días antes de esa fecha, un aviso de que vence en N días. Al final de su ventana el caso de uso deja de autorizar de inmediato y, poco después, aparece como Vencido. No se revoca nada: su actor, su credencial y sus concesiones se conservan.
Con el permiso de renovación de casos de uso internos, Renovar por un año más en la lista, o Renovar en el detalle, extiende la ventana hasta un año después de la fecha posterior entre hoy y su vencimiento actual, así que renovar antes de tiempo nunca acorta lo que queda. Un caso de uso vencido vuelve a estar activo con la misma credencial, así que los datos protegidos con él se pueden volver a descifrar; uno suspendido sigue suspendido. Un caso de uso revocado no se puede renovar.
Revocar
Con el permiso de revocación de casos de uso internos, Revocar caso de uso abre una confirmación. Escribe el nombre del caso de uso y da un Motivo, que es obligatorio y se registra en la auditoría. Revocar es definitivo: se retiran el actor criptográfico, su credencial, el contexto de intercambio y todas las concesiones de capacidad que compuso el caso de uso, y la aplicación ya no puede obtener un token. Las claves se conservan en el Inventario de Claves.
Retirar las concesiones retira también los permisos de operación que conferían, pero no de un token ya emitido. Ese los conserva durante el resto de su vida, hasta 900 segundos, con hasta 300 segundos de caché de concesiones además.
Suspende cuando esperas restaurar la misma autorización más adelante. Revoca cuando nunca más deba funcionar.
La lista muestra por defecto los casos de uso vigentes, activos y suspendidos. El filtro Estado muestra en su lugar los suspendidos, los vencidos o los revocados. Un caso de uso revocado solo ofrece su detalle: ya no se puede suspender, reanudar ni volver a revocar.
Un caso de uso también se revoca, por completo, cuando se destruye una clave que usa, aunque también nombre otra clave; esa otra clave no se destruye y no cambia en nada. Un caso de uso revocado muestra por qué terminó en lugar del estado sin más —Revocado por un operador, Revocado — clave destruida o Revocado — aplicación eliminada— y su detalle añade cuándo, el motivo registrado y, si se destruyó una clave, la identidad de esa clave.
Rotar la credencial y vincular identidades
Al abrir un caso de uso, su detalle aparece en cuatro pestañas: Resumen, Acceso, Capacidades y Actividad. La pestaña Acceso contiene dos decisiones.
- Con el permiso de rotación de credenciales de actores, Rotar… emite un secreto nuevo y lo muestra una sola vez. Cambia lo que puede obtener un token nuevo; un token de acceso ya emitido sigue funcionando hasta que vence. Suspender el caso de uso es lo que detiene un token que ya está en uso.
- En Identidades federadas puedes vincular una identidad externa para que la carga de trabajo se autentique con un token de un emisor en el que confía tu tenant, en lugar de un secreto guardado aquí. Requiere los permisos de identidad de carga de trabajo, un tenant con derecho a la federación de identidad de carga de trabajo y el emisor declarado en la Configuración de tu tenant. Un vínculo solo transmite identidad y no concede ninguna capacidad.
Mientras el caso de uso está suspendido, una credencial emitida o una identidad vinculada en esta pestaña no puede obtener un token; después de reanudarlo, ambas funcionan. El actor de un caso de uso revocado queda deshabilitado para siempre, así que la pestaña no ofrece ninguna de las dos decisiones e indica por qué: la plataforma rechaza una credencial o una vinculación nueva para él.
La pestaña Capacidades muestra lo que autoriza el caso de uso y sobre qué claves. La pestaña Actividad requiere el permiso de lectura de auditoría. Muestra el historial administrativo propio de tu tenant para el caso de uso; las acciones que un operador de la plataforma realizó en nombre de tu tenant no aparecen ahí.
Cómo se relaciona con otras pantallas
El caso de uso pertenece a una aplicación, y eliminar esa aplicación revoca sus casos de uso:
El actor, la credencial y las concesiones que compone un caso de uso son los mismos tipos de objeto que un tenant STANDARD compone a mano:
Las claves que referencia un caso de uso están en el Inventario de Claves. Revocar un caso de uso nunca toca sus claves, pero destruir una clave revoca todos los casos de uso que la usan, y el Inventario de Claves indica cuántos antes de que confirmes.
Dónde leer más
Esta página está en inglés: