Skip to content

Editar, suspender, reactivar o quitar un actor

Cambia los datos de un actor criptográfico, detenlo de forma temporal, deja que vuelva a funcionar, quítale un rol o revócalo de forma definitiva.

Quién puede hacerlo

Un administrador del tenant o un gestor de claves del tenant, y un superadministrador de plataforma que trabaja en un tenant en un despliegue de nube privada o local. La consola ofrece Revocar actor solo a quien tiene el permiso para eliminar actores, y cada uno de los demás controles solo a quien tiene su permiso: actualizar, suspender o reactivar actores, o quitar roles. Ninguno de estos controles se ofrece en un tenant SIMPLE.

Antes de empezar

  • Revocar un actor es terminal. Se rechaza mientras lo referencien credenciales, concesiones de capacidad o intercambios criptográficos activos, así que revoca esos primero.
  • Un actor predeterminado no se puede revocar por sí solo. Se deshabilita cuando se elimina su aplicación.
  • Suspender es reversible: un actor suspendido conserva sus credenciales, sus roles y sus concesiones, pero no puede autenticarse ni ejecutar operaciones hasta que se reactive.
  • Revocar y suspender necesitan un motivo, que se registra en la auditoría.

Pasos

Abre Actores criptográficos desde la navegación del tenant y selecciona el actor. Luego:

Para editar sus datos:

  1. En Información, selecciona Editar. Editar no se ofrece en un actor deshabilitado.
  2. Cambia el nombre visible, la descripción, el tipo, el propósito o la ventana de validez. Solo se guardan los campos que cambies; el nombre, la aplicación y el estado no se cambian aquí. Cada fecha es un día UTC: déjala como está para conservarla, o vacíala para quitar ese límite.
  3. Selecciona Guardar cambios.

Para suspenderlo, mientras está activo:

  1. En Información, selecciona Suspender.
  2. Completa ¿Por qué se suspende este actor?.
  3. Selecciona Suspender actor.

Para reactivarlo, mientras está suspendido:

  1. En Información, selecciona Reactivar.
  2. Selecciona Reactivar actor.

Para quitarle un rol:

  1. Ve a Roles y selecciona el control para quitar en la fila del rol. Solo se ofrece para un rol que el actor tiene por asignación directa, y no en un actor deshabilitado.
  2. Selecciona Quitar rol. Un rol que también otorga una concesión de capacidad se mantiene mientras la concesión lo otorgue.

Para revocarlo:

  1. En Información, selecciona Revocar actor.
  2. Escribe el nombre del actor exactamente como se muestra y completa el Motivo.
  3. Selecciona Revocar.

Qué ves cuando funcionó

Un actor revocado sale de la lista, y la consola confirma que el actor se eliminó. Una edición se confirma con Actor "" actualizado; una fecha de validez cambiada se aplica a las 00:00 UTC de ese día. Un rol quitado deja de aplicarse en el próximo token del actor: un token ya emitido conserva los permisos del rol hasta que vence, así que suspende el actor para detenerlo de inmediato.

Un actor suspendido indica SUSPENDED, y vuelve a indicar ACTIVE cuando se reactiva.

Si falla

Qué ves Causa Qué hacer
Un mensaje que indica que el actor criptográfico no se puede eliminar mientras tenga dependientes, y que primero hay que revocarlos ("Cryptographic Actor cannot be deleted while it still has dependents: … Revoke the dependents first.") Credenciales, concesiones de capacidad o intercambios criptográficos activos todavía referencian el actor Revócalos y luego revoca el actor
No se ofrece Revocar actor El actor es el actor predeterminado de su aplicación Elimina la aplicación si el actor ya no se necesita
Se rechaza suspender o reactivar porque el estado no lo permite El actor ya está en ese estado, o está deshabilitado, lo que es definitivo Revisa el estado del actor
Se rechaza un cambio por ser un cambio concurrente Otra solicitud cambió el actor después de leerlo; no se escribió nada Vuelve a leer el actor e inténtalo de nuevo. Consulta Concurrent Modification (en inglés)
No se cambió el actor, No se suspendió el actor, No se reactivó el actor o No se quitó el rol, con el detalle del servidor El servidor rechazó el cambio; el paso sigue abierto Actúa según el detalle que se muestra e inténtalo de nuevo
Válido hasta debe ser estrictamente posterior a Válido desde. La ventana que deja la edición terminaría en el momento en que empieza o antes Corrige una de las dos fechas

Sin la consola

Superficie Cómo
API PATCH /api/v3/admin/tenants/{tenantId}/actors/{actorId} (operación updateActor): cambia el nombre visible, la descripción, el tipo, el propósito y la ventana de validez. Solo cambian los campos que envías. Un límite de validez (validFrom o validUntil) que omites conserva su valor, uno enviado como null se borra, y uno enviado como instante se establece; el validUntil resultante debe ser estrictamente posterior a validFrom
API PATCH /api/v3/admin/tenants/{tenantId}/actors/{actorId}/suspend con un cuerpo que lleva el reason (operación suspendActor)
API PATCH /api/v3/admin/tenants/{tenantId}/actors/{actorId}/reactivate (operación reactivateActor)
API DELETE /api/v3/admin/tenants/{tenantId}/actors/{actorId}/roles/{roleName} (operación unassignActorRole)
API POST /api/v3/admin/tenants/{tenantId}/actors/{actorId}/revoke con un cuerpo que lleva el reason (operación revokeActor)

Relacionado