Skip to content

Concesiones de Capacidad

Para qué sirve esta pantalla

Una concesión de capacidad autoriza a un actor criptográfico a realizar operaciones concretas sobre claves concretas, dentro de un contexto de intercambio. Responde cuatro preguntas en un solo registro: quién puede actuar, qué puede hacer, sobre qué claves y en qué condiciones. Esta pantalla muestra las concesiones de tu tenant y es donde creas concesiones independientes y las revocas.

Llamar a la API criptográfica exige una credencial, un permiso de operación que viaja en el token del actor y una concesión. Una concesión activa aporta también el permiso: mientras está activa, los tokens del actor llevan el permiso de operación correspondiente, y cuando la concesión desaparece el permiso desaparece con ella. Cada operación se sigue comprobando contra las concesiones al ejecutarse.

Qué debe existir antes

Esta pantalla es para los tenants que componen la autorización a mano. No se ofrece a los tenants SIMPLE: un tenant SIMPLE usa Casos de Uso Internos, que crean las concesiones que necesita cada caso de uso.

Antes de trabajar aquí necesitas:

  • Un actor criptográfico que reciba la concesión y las claves que la concesión nombrará.
  • Un contexto de intercambio activo que no pertenezca a ningún caso de uso interno. Toda concesión pertenece a uno, y el asistente no termina sin él.
  • El permiso de listar concesiones de capacidad, que muestra esta pantalla. Crear y revocar son permisos aparte. Crear exige además el permiso de asignar roles a actores cuando la concesión daría al actor un permiso de operación que todavía no tiene.

Decisiones que tomas aquí

Crear una concesión

Con el permiso de crear concesiones de capacidad, Nueva concesión abre un asistente de seis pasos: el actor, la capacidad, las claves, el contexto de intercambio, la política de restricción y una revisión que muestra el permiso de operación que la concesión otorgará. Crear concesión la escribe, y entra en vigor de inmediato.

La creación se rechaza mientras un operador actúa en nombre de otra persona, cuando el actor no está activo y cuando el actor pertenece a un caso de uso interno, que actúa solo para su caso de uso.

Elegir las operaciones

El paso de capacidad ofrece ENCRYPT, DECRYPT, SIGN y VERIFY, que una concesión puede combinar, y las transformaciones REENCRYPT y RESIGN. Una transformación mueve datos de claves de origen a claves de destino, así que una concesión lleva exactamente una de ellas y ninguna otra capacidad: emite las demás como concesiones propias.

Una concesión que lleva varias operaciones tiene un único presupuesto de uso. Con una política que limita los usos o exige un solo uso, cada llamada admitida cuenta contra el mismo límite, sea cual sea su operación.

Elegir las claves

Para las operaciones sobre una clave eliges una Clave del activo. Para REENCRYPT o RESIGN eliges uno o más pares ordenados, cada uno con una clave de origen y una de destino, y Agregar par añade otro. Los datos de cada clave de origen pasan a su clave de destino, solo en ese sentido; un par cuyo origen y destino son la misma clave es válido.

Elige claves cuyo propósito corresponda a las operaciones: una capacidad que la clave no admite se rechaza al crear la concesión, nombrando la clave. Una concesión que escribe con su clave (ENCRYPT o SIGN) necesita una clave activa.

En lugar de una clave, puedes marcar la casilla de comodín para las operaciones sobre una clave. La concesión se aplica entonces a todas las claves del tenant, incluidas las que se creen después. Resérvalo para un actor que de verdad necesite todas las claves.

Elegir el contexto de intercambio

Toda concesión pertenece a un contexto de intercambio: el marco de negocio en el que autoriza. La lista ofrece los contextos activos que no pertenecen a ningún caso de uso interno; si no hay ninguno, el paso lo indica y te envía a Contextos de intercambio. Suspender o cerrar el contexto detiene la concesión con él.

Elegir una política de restricción

Una concesión puede referenciar una política de restricción o quedar — Sin restricciones —. La concesión fija la versión actual de la política, y la revisión muestra cuál. La pantalla de políticas de restricción explica cada límite y el horario.

Las concesiones no se superponen

Las concesiones vigentes de un actor nunca se superponen. Una concesión cuyas operaciones y claves coinciden con una concesión vigente del mismo actor, en cualquier contexto de intercambio, se rechaza: «Esta concesión se superpondría con una concesión vigente del mismo actor. No se escribió nada.» El asistente muestra cada concesión en conflicto como un enlace. Revoca o reduce la que estorba, o reduce la nueva.

Cuando una concesión se agota

Una concesión cuya política permite un solo uso, o un número máximo de usos, se consume con el uso que la agota, haya tenido éxito o no esa operación. La columna Consumo indica por qué, tras cuántos usos y cuándo; muestra un guion mientras la concesión está vigente. Las concesiones consumidas siguen en la lista, atenuadas y sin Revocar. Las revocadas salen de ella.

Revocar una concesión

Con el permiso de revocar concesiones de capacidad, Revocar abre una confirmación. Escribe el nombre del actor, o el identificador de la concesión cuando el actor no tiene nombre, y completa ¿Por qué se revoca esta concesión?: el motivo es obligatorio y queda registrado en la auditoría. Una concesión revocada no se puede restaurar.

El acceso no se detiene al instante. Un token que el actor ya tiene conserva sus permisos hasta 900 segundos, y un servicio puede leer una concesión en caché hasta 300 segundos más. Las demás concesiones del actor no cambian.

Una concesión que pertenece a un intercambio activo no se revoca aquí: revócala en el paso de concesiones del intercambio, o revoca el intercambio. Cuando un intercambio termina, sus concesiones se retiran con él.

Cambiar los límites de una concesión

El actor, las operaciones, las claves y el contexto de una concesión nunca cambian. Sus límites cambian con Cambiar versión, que la fija a otra versión de cualquier política de restricción. Se ofrece en el paso de concesiones de un intercambio y en el panel de la topología de intercambios.

Abrir una concesión

Al seleccionar la fila de una concesión se abre su detalle junto a la lista, con una pestaña Información y una pestaña Actividad. Información muestra el identificador, el actor, las capacidades y los permisos de operación que otorgan, las claves o el comodín, el contexto de intercambio, la política de restricción con su versión fijada, cuándo se creó y se actualizó, y su estado: Vigente o consumida. Una concesión revocada ya no se sirve; su detalle lo indica y Actividad sigue mostrando su historial.

Actividad muestra los cambios hechos a la concesión y cada operación criptográfica que autorizó, y permite elegir entre ambos, solo los cambios o solo las operaciones. Desde ahí se abre la Auditoría acotada a esta concesión.

Cómo se relaciona con otras pantallas

En la lista, el actor, el contexto de intercambio y la política de restricción de una concesión son enlaces a sus propios detalles. La columna Intercambio muestra el contexto de intercambio de la concesión. Cada clave que nombra una concesión abre su propio resumen de solo lectura.

Dónde leer más