Configurer la connexion GitHub pour Discourse

[Discourse]

Ce guide explique comment configurer GitHub comme option de connexion pour votre forum Discourse en configurant les informations d’identification OAuth.

Niveau d’utilisateur requis : Administrateur

Vue d’ensemble

L’intégration de la connexion GitHub permet aux utilisateurs de se connecter à votre site Discourse en utilisant leurs comptes GitHub. Ceci offre une option d’authentification pratique, particulièrement utile pour les communautés axées sur les développeurs.

Configuration de GitHub OAuth

1. Rendez-vous sur les paramètres développeur de GitHub à l’adresse https://github.com/settings/developers

2. Dans le menu de gauche, localisez et cliquez sur OAuth Apps

3. Cliquez sur New OAuth App

4. Remplissez les champs requis :

   • Application name : Entrez le nom de votre site
   • Homepage URL : L’URL principale de votre site (par exemple, https://discourse.example.com)
   • Application description (optionnel) : Décrivez brièvement votre site
   • Authorization callback URL : Utilisez le domaine de votre site avec le chemin /auth/github/callback
     (par exemple, https://discourse.example.com/auth/github/callback)

5. Cliquez sur Register application

Configuration des paramètres de Discourse

1. Après l’inscription, GitHub affichera votre Client ID sur la page des paramètres de l’application.

2. Pour obtenir un Client Secret, cliquez sur Generate a new client secret. Copiez-le immédiatement — il ne sera affiché qu’une seule fois.

3. Dans les paramètres d’administration de votre Discourse, configurez les éléments suivants :

   • Définissez github_client_id sur votre Client ID
   • Définissez github_client_secret sur votre Client Secret
   • Activez le paramètre enable github logins

Test de l’intégration

1. Déconnectez-vous de votre site Discourse
2. Sur la page de connexion, vous devriez maintenant voir une option de connexion « with GitHub »
3. Testez le flux de connexion pour vous assurer qu’il fonctionne comme prévu

Meilleures pratiques

• Gardez votre Client Secret sécurisé et ne le partagez jamais publiquement
• Examinez régulièrement les paramètres de votre application OAuth GitHub
• Envisagez d’activer des fonctionnalités de sécurité supplémentaires dans les paramètres de l’application OAuth de GitHub

Problèmes courants et solutions

• Si la connexion échoue, vérifiez que votre URL de rappel correspond exactement à ce qui est configuré dans GitHub
• Assurez-vous que le certificat SSL de votre site est valide, car GitHub exige HTTPS
• Vérifiez que l’ID client et le secret sont tous deux correctement saisis dans les paramètres de Discourse

Ressources supplémentaires

• Setup DiscourseConnect - Official Single-Sign-On for Discourse (sso)
• Creating an OAuth app - GitHub Docs