Saltar al contenido
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Administrar usuarios, grupos y acceso

devo admin le permite ocuparse de las personas y los permisos de su espacio de trabajo desde un terminal o un script: enumerar usuarios, actualizar una cuenta, organizar grupos y decidir quién puede abrir una bóveda. La mayoría de estas tareas dependen del tipo de espacio de trabajo, así que cada tabla de esta página tiene una columna ESPACIO DE TRABAJO. En Devolutions Cloud y Devolutions Server, un comando que el espacio de trabajo no ofrece se detiene con operationNotSupportedBySource e indica el tipo que necesita. Un perfil local lo rechaza con su propio código de error y un mensaje que explica por qué.

Antes de empezar

  • Inicie sesión con una cuenta que tenga derechos de administrador en el espacio de trabajo. Consulte Iniciar sesión en Devolutions Cloud o Iniciar sesión en Devolutions Server.

  • Compruebe qué espacio de trabajo está seleccionado con devo status. Añada --context <context-name> a un comando para ejecutarlo en otro.

  • Los comandos que cambian algo necesitan --yes. Sin él, no cambian nada y se detienen con confirmationRequired.

  • Los usuarios y los grupos se seleccionan por nombre de forma predeterminada. Escriba id:<value> o añada --id para seleccionar por identificador, y email:<value> o --email para seleccionar un usuario por correo. En devo admin group members add y remove, las opciones correspondientes son --group-id, --user-id y --user-email.

Usuarios

TAREA
COMANDO
ESPACIO DE TRABAJO

Enumerar usuarios, ver un usuario

devo admin user list devo admin user get "<user>"

Devolutions Cloud, Devolutions Server, perfil local (solo lectura, cuando el perfil lo permite)

Ver los grupos de un usuario

devo admin user groups list "<user>"

Devolutions Cloud, perfil local (solo lectura, cuando el perfil lo permite)

Crear un usuario

devo admin user create "<login>" --email <email> --password-env <VARIABLE_NAME> --yes

Devolutions Server

Actualizar un usuario

devo admin user update "<user>" --enabled false --yes

Devolutions Cloud, Devolutions Server

Eliminar un usuario

devo admin user delete "<user>" --yes

Devolutions Cloud, Devolutions Server

Algunas opciones de devo admin user update pertenecen solo a un tipo de espacio de trabajo:

  • Solo Devolutions Cloud: --description, --locale, --workspace-access, --web-login y --user-vaults.

  • Solo Devolutions Server: --first-name, --last-name, --user-type, --password-env, --password-file y --force-password-change. En Devolutions Server, cambie el nombre de un usuario con --first-name y --last-name: --name y --display-name no se aceptan.

No puede combinar opciones de ambos tipos en un solo comando.

En Devolutions Cloud, los usuarios sincronizados desde el directorio de su organización los administra ese directorio. Devolutions CLI se niega a actualizarlos o eliminarlos.

La contraseña de un usuario nuevo se lee desde una variable de entorno (--password-env) o un archivo (--password-file), nunca desde la línea de comandos, para que no acabe en el historial de su shell.

Grupos

TAREA
COMANDO
ESPACIO DE TRABAJO

Enumerar grupos, ver un grupo y sus miembros

devo admin group list devo admin group get "<group>" devo admin group members list "<group>"

Devolutions Cloud, perfil local (solo lectura, cuando el perfil lo permite)

Crear, cambiar el nombre o eliminar un grupo

devo admin group create "<group>" --yes devo admin group update "<group>" --name "<new-name>" --yes devo admin group delete "<group>" --yes

Devolutions Cloud

Añadir o quitar un miembro

devo admin group members add "<group>" "<user>" --yes devo admin group members remove "<group>" "<user>" --yes

Devolutions Cloud

Eliminar un grupo también quita sus asignaciones. Los grupos sincronizados desde el directorio de su organización no se pueden eliminar.

Roles y acceso a la bóveda

TAREA
COMANDO
ESPACIO DE TRABAJO

Enumerar los roles

devo admin role list --scope vault (or --scope entry) devo admin role get <role-id>

Devolutions Cloud

Ver quién puede abrir una bóveda

devo vault access list "<vault>"

Devolutions Cloud

Dar a un usuario o a un grupo acceso a una bóveda

devo vault access grant "<vault>" --user "<user>" --role Readers --yes

Devolutions Cloud

Quitar el acceso de un usuario o de un grupo

devo vault access revoke "<vault>" --group "<group>" --yes

Devolutions Cloud

Ver, dar o quitar un rol en una entrada

devo entry access list --vault-id <vault-id> --entry-id <entry-id> devo entry access get --vault-id <vault-id> --entry-id <entry-id> --user-id <user-id> devo entry access grant --vault-id <vault-id> --entry-id <entry-id> --user-id <user-id> --role-id <role-id> --yes devo entry access revoke --vault-id <vault-id> --entry-id <entry-id> --group-id <group-id> --yes

