> 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/it/gestione-di-utenti-e-progetti/user-management.md).

# Gestione utenti

## Creazione di un utente amministratore

Distribuzioni di 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 %}

Distribuzioni legacy di docker-compose.yml:

{% code title="docker-compose legacy" 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 %}

Il comando creerà un utente con l'indirizzo email fornito, se non esiste già, e lo renderà amministratore. L'output del comando include un URL da visitare dove puoi impostare la password per questo utente e accedere per la prima volta.

{% hint style="info" %}
Per un approccio programmatico puoi usare lo stesso script per creare sia utenti normali sia amministratori. Per gli utenti normali ometti il flag --admin.
{% endhint %}

Se utilizzi account interni per l'autenticazione e devi elevare un utente esistente a amministratore dell'istanza o revocare i permessi di amministratore, procedi come segue:

{% stepper %}
{% step %}

### Tramite l'interfaccia Admin

* Accedi come amministratore esistente.
* Fai clic su Admin -> Manage Users.
* Cerca l'utente e fai clic sul suo indirizzo email.
* Scorri fino alla sezione Site Admin e fai clic sul link (show).
* Seleziona la casella Is Site Admin.
* Fai clic su Save per завершare.
  {% endstep %}
  {% endstepper %}

***

## Eliminazione di utenti

Come spiegato nella nostra guida su [comprendere l'uso delle licenze](broken://pages/2f7695999e72fc23db27a2b9ee10bec28300b748), in generale è consigliabile non eliminare gli account a meno che non siano più necessari. Eliminare un account rimuove l'account e fa sì che i collaboratori perdano l'accesso ai progetti. Al momento non esiste un modo per disattivare gli account: o esistono con i dati conservati oppure vengono eliminati.

Per impostazione predefinita, gli account vengono eliminati in modo morbido. Per informazioni sulla rimozione permanente degli utenti dalla tua istanza, vedi la `ENABLE_CRON_RESOURCE_DELETION` nel [variabili d'ambiente](broken://pages/099abc4cdcf99f423da228365f3af28ff3e50ddb) guida.

{% hint style="info" %}
Gli account vengono eliminati in modo morbido per impostazione predefinita. Vedi `ENABLE_CRON_RESOURCE_DELETION` per il comportamento dell'eliminazione permanente.
{% endhint %}

### Tramite Admin -> Manage Users

{% stepper %}
{% step %}

* Accedi come amministratore.
* Fai clic su Admin -> Manage Users.
* Cerca l'utente e seleziona la casella accanto al suo indirizzo email.
* Fai clic sull'icona del cestino.
* Fai clic su Delete per confermare.
  {% endstep %}
  {% endstepper %}

### Tramite la riga di comando

Gli account utente (e i loro progetti) possono essere eliminati usando i seguenti comandi.

Distribuzioni di 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 %}

Distribuzioni legacy di docker-compose.yml:

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

```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" %}
Lo script di eliminazione usa un'opzione force codificata che garantisce che l'eliminazione proceda anche se l'email di eliminazione dell'account non riesce a essere inviata (ad esempio, quando l'email dell'utente non è più attiva).
{% endhint %}

{% hint style="info" %}
A partire dalla versione 5.5.0, l'opzione --skip-email può essere usata per impedire l'invio di un'email informativa all'utente eliminato.
{% endhint %}

***

## Ripristino di un utente eliminato in modo morbido

Se un utente è stato eliminato solo in modo morbido, puoi ripristinare il suo account e i suoi progetti.

{% stepper %}
{% step %}

* Accedi come amministratore.
* Fai clic su Admin -> Manage Users.
* Cerca l'utente che vuoi ripristinare.
* Fai clic sul pulsante Mostra utenti eliminati.
* Fai clic sull'indirizzo email dell'utente eliminato.
* Fai clic su Recover This Account.
* Fai clic su Recover per confermare.
  {% endstep %}
  {% endstepper %}

{% hint style="danger" %}
Quando ENABLE\_CRON\_RESOURCE\_DELETION è impostato su true, gli account eliminati in modo morbido possono essere ripristinati entro un periodo di 90 giorni. Dopo 90 giorni, il ripristino dell'account non è possibile.
{% endhint %}

***

## Conteggio degli utenti

Puoi ottenere il conteggio degli utenti tramite l'interfaccia admin all'indirizzo <https://you-instance-url/admin/user#license>. Per controlli ed esportazioni programmatiche, i seguenti esempi possono essere utili.

Numero totale di utenti:

{% code title="Numero totale di utenti" %}

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

{% endcode %}

Numero totale di utenti usando l'endpoint metrics:

{% code title="Num active users da metrics" %}

```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 %}

Numero totale di utenti attivi (esempio: utenti attivi negli ultimi 365 giorni):

{% code title="Numero totale di utenti attivi" %}

```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 %}

***

## Aggiornamento delle informazioni dell'account utente

Il modo in cui vengono eseguiti gli aggiornamenti dell'account dipende dal fatto che SSO sia abilitato.

* Se SSO non è usato:
  * Gli amministratori possono modificare le informazioni dell'account utente tramite Admin -> Manage Users (email, nome, cognome e generazione di un link per il reset della password).
  * Gli utenti normali possono aggiornare i propri dati tramite Account -> Account Settings (inclusa la modifica della password e la generazione di token di autenticazione Git).
* Se SSO è usato:
  * Server Pro può essere configurato per aggiornare nome e cognome di un utente durante l'accesso in base al sistema di autenticazione.
  * Quando OVERLEAF\_SAML\_UPDATE\_USER\_DETAILS\_ON\_LOGIN o OVERLEAF\_LDAP\_UPDATE\_USER\_DETAILS\_ON\_LOGIN sono true, il modulo dei dati utente su <https://your-instance-url/user/settings> è disabilitato e nome/cognome possono essere impostati solo nel tuo sistema di gestione delle identità.

Per ulteriori dettagli vedi:

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

***

Ultimo aggiornamento 4 mesi fa

Questa pagina della documentazione contiene collegamenti a guide esterne e pagine di configurazione. Tutti i collegamenti e i parametri di query sono mantenuti come nel contenuto originale.


---

# 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/it/gestione-di-utenti-e-progetti/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.