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
- Panoramica delle connessioni di accesso
- Autenticazione di GitHub
- Autenticazione di GitLab
- Autenticazione di Bitbucket
- Comprendere OAuth 2.0
- Best practice per la sicurezza
- Risoluzione dei problemi
- 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:
- Fai clic sul pulsante “Accedi con GitHub” nella pagina di accesso di Esadax.
- Verrai reindirizzato alla schermata di consenso OAuth di GitHub.
- Concedi a Esadax l'accesso al tuo profilo GitHub.
- Sarai collegato in modo sicuro a Esadax.
- Ambiti utilizzati:
read:useruser: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:
- Scegli “Accedi con GitLab” dalle opzioni di accesso di Esadax.
- Verrai portato al prompt di autenticazione di GitLab.
- Approvare gli ambiti richiesti.
- 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:
- Fai clic sull’opzione “Accedi con Bitbucket”.
- Autorizza la connessione tramite il flusso OAuth di Bitbucket.
- Torna a Esadax come utente verificato.
- Ambiti utilizzati:
accountemail
- 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:
- L'utente viene reindirizzato a un provider (ad esempio GitHub) per approvare l'accesso.
- Il fornitore rilascia un codice di autorizzazione.
- Esadax scambia questo codice con un token di accesso di breve durata.
- 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.
