Vérification GitHub Discourse

Greffon
1

|||
-|-|-|
:discourse2: | Résumé | Vérifie qu’un utilisateur possède un compte GitHub donné
:hammer_and_wrench: | Lien vers le dépôt | GitHub - discourse/discourse-github-verification: Verifies that a Discourse user is the owner of a Github account
:open_book: | Guide d’installation | Comment installer des plugins dans Discourse

Fonctionnalités

Ce plugin permet aux utilisateurs de vérifier qu’ils possèdent un compte GitHub donné. Ceci est distinct de la connexion avec GitHub. Il affiche simplement un lien vers le compte GitHub d’un utilisateur sur sa carte utilisateur et son profil.

Un nouvel onglet (GitHub) est ajouté aux préférences utilisateur. Il y a un bouton pour connecter son compte avec GitHub lorsque l’utilisateur n’a pas encore connecté son compte. Si l’utilisateur a connecté son compte, il verra un lien vers son compte GitHub et un bouton pour déconnecter son compte GitHub de son profil Discourse.

1511f14d5db0f2c331bd201f403abbc16e71d923
1511f14d5db0f2c331bd201f403abbc16e71d923690×241 22.9 KB

image
image689×256 14.6 KB

Si un utilisateur a un compte GitHub connecté, un lien sera affiché sur sa carte utilisateur et son profil utilisateur.

image
image690×279 26 KB

image
image690×261 20 KB

Le plugin ajoute un point d’accès API administrateur /github-verification/users.json, qui renvoie un tableau de tous les utilisateurs ayant un compte GitHub connecté. La réponse ressemble à ceci :

[
  {
    "id": 1,
    "username": "markvanlan",
    "github_username": "markvanlan"
  }
]

Configuration

Configuration de l’application OAuth GitHub

  • Suivez les instructions de GitHub pour créer une application OAuth. Deux paramètres importants doivent être configurés dans les paramètres de l’application OAuth :

    • Homepage URL - l’URL d’accueil de votre instance Discourse (par exemple, https://meta.discourse.org)

    • Authorization callback URL - l’URL d’accueil de votre instance Discourse plus “/github-verification” (par exemple, https://meta.discourse.org/github-verification)

Configuration des paramètres Discourse

Les paramètres se trouvent à l’adresse /admin/site_settings/category/all_results?filter=discourse_github_verification

  • discourse github verification enabled - Active le plugin en cochant dans le panneau des paramètres du site (/admin/site_settings/category/all_results?filter=discourse_github_verification).

  • discourse github verification client id - ID client de votre application OAuth GitHub

  • discourse github verification client secret - Secret client de votre application OAuth GitHub

Mise en garde

Ce plugin ne prend pas en compte la configuration existante de connexion avec GitHub. Discourse le prend en charge par défaut, mais le plugin discourse-github-verification n’utilise pas les paramètres github client id et github client secret existants d’un site. Dans le cas où ceux-ci seraient remplis, nous pourrions probablement les utiliser au lieu de dupliquer les paramètres. Le plugin ne sait pas non plus si un utilisateur s’est déjà connecté à Discourse avec GitHub. Il serait souhaitable de le détecter automatiquement.

Merci à Sailpoint d’avoir sponsorisé ce travail et de l’avoir rendu open-source :tada:

11 « J'aime »
2

Pour ceux qui se demandent comment ce plugin pourrait être utile, nous l’avons développé pour fonctionner en conjonction avec le plugin de gamification.

Nous permettons à nos utilisateurs de gagner des points dans notre programme de contributeurs en contribuant à nos dépôts GitHub. Nous avons fait faire ce plugin afin de nous assurer que l’utilisateur possédait réellement le compte GitHub qu’il prétendait avoir. Lorsqu’un événement de contribution se produit sur GitHub, nous interrogeons notre liste d’utilisateurs ayant des comptes GitHub connectés et vérifions si le compte GitHub existe sur le forum. Si c’est le cas, nous leur attribuons les points désignés.

3 « J'aime »