Comprendre comment Esadax permet une authentification sécurisée et transparente en utilisant des fournisseurs tiers comme GitHub, GitLab, Bitbucket et le protocole OAuth 2.0.

Table des matières

1. Vue d'ensemble des connexions de connexion
2. Authentification de GitHub
3. Authentification de GitLab
4. Authentification de Bitbucket
5. Comprendre OAuth 2.0
6. Meilleures pratiques en matière de sécurité
7. Troubleshooting
8. Glossaire

---

Vue d'ensemble des connexions de connexion

Esadax prend en charge des options de connexion conviviales pour les développeurs utilisant des services de contrôle de version populaires et des protocoles standard de l'industrie:

• GitHub
• GitLab
• Bitbucket
• OAuth 2.0

Ces connexions vous permettent de :

• Authentifier rapidement sans créer de nouveaux mots de passe.
• Gérez l'accès via votre plateforme d'hébergement de code préférée.
• Simplifiez l'intégration des équipes et la gestion des autorisations.

---

Authentification de GitHub

• Pourquoi GitHub?

  • GitHub est largement utilisé dans la communauté des développeurs et fournit un support OAuth 2.0 fiable.

• Étapes pour se connecter via GitHub:

  1. Cliquez sur le bouton « Se connecter avec GitHub » sur la page de connexion Esadax.
  2. Vous serez redirigé vers l'écran de consentement OAuth de GitHub.
  3. Accorder à Esadax l'accès à votre profil GitHub.
  4. Vous serez connecté en toute sécurité à Esadax.

• Portées utilisées:

  • read:user
  • user:email

• Notes :

  • Aucun accès en écriture ou accès au référentiel n'est demandé.
  • Votre mot de passe n’est jamais partagé avec Esadax.

---

Authentification de GitLab

• Étapes pour se connecter via GitLab:

  1. Choisissez « Se connecter avec GitLab » dans les options de connexion Esadax.
  2. Vous serez redirigé vers l’invite d’authentification de GitLab.
  3. Approuver les portées demandées.
  4. Vous reviendrez sur Esadax avec votre session authentifiée.

• Instances GitLab prises en charge:

  • GitLab.com (public)
  • Instances GitLab auto-hébergées (à venir)

• Portées utilisées:

  • read_user

---

Authentification de Bitbucket

• Étapes pour se connecter via Bitbucket:

  1. Cliquez sur l’option « Se connecter avec Bitbucket ».
  2. Autorisez la connexion via le flux OAuth de Bitbucket.
  3. Retournez à Esadax en tant qu'utilisateur vérifié.

• Portées utilisées:

  • account
  • email

• Notes :

  • Idéal pour les équipes utilisant Bitbucket Cloud.
  • La prise en charge de Bitbucket Server n'est pas disponible actuellement.

---

Comprendre OAuth 2.0

OAuth 2.0 est le protocole sécurisé standard de l'industrie qu'Esadax utilise pour s'intégrer à des services externes.

• Comment ça marche:

  1. L'utilisateur est redirigé vers un fournisseur (par exemple, GitHub) pour approuver l'accès.
  2. Le fournisseur émet un code d'autorisation.
  3. Esadax échange ce code contre un jeton d’accès de courte durée.
  4. Le jeton est utilisé pour récupérer les informations de base de l'utilisateur.

• Avantages :

  • Plus besoin de gérer les mots de passe.
  • Identité décentralisée — les utilisateurs contrôlent l'accès.
  • Les jetons expirables réduisent le risque de sécurité.

---

Meilleures pratiques en matière de sécurité

• Stockage de jetons:

  • Les jetons sont stockés en toute sécurité et chiffrés au repos.

• Gestion des sessions:

  • Les sessions sont de courte durée avec expiration automatique.
  • Support 2FA facultatif pour une sécurité supplémentaire.

• Autorisations minimales:

  • Seules les portées essentielles sont demandées.
  • Aucun accès en écriture ou au dépôt sauf si explicitement nécessaire.

---

Troubleshooting

• Connexion ne fonctionne pas?:

  • Assurez-vous que votre compte tiers est actif.
  • Vérifiez votre adresse e-mail auprès du fournisseur.
  • Essayez d'effacer vos cookies ou d'utiliser une fenêtre de navigation privée.

• Compte déjà lié?

  • Si vous vous êtes précédemment connecté en utilisant une méthode différente (par exemple, e-mail), accédez à Paramètres du compte → Connexions pour lier les comptes.

• Erreur d'accès refusé?

  • Cela se produit généralement si les étendues requises ne sont pas accordées. Réessayez de vous connecter et assurez-vous que toutes les invites sont acceptées.

---

Glossaire

• OAuth 2.0 : Protocole permettant de déléguer les autorisations entre applications sans partager les mots de passe.
• Scopes : Permissions demandées lors de la connexion OAuth pour accéder à des données spécifiques.
• Access Token : Identifiant temporaire utilisé pour accéder aux données de l’utilisateur depuis le fournisseur.
• Fournisseur : Le service externe utilisé pour l'authentification (par exemple, GitHub, GitLab).
• Écran de consentement : L'interface utilisateur affichée par le fournisseur où les utilisateurs approuvent l'accès demandé.

---