Verifica GitHub di Discourse

|||
-|-|-|
| Riepilogo | Verifica che un utente possieda un dato account GitHub
| Link al Repository | GitHub - discourse/discourse-github-verification: Verifies that a Discourse user is the owner of a Github account
| Guida all’Installazione | Come installare plugin in Discourse

Funzionalità

Questo plugin consente agli utenti di verificare di possedere un dato account GitHub. Questo è separato dall’accesso con GitHub. Visualizza semplicemente un link all’account GitHub di un utente sulla sua scheda utente e sul suo profilo.

Una nuova scheda (GitHub) viene aggiunta alle preferenze utente. C’è un pulsante per collegare il tuo account con GitHub quando l’utente non ha ancora collegato il suo account. Se l’utente ha collegato il suo account, vedrà un link al suo account GitHub e un pulsante per scollegare il suo account GitHub dal suo profilo Discourse.

1511f14d5db0f2c331bd201f403abbc16e71d923690×241 22.9 KB

image689×256 14.6 KB

Se un utente ha un account GitHub collegato, verrà visualizzato un link sulla sua scheda utente e sul suo profilo utente

image690×279 26 KB

image690×261 20 KB

Il plugin aggiunge un endpoint API admin /github-verification/users.json, che restituisce un array di tutti gli utenti con un account GitHub collegato. La risposta è simile a questa:

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

Configurazione

Impostazione dell’app OAuth di GitHub

• Segui le istruzioni di GitHub sulla creazione di un’app OAuth. Ci sono due impostazioni importanti da configurare nelle impostazioni dell’app OAuth

  • Homepage URL - la homepage della tua istanza Discourse (ad es. https://meta.discourse.org)

  • Authorization callback URL - la home della tua istanza Discourse più “/github-verification” (ad es. https://meta.discourse.org/github-verification)

Configurazione delle impostazioni di Discourse

Le impostazioni si trovano su /admin/site_settings/category/all_results?filter=discourse_github_verification

• discourse github verification enabled - Abilita il plugin controllando nel pannello delle impostazioni del sito (/admin/site_settings/category/all_results?filter=discourse_github_verification).

• discourse github verification client id - Client ID della tua app OAuth di GitHub

• discourse github verification client secret - Client secret della tua app OAuth di GitHub

Avvertenza

Questo plugin non tiene conto della configurazione esistente di accesso con GitHub. Discourse lo supporta di default, ma il plugin discourse-github-verification non utilizza le impostazioni github client id e github client secret esistenti di un sito. Nel caso in cui questi siano compilati, potremmo probabilmente usarli invece di duplicare le impostazioni. Il plugin inoltre non sa se un utente ha già effettuato l’accesso a Discourse con GitHub. Sarebbe bello rilevarlo automaticamente.

Grazie a Sailpoint per aver sponsorizzato questo lavoro e averlo reso open-source

Per chi si stesse chiedendo come questo plugin possa essere utile, lo abbiamo sviluppato per funzionare in congiunzione con il plugin di gamification.

Permettiamo ai nostri utenti di guadagnare punti nel nostro programma contributori contribuendo ai nostri repository GitHub. Abbiamo fatto realizzare questo plugin in modo da poter garantire che l’utente possedesse effettivamente l’account GitHub che diceva di possedere. Quando si verifica un evento di contributo in GitHub, interroghiamo il nostro elenco di utenti con account GitHub collegati e vediamo se l’account GitHub esiste nel forum. In tal caso, gli diamo i punti designati.