Skip to content

Crear un actor de máquina y darle roles

Crea un actor criptográfico dentro de una aplicación, la identidad que usa un servicio, un trabajo por lotes o un tercero para llamar a la plataforma, y dale los roles que deciden qué tipos de operación puede solicitar.

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 Nuevo actor a quien tiene el permiso para crear actores. Los pasos de primera credencial y de roles del asistente solo aparecen para quien además tiene el permiso para emitir credenciales o para asignar roles.

Antes de empezar

  • El tenant no es SIMPLE. Un tenant SIMPLE no usa esta pantalla: sus casos de uso internos componen el actor, su credencial y sus concesiones.
  • La aplicación a la que pertenece el actor existe. Crear una aplicación ya crea su actor criptográfico predeterminado, así que crea otro actor solo cuando necesites una identidad separada, por ejemplo una por cada procesador externo.

Pasos

  1. Abre Actores criptográficos desde la navegación del tenant.
  2. Selecciona Nuevo actor.
  3. En Identidad:
    1. Elige la Aplicación.
    2. Escribe un Nombre visible. El Nombre del actor se genera a partir de él mientras Generar a partir del nombre visible está activado; desactívalo para escribir tú el nombre. Solo se aceptan letras minúsculas, dígitos y guiones, empezando y terminando con una letra o un dígito.
    3. Elige el Tipo de actor: Interno, Tercero o Socio.
    4. De forma opcional, escribe una Descripción, un Propósito y una ventana de validez, Válido desde (UTC) y Válido hasta (UTC).
  4. Selecciona Siguiente. El actor se crea en este momento.
  5. En Primera credencial, elige el Tipo de credencial y selecciona Emitir credencial, o selecciona Omitir. Cómo emitir una credencial se describe en Emitir, rotar o revocar la credencial de un actor.
  6. En Roles, marca las operaciones criptográficas que el actor puede solicitar y luego selecciona Finalizar. Selecciona Omitir para dejar el actor sin roles por ahora.

Para cambiar los roles más adelante, abre el actor, ve a Roles, selecciona Gestionar, marca los roles que el actor debe tener y selecciona Guardar.

Qué ves cuando funcionó

El actor aparece en Actores criptográficos. Su detalle lo muestra como activo, con los roles que asignaste en Roles. Hasta que el actor tenga una forma de autenticarse y al menos un rol, su pestaña Información muestra "Este actor todavía no puede operar" y ofrece los pasos que faltan.

Un rol indica qué tipo de operación puede solicitar el actor. Qué claves puede usar lo deciden las concesiones de capacidad.

Si falla

Qué ves Causa Qué hacer
"Letras minúsculas, dígitos y guiones. Debe empezar y terminar con un carácter alfanumérico." El nombre del actor tiene otros caracteres Corrige el nombre
"«Válido hasta» debe ser estrictamente posterior a «Válido desde»." La ventana de validez termina antes de empezar Corrige las fechas
El nombre se rechaza porque ya está en uso Un actor vigente de la misma aplicación tiene ese nombre Elige otro nombre
"No hay aplicaciones en este tenant — crea una primero" El tenant no tiene ninguna aplicación Registra primero una aplicación
Se rechaza guardar los roles y se nombra un rol Ese rol lo otorga una concesión de capacidad activa, y se retira actuando sobre la concesión Desmárcalo y guarda de nuevo
Se rechaza guardar los roles y se nombra un caso de uso Un caso de uso interno es dueño del actor, así que el actor actúa solo para ese caso de uso Cambia el caso de uso

Sin la consola

Superficie Cómo
API POST /api/v3/admin/tenants/{tenantId}/applications/{applicationId}/actors (operación createActor)
API POST /api/v3/admin/tenants/{tenantId}/actors/{actorId}/roles con el conjunto completo de roles (operación assignActorRoles). El conjunto reemplaza los roles asignados a mano: para agregar uno, envía el conjunto actual más el rol nuevo

Relacionado