Raccorder la connexion GitHub

Pour que les utilisateurs de votre service s'inscrivent avec un compte GitHub, vous enregistrez d'abord ce service auprès de GitHub et vous récupérez un Client ID et un Client secret.

Cette page indique l'ordre dans lequel récupérer le Client ID et le Client secret. La manière de placer les deux valeurs récupérées dans WEEGLOO se trouve dans Placer le Client ID et le Client secret dans WEEGLOO.

Récupérer le Client ID et le Client secret chez GitHub

Connectez-vous à GitHub, puis suivez dans l'ordre les deux étapes ci-dessous. Ce que vous faites ici n'entraîne aucun coût.

1

Enregistrer une OAuth App

Le Client ID et le Client secret se trouvent dans l'unique application que vous enregistrez ici.

  1. Ouvrez l'écran des paramètres développeur (https://github.com/settings/developers (s'ouvre dans un nouvel onglet)).

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

  3. Cliquez sur New OAuth app.

    L'écran OAuth Apps. Le menu de gauche contient GitHub Apps, OAuth Apps et Personal access tokens, la liste est vide et le bouton New OAuth app est visible

  4. Dans Application name, saisissez le nom que verront vos utilisateurs (par exemple Le Dressing Douillet).

  5. Dans Homepage URL, saisissez l'adresse de votre site (par exemple https://dressing-douillet.fr).

    Si vous n'avez pas encore de site, notez l'adresse que vous utiliserez plus tard. Vous pourrez la corriger ensuite. Application description, qui figure sur le même formulaire, est facultatif ; ce que vous y écrivez est présenté tel quel à vos utilisateurs, écrivez donc une phrase que vos utilisateurs liront.

  6. Dans le champ Redirect URI, collez l'adresse ci-dessous. Choisissez votre Space et l'identifiant se remplit.

    Space
    https://auth.weegloo.com/v1/spaces/{spaceId}/login/oauth2/code/github

    Si vous ne savez pas quel est votre Space et que vous avez confié le raccordement à un agent IA, vous pouvez aussi le lui demander. Demandez dans la fenêtre de conversation « Donne-moi l'adresse de redirection à enregistrer pour la connexion GitHub » et vous recevez l'adresse complète.

  7. Cliquez sur Register application.

    Le formulaire Register a new OAuth app. Application name contient « Le Dressing Douillet », Homepage URL l'adresse du site et Redirect URI l'adresse WEEGLOO

2

Copier le Client ID et le Client secret

Lorsque vous cliquez sur Register application, l'écran de configuration de l'application que vous venez d'enregistrer s'ouvre. Le Client ID y figure déjà et vous créez le Client secret maintenant en cliquant sur un bouton.

  1. Copiez la valeur inscrite dans Client ID.

  2. Cliquez sur Generate a new client secret, à droite du titre Client secrets.

    L'écran de configuration de l'application juste après l'enregistrement. La valeur du Client ID est visible et le bouton Generate a new client secret se trouve à droite du titre Client secrets

  3. Cliquez sur l'icône de copie à droite de la valeur créée pour copier le secret.

    Une fois cet écran quitté, le secret n'est plus consultable

    Client ID reste sur cet écran et vous pouvez le revoir à tout moment. Ce n'est pas le cas du secret. Si vous l'avez perdu, créez-en un nouveau avec Generate a new client secret et placez de nouveau dans WEEGLOO la valeur obtenue. Le secret est une valeur secrète, comme son nom l'indique. Ne le communiquez à personne et ne l'inscrivez nulle part en public.

    L'écran juste après la création du secret. L'avertissement bleu, la valeur du Client secret et l'icône de copie sont visibles

La connexion exige une adresse e-mail publique

La connexion GitHub s'accompagne d'une condition. Le compte GitHub qui se connecte doit rendre son adresse e-mail publique.

Lorsqu'un utilisateur se connecte avec GitHub, WEEGLOO récupère aussi l'adresse e-mail publique de ce compte et l'enregistre sur le membre. Dans un même Space, une adresse e-mail ne permet de s'inscrire qu'une seule fois. Pour un compte qui n'a désigné aucune adresse e-mail publique, cette valeur n'est pas transmise, et l'inscription s'arrête là.

Quand elle s'arrête, l'utilisateur voit un écran d'information affiché par WEEGLOO. Cet écran indique, dans la langue de l'utilisateur, que l'adresse e-mail n'a pas pu être récupérée et ce qu'il faut faire, et il comporte un bouton qui ramène à votre site.

L'écran d'information de WEEGLOO indiquant que l'adresse e-mail n'a pas pu être récupérée. L'explication du motif et le bouton Retour au début sont visibles

Dans ce cas, le résultat de la connexion n'arrive pas jusqu'à votre site. Le code de votre site ne peut donc ni détecter cette situation ni la traiter à sa place.

C'est à l'utilisateur de régler lui-même ce problème. Lorsqu'il ouvre Public profile dans les paramètres de son compte GitHub (https://github.com/settings/profile (s'ouvre dans un nouvel onglet)), il y trouve la rubrique Public email. S'il y choisit l'adresse à afficher, la connexion passe dès la fois suivante. Pour un compte qui n'a pas encore choisi, seul Select a verified email to display est inscrit.

L'écran des paramètres de profil GitHub. Public profile est sélectionné dans le menu de gauche et la liste déroulante sous Public email affiche Select a verified email to display

Ce que vous pouvez faire sur votre site, c'est indiquer cette condition à l'avance à l'endroit où l'on se connecte avec GitHub, pour que vos utilisateurs la connaissent avant d'être bloqués.

Placer le Client ID et le Client secret dans WEEGLOO

Vous avez maintenant le Client ID et le Client secret en main. À partir d'ici, le chemin diffère selon la manière dont vous avez travaillé jusqu'à présent.

Si vous configuriez directement dans le studio de contenu, procédez ainsi.

  1. Revenez à l'activation d'une connexion sociale dans Connexion des membres du service.
  2. Activez GitHub.
  3. Saisissez le Client ID dans le champ Client ID de l'étape Step 2.
  4. Saisissez le Client secret dans le champ Client Secret.
  5. Cliquez sur Enregistrer.

Si vous avez confié le raccordement à un agent IA et qu'il vous a demandé d'aller chercher le Client ID et le Client secret, collez telles quelles les deux valeurs récupérées dans la fenêtre de conversation et poursuivez ce que vous faisiez. L'agent prend en charge la suite de la configuration.

Et ensuite

  • Connexion des membres du service : placez les valeurs récupérées dans le studio de contenu et terminez le reste de la configuration de la connexion des membres.
  • Rôles et autorisations des membres : créez le ServiceUserRole qui définit ce qu'un membre inscrit peut voir et écrire.
  • Auth API : traite les spécifications techniques comme le format des requêtes, nécessaires pour rattacher la connexion au code de votre site.