Autenticazione

Come funzionano l’autenticazione e le sessioni utente in Apollo.

​

Panoramica dell’Autenticazione

Apollo utilizza Supabase Auth con autenticazione basata su JWT. Tutte le richieste API richiedono un token JWT valido nell’header Authorization.

​

Metodi di Accesso

E-mail e Password

Il metodo di accesso standard. Gli utenti si registrano con e-mail e password, quindi confermano l’e-mail tramite un link di verifica.

1. Vai alla pagina di login su apol.dev
2. Inserisci e-mail e password
3. Clicca su Sign In

Invito

Gli amministratori dell’organizzazione possono invitare utenti via e-mail. Gli utenti invitati ricevono un link per impostare la password e unirsi all’organizzazione.

1. L’amministratore invia l’invito da Impostazioni Organizzazione > Membri
2. L’utente clicca sul link di invito nell’e-mail
3. L’utente imposta la password e viene automaticamente aggiunto all’organizzazione

Recupero Password

1. Clicca su Password dimenticata nella pagina di login
2. Inserisci il tuo indirizzo e-mail
3. Clicca sul link di reimpostazione nella tua e-mail
4. Imposta una nuova password

​

Gestione delle Sessioni

• Le sessioni sono gestite da Supabase con aggiornamento automatico dei token
• La cronologia di navigazione viene salvata nel localStorage per riprendere da dove avevi lasciato
• Le sessioni persistono tra gli aggiornamenti del browser

​

Tipi di Utente

Apollo supporta tre tipi di utente, determinati dall’appartenenza all’organizzazione:

Tipo di Utente	Descrizione	Accesso
Interno	Membri completi del team (ruoli org: owner, admin, member)	Tutte le funzionalità in base al ruolo
Cliente	Clienti esterni con vista limitata	Dashboard semplificata, solo progetti assegnati
Collaboratore Esterno	Contributori di terze parti	Accesso solo a progetti specifici

I tipi di utente sono derivati dal ruolo in organization_members, non impostati direttamente. Il ruolo organizzativo external_collaborator corrisponde al tipo Collaboratore Esterno.

​

Modello dei Permessi

Apollo utilizza un modello di permessi a tre livelli. Consulta Permessi per la descrizione completa.