Configura l'accesso a GitHub per Discourse

[Discourse]

Questa guida spiega come configurare GitHub come opzione di accesso per il tuo forum Discourse configurando le credenziali OAuth.

Livello utente richiesto: Amministratore

Panoramica

L’integrazione di accesso tramite GitHub consente agli utenti di accedere al tuo sito Discourse utilizzando i propri account GitHub. Questa opzione di autenticazione è comoda, specialmente per le community focalizzate sullo sviluppo.

Configurazione di GitHub OAuth

1. Visita le impostazioni sviluppatore di GitHub all’indirizzo https://github.com/settings/developers

2. Nel menu a sinistra, individua e fai clic su OAuth Apps (App OAuth)

3. Fai clic su New OAuth App (Nuova App OAuth)

4. Compila i campi richiesti:

   • Application name (Nome applicazione): Inserisci il nome del tuo sito
   • Homepage URL (URL homepage): L’URL principale del tuo sito (es. https://discourse.example.com)
   • Application description (Descrizione applicazione) (opzionale): Descrivi brevemente il tuo sito
   • Authorization callback URL (URL di callback di autorizzazione): Utilizza il dominio del tuo sito con il percorso /auth/github/callback
     (es. https://discourse.example.com/auth/github/callback)

5. Fai clic su Register application (Registra applicazione)

Configurazione delle impostazioni di Discourse

1. Dopo la registrazione, GitHub visualizzerà il tuo Client ID sulla pagina delle impostazioni dell’app.

2. Per ottenere un Client Secret, fai clic su Generate a new client secret (Genera un nuovo segreto client). Copialo immediatamente: verrà mostrato solo una volta.

3. Nelle impostazioni di amministrazione di Discourse, configura quanto segue:

   • Imposta github_client_id sul tuo Client ID
   • Imposta github_client_secret sul tuo Client Secret
   • Abilita l’impostazione enable github logins (abilita accessi con GitHub)

Test dell’integrazione

1. Disconnettiti dal tuo sito Discourse
2. Nella pagina di accesso, dovresti ora vedere un’opzione di accesso “with GitHub” (con GitHub)
3. Testa il flusso di accesso per assicurarti che funzioni come previsto

Best practice

• Mantieni sicuro il tuo Client Secret e non condividerlo mai pubblicamente
• Rivedi regolarmente le impostazioni della tua app OAuth di GitHub
• Valuta l’abilitazione di funzionalità di sicurezza aggiuntive nelle impostazioni dell’app OAuth di GitHub

Problemi comuni e soluzioni

• Se l’accesso fallisce, verifica che il tuo URL di callback corrisponda esattamente a quello configurato in GitHub
• Assicurati che il certificato SSL del tuo sito sia valido, poiché GitHub richiede HTTPS
• Verifica che sia il client ID che il segreto siano inseriti correttamente nelle impostazioni di Discourse

Risorse aggiuntive

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