> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/es/gestion-de-usuarios-y-proyectos/user-management.md).

# Gestión de usuarios

## Creación de un usuario administrador

Implementaciones de Overleaf Toolkit:

{% code title="Overleaf Toolkit" overflow="wrap" %}

```bash
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user --admin --email=joe@example.com"
```

{% endcode %}

Implementaciones heredadas de docker-compose.yml:

{% code title="docker-compose heredado" overflow="wrap" %}

```bash
$ docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/create-user --admin --email=joe@example.com"
```

{% endcode %}

El comando creará un usuario con la dirección de correo electrónico proporcionada si aún no existe, y lo convertirá en administrador. La salida del comando incluye una URL para visitar, donde puedes establecer la contraseña de este usuario e iniciar sesión por primera vez.

{% hint style="info" %}
Para un enfoque programático, también puedes usar el mismo script para crear usuarios normales y administradores. Para los usuarios normales, omite el indicador --admin.
{% endhint %}

Si usas cuentas internas para la autenticación y necesitas elevar a un usuario existente a administrador de la instancia o revocar permisos de administrador, haz lo siguiente:

{% stepper %}
{% step %}

### A través de la interfaz de administración

* Inicia sesión como un administrador existente.
* Haz clic en Admin -> Manage Users.
* Busca al usuario y haz clic en su dirección de correo electrónico.
* Desplázate hacia abajo hasta la sección Site Admin y haz clic en el enlace (show).
* Marca la casilla Is Site Admin.
* Haz clic en Save para finalizar.
  {% endstep %}
  {% endstepper %}

***

## Eliminación de usuarios

