> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/es/administracion-del-sistema/users-groups.md).

# Usuarios y grupos

Cómo crear y administrar usuarios y grupos en VergeOS, incluyendo tipos de usuario, políticas de contraseñas, autenticación de dos factores, claves SSH, acceso físico y pertenencia a grupos.

## Usuarios

Debe crearse una cuenta de usuario separada para cada individuo que utilice el sistema.

{% hint style="success" %}
**Fuente de autorización**

Al usar una fuente de autorización, existe la opción de crear automáticamente usuarios a partir de la fuente.
{% endhint %}

### Tipos de usuario

* **Normal** - destinado al acceso completo a la interfaz de usuario
* **API** - destinado solo a cuentas de servicio; p. ej., ejecución de scripts, sincronizaciones, etc.
* **VDI** - solo panel de usuario VDI

## Grupos

Un grupo es una colección de usuarios. Los grupos también pueden contener otros grupos. La administración de permisos y suscripciones a menudo puede simplificarse mediante el uso de grupos.

## Crear un nuevo usuario

1. Navegue a **Sistema** > **Usuarios**.
2. Seleccione **Nuevo**.
3. Seleccione una ***Fuente de autorización*** si corresponde (este campo no se mostrará si no hay fuentes de autorización de terceros configuradas para el sistema). La selección predeterminada de "--Ninguno--" crea un usuario que se autentica directamente a través de VergeOS.

{% hint style="info" %}
Si la fuente de autorización se ha configurado para crear usuarios automáticamente, no cree el usuario aquí.
{% endhint %}

4. Introduzca un ***Nombre de usuario***; este será el nombre de inicio de sesión del usuario. El nombre de usuario debe ser único dentro de esta nube (Nota: cada inquilino es una nube VergeOS independiente).
5. Seleccione el usuario adecuado ***Tipo***:
   * **Normal** - usuarios que iniciarán sesión en la interfaz de usuario completa
   * **API** - utilizado para cuentas de servicio, como las que se usan para sincronizaciones de sitios
   * **VDI** - usuario que iniciará sesión solo en un panel VDI
6. Introduzca un ***Contraseña*** para el usuario. Las contraseñas deben cumplir con la configuración de complejidad de contraseña definida para esta nube VergeOS; los requisitos se enumeran debajo del campo. La configuración de complejidad se define en Sistema -> Configuración -> Requisito de complejidad de contraseña.
7. Vuelva a introducir la contraseña en el ***Confirmar contraseña*** campo.
8. Opcionalmente, ***Requerir cambio de contraseña*** se puede habilitar para pedir al usuario que cree su propia contraseña al iniciar sesión por primera vez.
9. Opcionalmente, se ***Nombre para mostrar*** puede especificar para el usuario. El nombre para mostrar se muestra en la esquina superior derecha de la pantalla cuando el usuario ha iniciado sesión en la interfaz de usuario.
10. Cuando está habilitado, ***Autenticación de dos factores*** requiere el uso de un código de seguridad (recibido por correo electrónico del usuario) además del nombre de usuario y la contraseña para iniciar sesión en el sistema VergeOS.
11. ***Dirección de correo electrónico*** se utiliza al enviar informes de suscripción y alertas asignadas al usuario y para la autenticación de dos factores, si corresponde.
12. La ***Acceso físico*** opción puede marcarse para permitir al usuario acceso directo a la consola de los nodos.

{% hint style="warning" %}
**PRECAUCIÓN:** Habilitar la *Acceso físico* opción permite que la cuenta inicie sesión en la línea de comandos mediante acceso físico (p. ej., crashcart, control remoto IPMI) y SSH. **Esto solo debe concederse a usuarios en quienes se confíe para la administración de bajo nivel del servidor VergeOS.**
{% endhint %}

* **Claves SSH** se pueden añadir para proporcionar autenticación basada en claves para SSH; se pueden definir varias claves para permitir que el usuario se autentique mediante clave SSH desde varios equipos. Nota: las claves SSH son opcionales; un usuario con acceso físico puede iniciar sesión en una sesión SSH con nombre de usuario/contraseña en ausencia de una clave SSH asociada.

  **Añadir una nueva entrada de clave SSH:**

  * Aparecerá una primera línea en blanco donde se puede escribir una clave SSH.
  * Se pueden añadir claves adicionales, según sea necesario, haciendo clic en el botón de más \[ ] , que insertará una nueva línea en blanco donde se puede escribir una clave SSH.

    **Para seleccionar y deseleccionar clave(s) para mover/editar/eliminar:**
  * Las entradas seleccionadas mostrarán una marca en la casilla de la izquierda.
  * La selección es un conmutador: haga clic en una entrada no seleccionada para seleccionarla; haga clic en una entrada seleccionada para deseleccionarla.
  * Se pueden seleccionar varias claves para eliminarlas o moverlas.

    **Para editar una entrada de clave existente:**
  * Haga clic para seleccionar la clave deseada para editarla.
  * Haga clic en el botón de editar \[ ].
  * La clave seleccionada aparece y puede modificarse. Cuando termine de editar, haga clic de nuevo en el botón de editar \[ ] para guardar los cambios.

    **Para eliminar una entrada de clave existente:**
  * Haga clic para seleccionar la clave deseada para eliminarla.
  * Haga clic en el botón de eliminar \[ ].

13. Haga clic en **Enviar** para guardar el nuevo usuario.

### Membresía de grupo

La membresía de grupo se asigna después de crear el usuario. Para agregar el nuevo usuario a uno o más grupos:

1. Seleccione **Modificar membresía** en el menú izquierdo.
2. Haga clic para seleccionar cada grupo deseado.
3. Haga clic en **Enviar** después de realizar todas las selecciones de grupo.

{% hint style="success" %}
Los usuarios también pueden añadirse a grupos individuales usando las **Agregar miembros** instrucciones a continuación.
{% endhint %}

## Crear un nuevo grupo

1. Desde el **Panel del sistema**, seleccione **Grupos** en la barra lateral izquierda.
2. Seleccione **Nuevo** en el menú izquierdo.
3. Introduzca un ***Nombre*** para el grupo (obligatorio).
4. Opcionalmente, se ***Descripción*** puede especificarse para el grupo.
5. Opcionalmente, una ***Dirección de correo electrónico*** puede especificarse para recibir alertas y reportes de suscripción asignados al grupo.
6. Haga clic en **Enviar** para guardar el nuevo grupo.

## Agregar miembros (usuarios y/o grupos) a un grupo

1. Desde el **Panel del sistema**, seleccione **Grupos** en la barra lateral izquierda.
2. **Haga doble clic en el grupo deseado** en la lista para mostrar el panel del grupo.
3. Haga clic en **Miembros**.
4. Haga clic en **Agregar usuarios** o **Agregar grupos** en el menú izquierdo.
5. Seleccione usuarios/grupos de la lista mostrada. Sugerencia: se pueden seleccionar varios grupos manteniendo presionada la tecla Mayús o Ctrl.
6. Haga clic en **Agregar al grupo** para aplicar los cambios.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/run-the-platform/es/administracion-del-sistema/users-groups.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
