Aller au contenu principal

Configurer la connexion GitHub dans Astrolabe

Tu donnes à Astrolabe l'ID client et le Secret client de ton application OAuth GitHub. Ensuite, la page de connexion propose Continue with GitHub.

Tu le fais une fois, en administrateur.

Avant de commencer​

Il te faut l'ID client et le Secret client de l'application : voir Créer l'application OAuth dans GitHub.

🔧 Installer le fournisseur GitHub​

  1. Dans la barre latérale, en bas, clique sur Administration.

  2. Sous PLATEFORME, clique sur Authentification. L'onglet Fournisseurs s'ouvre.

  3. Sur la carte GitHub, clique sur l'interrupteur en haut à droite de la carte. La fenêtre Configurer GitHub s'ouvre.

  4. Remplis le formulaire. Chaque ? à côté d'un libellé explique le champ.

    ChampQuoi écrireExemple
    ID clientLe Client ID de ton application OAuthOv23li…
    Secret clientLe secret client de l'application0123…
    URL de l'instance d'entrepriseLaisse vide. Pour GitHub Enterprise seulement : son adresse complète avec https://.https://github.exemple.com
    URL de rappelLaisse vide : Astrolabe utilise <adresse d'Astrolabe>/api/auth/github/handler/frame.
  5. Clique sur Installer. L'instance se recharge.

Quand la page revient, la carte GitHub a son interrupteur allumé, avec un bouton Configurer. Un avertissement au-dessus des cartes dit Personne ne peut encore se connecter avec GitHub : un compte doit d'abord être dans le catalogue. tant que la section suivante n'est pas faite.

👥 Importer les membres​

La connexion avec GitHub ne marche que pour un compte qu'Astrolabe connaît déjà. Tu importes les membres de ton organisation GitHub dans le catalogue.

  1. Dans l'avertissement, clique sur Ouvrir Catalogue › GitHub. La page Catalogue s'ouvre.

  2. Sur la carte GitHub, clique sur Configurer. La fenêtre Configurer GitHub s'ouvre.

  3. Remplis Organisation avec le nom de ton organisation GitHub.

  4. Coche Importer les membres et équipes GitHub.

  5. Clique sur Installer. L'instance se recharge.

  6. Retourne dans Administration › Authentification : l'avertissement a disparu.

Les étapes 3 à 6 n'ont pas été vérifiées sur une instance reliée à une vraie organisation GitHub.

Le jeton de ta connexion GitHub a besoin des droits read:org et read:user. Les autres champs sont décrits dans Importer tes dépôts GitHub.

✅ C'est tout !

La suite : Se connecter avec GitHub.

🔌 Éteindre la connexion GitHub​

  1. Dans Administration › Authentification, clique sur Configurer sur la carte GitHub.

  2. Clique sur Désinstaller. L'instance se recharge, sans demander de confirmation.

Le bouton Continue with GitHub quitte la page de connexion.