Per utilizzare questo plugin, è necessario avere accesso a un account sviluppatore Apple a pagamento.
 |
Riepilogo | Discourse Apple Authentication consente agli utenti di effettuare l’accesso utilizzando l’autenticazione Apple. |
 |
Guida all’installazione | Questo plugin è incluso nel core di Discourse. Non è necessario installare il plugin separatamente. |
Per provarlo, vai su try.discourse.org ed effettua l’accesso. Ecco una demo del suo funzionamento su iOS:
Per configurarlo, dovrai impostare diverse cose nella console degli sviluppatori Apple:
-
Visita Sign In - Apple ed effettua l’accesso
-
Configura un App ID
- Vai a “Certificates, Identities and Profiles”
- Clicca su “Identifiers” nel menu a sinistra
- Clicca sul pulsante + per creare un nuovo identificatore
- Seleziona “App IDs”, poi continua
- Seleziona “App”, poi continua
- Inserisci una descrizione (visibile agli utenti nell’elenco delle app autorizzate). Ad esempio “Acceso alla Comunità Straordinaria”
- Inserisci un bundle ID. Apple consiglia di invertire il nome del tuo dominio, ad esempio
com.example.forum - Scorri verso il basso e abilita “Sign in with Apple”
- Clicca su “Continue”
- Annota l’Team ID per dopo
- Clicca su “Register”
-
Configura un Services ID
- Vai a “Certificates, Identities and Profiles”
- Clicca sul pulsante + per creare un nuovo identificatore
- Seleziona “Services ID”, poi continua
- Inserisci una descrizione. Verrà mostrata agli utenti durante l’accesso. Ad esempio “Comunità Discourse Straordinaria”
- Inserisci un bundle ID. Puoi usare lo stesso dell’App ID aggiungendo
.loginalla fine - Annota questo bundle ID per dopo. Sarà l’Client ID
- Clicca su Continue, poi Register
- Trova l’ID del servizio nell’elenco e aprilo
- Abilita Sign in with Apple e clicca su ‘configure’
- Inserisci il dominio del tuo sito, ad esempio
forum.example.com, e un URL di callback comehttps://forum.example.com/auth/apple/callback - Successivamente, clicca su Done, Continue, Save
-
Configura una Chiave
- Clicca su “Keys” nel menu a sinistra
- Clicca su + per creare una nuova chiave
- Inserisci un nome, ad esempio “Acceso alla Comunità Straordinaria”
- Abilita ‘Sign In With Apple’, poi clicca su “Configure”
- Seleziona l’App ID principale creato in precedenza
- Clicca su Save, poi Continue
- Clicca su Register
- Annota l’Key ID per dopo
- Scarica la chiave e conservarla in un luogo sicuro. Sarà il valore apple_pem
- Clicca su Done
-
Vai alle impostazioni del sito Discourse
- Cerca
apple_ - Inserisci il client id, il team id e il key id ottenuti in precedenza
- Apri il file della chiave in un editor di testo, seleziona tutto e copia/incolla il contenuto nell’impostazione del sito
apple pem - Abilita
sign in with apple enabled
- Cerca
Ora provalo: se tutto è andato secondo i piani, dovresti ora vedere un pulsante “Accedi con Apple” nella schermata di accesso.
Email private
Se gli utenti scelgono di ‘nascondi la mia email’ durante l’accesso, il forum riceverà un indirizzo ‘private relay’ di Apple per l’utente. Per consentire al tuo forum di comunicare con quell’indirizzo, devi verificarlo con Apple
-
Visita Sign In - Apple ed effettua l’accesso
-
Clicca su ‘More’ a sinistra, poi su “Configure” sotto ‘Sign in with Apple for Email Communication’
-
Clicca su + accanto a Email Sources
-
Sotto ‘Domains’, inserisci il nome di dominio da cui il tuo sito invia le email. (per i clienti ospitati da CDCK, questo è
discoursemail.com) -
Clicca su Save e verifica che SPF sia verificato per l’indirizzo
Nota che l’inserimento di un indirizzo email individuale qui interromperà la funzionalità ‘rispondi via email’ di Discourse. Devi aggiungere l’intero dominio.
Questo plugin è ora incluso nel core di Discourse come parte di 