Como se explica en nuestra guía sobre [comprender el uso de licencias](broken://pages/7d75f71a7b01bd3b8f1d7c0ca0d3ecd437293a99), por lo general es recomendable no eliminar cuentas a menos que ya no sean necesarias. Eliminar una cuenta borra la cuenta y hace que los colaboradores pierdan el acceso a los proyectos. Actualmente no hay forma de desactivar cuentas: o bien existen con sus datos conservados o bien se eliminan.

De forma predeterminada, las cuentas se eliminan temporalmente. Para obtener información sobre cómo eliminar usuarios de forma permanente de tu instancia, consulta la `ENABLE_CRON_RESOURCE_DELETION` en el [variables de entorno](broken://pages/8fb72e269ed6d7f1914fe9caa3472414c7e140c7) guía.

{% hint style="info" %}
Las cuentas se eliminan temporalmente de forma predeterminada. Consulta `ENABLE_CRON_RESOURCE_DELETION` para conocer el comportamiento de la eliminación permanente.
{% endhint %}

### A través de Admin -> Manage Users

{% stepper %}
{% step %}

* Inicia sesión como administrador.
* Haz clic en Admin -> Manage Users.
* Busca al usuario y marca la casilla junto a su dirección de correo electrónico.
* Haz clic en el icono de la papelera.
* Haz clic en Delete para confirmar.
  {% endstep %}
  {% endstepper %}

### A través de la línea de comandos

Las cuentas de usuario (y sus proyectos) se pueden eliminar usando los siguientes comandos.

Implementaciones de Overleaf Toolkit:

{% code title="Overleaf Toolkit" %}

```bash
$ bin/docker-compose exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/delete-user.mjs --email=joe@example.com"
```

{% endcode %}

Implementaciones heredadas de docker-compose.yml:

{% code title="docker-compose heredado" %}

```bash
$ docker exec sharelatex /bin/bash -ce "cd /overleaf/services/web && node modules/server-ce-scripts/scripts/delete-user.mjs --email=joe@example.com"
```

{% endcode %}

{% hint style="danger" %}
El script de eliminación usa una opción force codificada que garantiza que la eliminación continúe incluso si falla el envío del correo electrónico de eliminación de la cuenta (por ejemplo, cuando el correo electrónico del usuario ya no está en servicio).
{% endhint %}

{% hint style="info" %}
Desde la versión 5.5.0, se puede usar la opción --skip-email para evitar enviar un correo electrónico informativo al usuario eliminado.
{% endhint %}

***

## Restaurar un usuario eliminado temporalmente

Si un usuario solo ha sido eliminado temporalmente, puedes restaurar su cuenta y sus proyectos.

{% stepper %}
{% step %}

* Inicia sesión como administrador.
* Haz clic en Admin -> Manage Users.
* Busca al usuario que quieres restaurar.
* Haz clic en el botón Mostrar usuarios eliminados.
* Haz clic en la dirección de correo electrónico del usuario eliminado.
* Haz clic en Recover This Account.
* Haz clic en Recover para confirmar.
  {% endstep %}
  {% endstepper %}

{% hint style="danger" %}
Cuando ENABLE\_CRON\_RESOURCE\_DELETION está establecido en true, las cuentas eliminadas temporalmente pueden restaurarse dentro de una ventana de 90 días. Después de 90 días, no es posible recuperar la cuenta.
{% endhint %}

***

## Conteo de usuarios

Puedes obtener el recuento de usuarios a través de la interfaz de administración en <https://you-instance-url/admin/user#license>. Para comprobaciones y exportaciones programáticas, los siguientes ejemplos pueden ser útiles.

Número total de usuarios:

{% code title="Número total de usuarios" %}

```bash
echo 'db.users.countDocuments()' | docker exec -i mongo mongosh --quiet localhost/sharelatex
# overleaf [direct: primary] sharelatex> 16
```

{% endcode %}

Número total de usuarios usando el endpoint de métricas:

{% code title="Número de usuarios activos desde métricas" %}

```bash
docker exec sharelatex curl http://127.0.0.1:3000/metrics | grep num_active_users
# # HELP num_active_users num_active_users
# # TYPE num_active_users gauge
# num_active_users{app="web-api",host="b3ae4ff549d8"} 16
```

{% endcode %}

Número total de usuarios activos (ejemplo: usuarios activos en los últimos 365 días):

{% code title="Número total de usuarios activos" %}

```bash
echo 'db.users.countDocuments({ lastActive: { $gte: new Date(new Date().getTime() - (365 * 24 * 60 * 60 * 1000)) } })' | docker exec -i mongo mongosh --quiet localhost/sharelatex
# overleaf [direct: primary] sharelatex> 10
```

{% endcode %}

***

## Actualización de la información de la cuenta de usuario

La forma en que se realizan las actualizaciones de la cuenta depende de si SSO está habilitado.

* Si no se usa SSO:
  * Los administradores pueden modificar la información de la cuenta de usuario a través de Admin -> Manage Users (correo electrónico, nombre, apellido y generar un enlace para restablecer la contraseña).
  * Los usuarios normales pueden actualizar sus propios datos a través de Account -> Account Settings (incluido cambiar la contraseña y generar tokens de autenticación Git).
* Si se usa SSO:
  * Server Pro se puede configurar para actualizar el nombre y apellido de un usuario durante el inicio de sesión según el sistema de autenticación.
  * Cuando OVERLEAF\_SAML\_UPDATE\_USER\_DETAILS\_ON\_LOGIN o OVERLEAF\_LDAP\_UPDATE\_USER\_DETAILS\_ON\_LOGIN están en true, el formulario de datos del usuario en <https://your-instance-url/user/settings> está deshabilitado y el nombre/apellido solo se puede establecer en tu sistema de gestión de identidades.

Para más detalles, consulta:

* Configuración de SAML 2.0: <https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/saml-2.0>
* Configuración de LDAP: <https://docs.overleaf.com/on-premises/configuration/overleaf-toolkit/server-pro-only-configuration/ldap>

***

Última actualización hace 4 meses

Esta página de documentación contiene enlaces a guías y páginas de configuración externas. Todos los enlaces y parámetros de consulta se conservan tal como en el contenido original.


---

# 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://overleaf-pro.ayaka.space/on-premises/es/gestion-de-usuarios-y-proyectos/user-management.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.