Vai al contenuto principale

Creare un utente amministratore

Installazioni con l’Overleaf Toolkit:
Overleaf Toolkit
Installazioni legacy con docker-compose.yml:
Legacy docker-compose
Il comando crea un utente con l’indirizzo email fornito, se non esiste già, e lo rende amministratore. L’output del comando include un URL da visitare per impostare la password di questo utente ed effettuare il primo accesso.
Per un approccio programmatico puoi usare lo stesso script per creare sia utenti normali sia amministratori. Per gli utenti normali, ometti il flag —admin.
Se utilizzi account interni per l’autenticazione e devi promuovere un utente esistente ad amministratore dell’istanza o revocargli i permessi di amministratore, procedi come segue:
1

Tramite l'interfaccia di amministrazione

  • Accedi come amministratore esistente.
  • Fai clic su Admin -> Manage Users.
  • Cerca l’utente e fai clic sul suo nome.
  • Fai clic sull’icona della matita.
  • Attiva o disattiva Admin.
  • Fai clic su Save per terminare.

Eliminare utenti

In genere è consigliabile non eliminare gli account a meno che non servano più. Eliminare un account rimuove l’account e fa perdere ai collaboratori l’accesso ai progetti. Per impedire a un utente di accedere mantenendo i suoi dati, disattiva l’account. Per impostazione predefinita, gli account vengono eliminati in modo soft (soft-delete). Per informazioni sulla rimozione permanente degli utenti dalla tua istanza, consulta ENABLE_CRON_RESOURCE_DELETION nella guida Variabili d’ambiente.
Per impostazione predefinita, gli account vengono eliminati in modo soft. Consulta ENABLE_CRON_RESOURCE_DELETION per il comportamento dell’eliminazione permanente.

Tramite Admin -> Manage Users

1
  • Accedi come amministratore.
  • Fai clic su Admin -> Manage Users.
  • Cerca l’utente e seleziona la casella accanto al suo nome.
  • Fai clic sull’icona del cestino.
  • Fai clic su Delete account per confermare.

Tramite la riga di comando

Gli account utente (e i relativi progetti) possono essere eliminati con i seguenti comandi. Installazioni con l’Overleaf Toolkit:
Overleaf Toolkit
Installazioni legacy con docker-compose.yml:
Legacy docker-compose
Lo script di eliminazione utilizza un’opzione force impostata nel codice, che garantisce che l’eliminazione proceda anche se l’invio dell’email di eliminazione dell’account non riesce (ad es. quando l’email dell’utente non è più attiva).
È possibile usare l’opzione —skip-email per evitare di inviare un’email informativa all’utente eliminato.

Ripristinare un utente eliminato in modo soft

Se un utente è stato eliminato solo in modo reversibile (soft delete), puoi ripristinare il suo account e i progetti eliminati con esso. I progetti che l’utente aveva eliminato personalmente restano eliminati.
1
  • Accedi come amministratore.
  • Fai clic su Admin -> Manage Users.
  • Cerca l’utente che vuoi ripristinare.
  • Fai clic su Display deleted users.
  • Fai clic sull’icona della freccia nella riga dell’utente.
  • Fai clic su Restore per confermare.
Quando ENABLE_CRON_RESOURCE_DELETION è impostato su true, gli account eliminati in modo soft possono essere ripristinati entro 90 giorni. Trascorsi 90 giorni, il recupero dell’account non è possibile.

Contare gli utenti

Puoi ottenere il numero di utenti tramite l’interfaccia di amministrazione all’indirizzo https://you-instance-url/admin/user#license. Per controlli ed esportazioni programmatici, i seguenti esempi possono esserti utili. Numero totale di utenti:
Total number of users
Numero totale di utenti tramite l’endpoint delle metriche:
Num active users from metrics
Numero totale di utenti attivi (esempio: utenti attivi negli ultimi 365 giorni):
Total number of active users

Aggiornare le informazioni dell’account utente

Il modo in cui vengono effettuati gli aggiornamenti degli account dipende dall’abilitazione o meno dell’SSO.
  • Se l’SSO non è utilizzato:
    • Gli amministratori possono modificare le informazioni dell’account utente tramite Admin -> Manage Users (email, nome, cognome e generazione di un link per la reimpostazione della password).
    • Gli utenti normali possono aggiornare i propri dati tramite Account -> Account Settings (inclusi il cambio password e la generazione dei token di autenticazione Git).
  • Se l’SSO è utilizzato:
    • Ayakaleaf 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 maggiori dettagli consulta:

Q&A

Risposta: Non esiste un’API HTTP per questo. Crea l’account con lo script create-user indicato sopra (senza --admin) oppure in Admin → Manage Users con Create account. Quando EXTERNAL_AUTH è impostato, quel modulo ha un’opzione Log in with SSO, che crea l’account senza password locale e senza email o link di attivazione: la finestra di dialogo si chiude dopo Create. Al primo accesso LDAP, SAML o OIDC, l’utente ottiene l’account esistente con lo stesso indirizzo email invece di uno nuovo, vedi Account e password.
Risposta: No. Non esiste un’esportazione o un’importazione degli account utente, né in Admin → Manage Users né tramite script. Gli account sono archiviati in MongoDB, quindi esegui il backup e il ripristino con un backup di MongoDB. Lo script export-user-projects.mjs esporta i progetti degli utenti come file zip, non gli account, vedi Esportare i progetti.

Ultimo aggiornamento 4 mesi fa Questa pagina della documentazione contiene link a guide e pagine di configurazione esterne. Tutti i link e i parametri di query sono conservati come nel contenuto originale.
Ultima modifica il 13 novembre 2026