> For the complete documentation index, see [llms.txt](https://ayakaleaf-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://ayakaleaf-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 ed effettuare l'accesso 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 -> Gestisci utenti. * Cerca l'utente e fai clic sul suo indirizzo email. * Scorri fino alla sezione Site Admin e fai clic sul link (mostra). * Seleziona la casella È Site Admin. * Fai clic su Salva per terminare. {% endstep %} {% endstepper %} *** ## Eliminazione degli utenti Come spiegato nella nostra guida su [la comprensione dell'uso delle licenze](broken://pages/2f7695999e72fc23db27a2b9ee10bec28300b748), in generale è consigliabile non eliminare gli account a meno che non siano più necessari. L'eliminazione di un account rimuove l'account e fa sì che i collaboratori perdano l'accesso ai progetti. Al momento non esiste alcun modo per disattivare gli account: o esistono con i dati conservati oppure vengono eliminati. Per impostazione predefinita, gli account vengono eliminati in modo soft. Per informazioni su come rimuovere in modo permanente gli utenti dalla tua istanza vedi `ENABLE_CRON_RESOURCE_DELETION` nel [Variabili d'ambiente](broken://pages/099abc4cdcf99f423da228365f3af28ff3e50ddb) guida. {% hint style="info" %} Gli account vengono eliminati in modo soft per impostazione predefinita. Vedi `ENABLE_CRON_RESOURCE_DELETION` per il comportamento di eliminazione permanente. {% endhint %} ### Tramite Admin -> Gestisci utenti {% stepper %} {% step %} * Accedi come amministratore. * Fai clic su Admin -> Gestisci utenti. * Cerca l'utente e seleziona la casella accanto al suo indirizzo email. * Fai clic sull'icona del cestino. * Fai clic su Elimina per confermare. {% endstep %} {% endstepper %} ### Tramite la riga di comando Gli account utente (e i loro progetti) possono essere eliminati utilizzando 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 utilizza un'opzione force codificata che garantisce che l'eliminazione proceda anche se non riesce a inviare l'email di eliminazione dell'account (ad esempio, quando l'email dell'utente non è più attiva). {% endhint %} {% hint style="info" %} A partire dalla versione 5.5.0, è possibile usare l'opzione --skip-email per impedire l'invio di un'email informativa all'utente eliminato. {% endhint %} *** ## Ripristino di un utente eliminato in modo soft Se un utente è stato eliminato solo in modo soft, puoi ripristinare il suo account e i suoi progetti. {% stepper %} {% step %} * Accedi come amministratore. * Fai clic su Admin -> Gestisci utenti. * Cerca l'utente che desideri ripristinare. * Fai clic sul pulsante Mostra utenti eliminati. * Fai clic sull'indirizzo email dell'utente eliminato. * Fai clic su Recupera questo account. * Fai clic su Recupera per confermare. {% endstep %} {% endstepper %} {% hint style="danger" %} Quando ENABLE\_CRON\_RESOURCE\_DELETION è impostato su true, gli account eliminati in modo soft possono essere ripristinati entro una finestra di 90 giorni. Dopo 90 giorni, il recupero dell'account non è possibile. {% endhint %} *** ## Conteggio degli utenti Puoi ottenere il conteggio degli utenti tramite l'interfaccia admin all'indirizzo . Per verifiche 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 tramite l'endpoint metriche: {% code title="Numero di utenti attivi dalle metriche" %} ```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 effettuati gli aggiornamenti dell'account dipende dal fatto che SSO sia abilitato. * Se SSO non è utilizzato: * Gli amministratori possono modificare le informazioni dell'account utente tramite Admin -> Gestisci utenti (email, nome, cognome e generazione di un link per il reset della password). * Gli utenti normali possono aggiornare i propri dettagli tramite Account -> Impostazioni account (inclusa la modifica della password e la generazione di token di autenticazione Git). * Se SSO è utilizzato: * Server Pro può essere configurato per aggiornare nome e cognome di un utente al momento del login 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 dettagli utente su è disabilitato e nome/cognome possono essere impostati solo nel sistema di gestione delle identità. Per maggiori dettagli vedi: * Configurazione SAML 2.0: * Configurazione 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://ayakaleaf-pro.ayaka.space/on-premises/it/gestione-di-utenti-e-progetti/user-management.md?ask=&goal= ``` `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.