Configurer la connexion sociale avec GitHub
Le connecteur officiel Logto pour la connexion sociale GitHub.
Dans ce guide, nous supposons que vous avez des connaissances de base sur les Connecteurs Logto. Si ce n'est pas le cas, consultez le guide Configurer les connecteurs pour commencer.
Commencer
Le connecteur GitHub permet aux utilisateurs finaux de se connecter à votre application en utilisant leurs propres comptes GitHub via le protocole d'Authentification OAuth 2.0 de GitHub.
Se connecter avec un compte GitHub
Allez sur le site GitHub et connectez-vous avec votre compte GitHub. Vous pouvez créer un nouveau compte si vous n'en avez pas.
Créer et configurer une application OAuth
Suivez le guide création d'une application OAuth, et enregistrez une nouvelle application.
Nommez votre nouvelle application OAuth dans Nom de l'application et remplissez l'URL de la page d'accueil de l'application. Vous pouvez laisser le champ Description de l'application vide et personnaliser l'URL de rappel d'autorisation comme ${your_logto_origin}/callback/${connector_id}. Le connector_id peut être trouvé dans la barre supérieure de la page de détails du connecteur de la Logto Admin Console.
Remarque : Si vous rencontrez le message d'erreur "L'URL de redirection DOIT correspondre à l'URL de rappel enregistrée pour cette application." lors de la connexion, essayez d'aligner l'URL de rappel d'autorisation de votre application GitHub OAuth et l'URL de redirection de votre application Logto (bien sûr, y compris le protocole) pour résoudre le problème.
Nous vous suggérons de ne pas cocher la case devant Activer le flux de périphérique, sinon les utilisateurs qui se connectent avec GitHub sur des appareils mobiles devront confirmer l'action de connexion initiale dans l'application GitHub. De nombreux utilisateurs de GitHub n'installent pas l'application mobile GitHub sur leurs téléphones, ce qui pourrait bloquer le flux de connexion. Veuillez ignorer notre suggestion si vous attendez des utilisateurs finaux qu'ils confirment leur flux de connexion. Voir les détails du flux de périphérique.
Gestion des applications OAuth
Allez sur la page des applications OAuth et vous pouvez ajouter, modifier ou supprimer des applications OAuth existantes.
Vous pouvez également trouver Client ID et générer des Client secrets dans les pages de détails des applications OAuth.
Configurer votre connecteur
Remplissez le champ clientId et clientSecret avec le Client ID et le Client Secret que vous avez obtenus à partir des pages de détails des applications OAuth mentionnées dans la section précédente.
scope est une liste délimitée par des espaces de portées. Si non fourni, la portée par défaut est read:user.
Types de configuration
| Nom | Type |
|---|---|
| clientId | string |
| clientSecret | string |
| scope | string |
Tester le connecteur GitHub
C'est tout. Le connecteur GitHub devrait être disponible maintenant. N'oubliez pas de Activer le connecteur social dans l'expérience de connexion.