Devolutions Cloud

Ver los permisos directos de una entrada

devo entry permission get "<entry>"

Devolutions Cloud, perfil local (cuando el perfil lo permite)

Enumerar los conjuntos de permisos

devo admin access permission-sets

Devolutions Server

--role acepta un nombre o un identificador de rol: Restricted, Readers, PrivilegedReaders, Operators, PrivilegedOperators, Contributors o VaultOwners. Cada concesión o revocación actúa sobre un solo usuario (--user) o un solo grupo (--group).

En un perfil local, devo admin role list y devo admin access permission-sets no están disponibles: las listas de roles son para Devolutions Cloud, y los conjuntos de permisos para Devolutions Server.

Solo Devolutions Cloud

TAREA
COMANDO
ESPACIO DE TRABAJO

Revisar y limpiar las invitaciones

devo admin invitation list devo admin invitation get --invitation-id <invitation-id> devo admin invitation remove-email --id <invitation-id> --email <email> --yes devo admin invitation delete --id <invitation-id> --yes

Devolutions Cloud

Administrar los permisos del sistema

devo admin access system list devo admin access system get --user-id <user-id> devo admin access system grant --user-id <user-id> --permission <permission> --yes devo admin access system revoke --group-id <group-id> --permission <permission> --yes

Devolutions Cloud

Administrar los roles de la bóveda del sistema

devo admin access system-vault list devo admin access system-vault get --user-id <user-id> devo admin access system-vault grant --user-id <user-id> --role-id <role-id> --yes devo admin access system-vault revoke --group-id <group-id> --yes

Devolutions Cloud

Revisar o quitar instancias de Devolutions Gateway

devo admin gateway list devo admin gateway get --gateway-id <gateway-id> devo admin gateway settings get devo admin gateway delete --gateway-id <gateway-id> --yes Los resultados nunca incluyen los secretos de las pasarelas.

Devolutions Cloud

Ver o cambiar el propietario de la organización

devo admin owner get devo admin owner set --user-id <user-id> --yes

Devolutions Cloud

Revisar o cambiar la configuración del sistema

devo admin settings get devo admin settings update --force-two-factor-authentication --yes

Devolutions Cloud

Solo Devolutions Server

TAREA
COMANDO
ESPACIO DE TRABAJO

Restaurar o purgar los usuarios eliminados

devo admin user trash list devo admin user trash restore id:<user-id> --yes devo admin user trash purge id:<user-id> --yes

Devolutions Server

Preconfigurar el método de dos factores de un usuario

devo admin user 2fa set --user-security-id <id> --type google-authenticator --yes devo admin user 2fa clear --user-security-id <id> --yes

Devolutions Server

Inspeccionar los dominios de Active Directory

devo admin domain list devo admin domain users --domain <domain-name>

Devolutions Server

Revisar o cambiar la configuración de autenticación

devo admin settings auth-modes get devo admin settings auth-modes set --domain true --azure-ad false --yes devo admin settings two-factor get auth-modes set activa o desactiva la autenticación de dominio, Azure AD y la autenticación personalizada (--custom) con true o false. Las opciones que omita conservan su valor. Devolutions CLI rechaza un cambio que no dejaría ningún modo de autenticación principal activado.

Devolutions Server

Revisar y registrar licencias

devo admin license list devo admin license users list --serial-env <VARIABLE_NAME> devo admin license register --serial-env <VARIABLE_NAME> --yes devo admin license trial start --yes El número de serie o el JWT de la licencia procede de una variable de entorno (--serial-env) o de un archivo (--serial-file), nunca de la línea de comandos. license list muestra los números de serie en parte ocultos. Añada --replace para sustituir las licencias existentes, y --auto-assign true para asignar automáticamente las licencias compatibles a los usuarios nuevos.

Devolutions Server

Revisar el acceso privilegiado

devo admin pam account list devo admin pam provider list devo admin pam provider get --provider-id <provider-id> pam account list devuelve 100 cuentas por página de forma predeterminada (--page, --page-size hasta 500), opcionalmente para una carpeta (--vault-id). Los resultados no incluyen contraseñas.

Devolutions Server

Publicar las listas de revocación de Devolutions Gateway

devo admin gateway revocation-list publish --yes Añada --gateway-id <gateway-id> para publicar la lista de una sola pasarela.

Devolutions Server

Devolutions Server selecciona los usuarios eliminados solo por identificador, y devo admin user trash list no toma allí ningún filtro de nombre. devo admin domain list no muestra los secretos de enlace del dominio.

Bueno saberlo

Siguiente

Última actualización

¿Te fue útil?