Scopri come Esadax consente un'autenticazione sicura e senza problemi utilizzando provider di terze parti come GitHub, GitLab, Bitbucket e il protocollo OAuth 2.0.

Indice dei contenuti

1. Panoramica delle connessioni di accesso
2. Autenticazione di GitHub
3. Autenticazione di GitLab
4. Autenticazione di Bitbucket
5. Comprendere OAuth 2.0
6. Best practice per la sicurezza
7. Risoluzione dei problemi
8. Glossario

---

Panoramica delle connessioni di accesso

Esadax supporta opzioni di accesso adatte agli sviluppatori utilizzando servizi di controllo delle versioni popolari e protocolli standard del settore:

• GitHub
• GitLab
• Bitbucket
• Supporto per OAuth 2.0

Queste connessioni consentono di:

• Autenticazione rapida senza creare nuove password.
• Gestisci l'accesso tramite la tua piattaforma di hosting del codice preferita.
• Semplifica l'onboarding del team e la gestione delle autorizzazioni.

---

Autenticazione di GitHub

• Perché GitHub?

  • GitHub è ampiamente utilizzato nella comunità degli sviluppatori e fornisce un supporto OAuth 2.0 affidabile.

• Passaggi per accedere tramite GitHub:

  1. Fai clic sul pulsante “Accedi con GitHub” nella pagina di accesso di Esadax.
  2. Verrai reindirizzato alla schermata di consenso OAuth di GitHub.
  3. Concedi a Esadax l'accesso al tuo profilo GitHub.
  4. Sarai collegato in modo sicuro a Esadax.

• Ambiti utilizzati:

  • read:user
  • user:email

• Note:

  • Non è richiesto alcun accesso in scrittura o accesso al repository.
  • La tua password non viene mai condivisa con Esadax.

---

Autenticazione di GitLab

• Passaggi per accedere tramite GitLab:

  1. Scegli “Accedi con GitLab” dalle opzioni di accesso di Esadax.
  2. Verrai portato al prompt di autenticazione di GitLab.
  3. Approvare gli ambiti richiesti.
  4. Tornerai a Esadax con la tua sessione autenticata.

• Istanze GitLab supportate:

  • GitLab.com (pubblico)
  • Istanze GitLab self-hosted (in arrivo)

• Ambiti utilizzati:

  • read_user

---

Autenticazione di Bitbucket

• Passaggi per accedere tramite Bitbucket:

  1. Fai clic sull’opzione “Accedi con Bitbucket”.
  2. Autorizza la connessione tramite il flusso OAuth di Bitbucket.
  3. Torna a Esadax come utente verificato.

• Ambiti utilizzati:

  • account
  • email

• Note:

  • Ideale per i team che utilizzano Bitbucket Cloud.
  • Il supporto per Bitbucket Server non è attualmente disponibile.

---

Comprendere OAuth 2.0

OAuth 2.0 è il protocollo sicuro standard del settore che Esadax utilizza per integrarsi con i servizi esterni.

• Come funziona:

  1. L'utente viene reindirizzato a un provider (ad esempio GitHub) per approvare l'accesso.
  2. Il fornitore rilascia un codice di autorizzazione.
  3. Esadax scambia questo codice con un token di accesso di breve durata.
  4. Il token viene utilizzato per recuperare le informazioni di base dell'utente.

• Vantaggi:

  • Non c'è bisogno di gestire le password.
  • Identità decentralizzata: gli utenti controllano l'accesso.
  • I token scaduti riducono il rischio di sicurezza.

---

Best practice per la sicurezza

• Memorizzazione dei token:

  • I token sono archiviati in modo sicuro e crittografati a riposo.

• Gestione della sessione:

  • Le sessioni sono di breve durata con scadenza automatica.
  • Supporto 2FA opzionale per una maggiore sicurezza.

• Permessi minimi:

  • Vengono richiesti solo gli ambiti essenziali.
  • Nessun accesso in scrittura o al repository a meno che non sia esplicitamente necessario.

---

Risoluzione dei problemi

• Il login non funziona?:

  • Assicurati che il tuo account di terze parti sia attivo.
  • Verifica il tuo indirizzo email con il provider.
  • Prova a cancellare i cookie o utilizzare una finestra di navigazione in incognito.

• Account già collegato?

  • Se in precedenza hai effettuato l'accesso utilizzando un metodo diverso (ad esempio, e-mail), vai su Impostazioni account → Connessioni per collegare gli account.

• Errore di accesso negato?

  • Ciò si verifica in genere se gli ambiti richiesti non vengono concessi. Riprova ad accedere e assicurati che tutti i prompt siano accettati.

---

Glossario

• OAuth 2.0: protocollo per delegare l'autorizzazione tra le applicazioni senza condividere le password.
• Scopes: autorizzazioni richieste durante il login OAuth per accedere a dati specifici.
• Token di accesso: una credenziale temporanea utilizzata per accedere ai dati dell’utente dal provider.
• Provider: il servizio esterno utilizzato per l'autenticazione (ad esempio GitHub, GitLab).
• Schermata di consenso: l'interfaccia utente mostrata dal provider in cui gli utenti approvano l'accesso richiesto.

---