Pour utiliser ce plugin, vous devez avoir accès à un compte développeur Apple payant.
| Résumé | Discourse Apple Authentication permet aux utilisateurs de se connecter en utilisant l’authentification Apple. | |
| Guide d’installation | Ce plugin est inclus dans le noyau de Discourse. Il n’est pas nécessaire de l’installer séparément. |
Pour l’essayer, rendez-vous sur try.discourse.org et connectez-vous. Voici une démonstration de son fonctionnement sur iOS :
Pour la configuration, vous devrez régler plusieurs éléments dans la console développeur Apple :
-
Rendez-vous sur Sign In - Apple et connectez-vous
-
Configurez un App ID
- Allez dans « Certificates Identities and Profiles »
- Cliquez sur « Identifiers » dans le menu de gauche
- Cliquez sur le bouton + pour créer un nouvel identifiant
- Sélectionnez « App IDs », puis continuez
- Choisissez « App », puis continuez
- Entrez une description (visible pour les utilisateurs dans leur liste d’applications autorisées). Par exemple « Awesome Community Login »
- Entrez un bundle ID. Apple recommande d’inverser votre nom de domaine, par exemple
com.example.forum - Faites défiler vers le bas et activez « Sign in with Apple »
- Cliquez sur « Continue »
- Notez l’Team ID pour plus tard
- Cliquez sur « Register »
-
Configurez un Services ID
- Allez dans « Certificates Identities and Profiles »
- Cliquez sur le bouton + pour créer un nouvel identifiant
- Choisissez « Services ID », puis continuez
- Entrez une description. Celle-ci sera affichée aux utilisateurs lors de la connexion. Par exemple « Awesome Discourse Community »
- Entrez un bundle ID. Vous pouvez utiliser le même que celui de l’App ID avec
.loginà la fin - Notez ce bundle ID pour plus tard. Il servira de Client ID
- Cliquez sur Continue, puis Register
- Trouvez le service ID dans la liste et ouvrez-le
- Activez « Sign in with Apple » et cliquez sur « configure »
- Entrez votre nom de domaine de site web, par exemple
forum.example.com, et une URL de rappel, par exemplehttps://forum.example.com/auth/apple/callback - Cliquez sur Next, Done, Continue, puis Save
-
Configurez une clé (Key)
- Cliquez sur « Keys » dans le menu de gauche
- Cliquez sur + pour créer une nouvelle clé
- Entrez un nom, par exemple « Awesome Community Login »
- Activez « Sign In With Apple », puis cliquez sur « Configure »
- Choisissez l’App ID principal que vous avez créé précédemment
- Cliquez sur Save, puis Continue
- Cliquez sur Register
- Notez le Key ID pour plus tard
- Téléchargez la clé et conservez-la en lieu sûr. Elle constituera la valeur apple_pem
- Cliquez sur Done
-
Accédez aux paramètres de votre site Discourse
- Recherchez
apple_ - Entrez le client id, le team id et le key id notés précédemment
- Ouvrez le fichier de clé dans un éditeur de texte, sélectionnez tout son contenu et copiez-le dans le paramètre du site
apple pem - Activez
sign in with apple enabled
- Recherchez
Essayez maintenant : si tout s’est déroulé comme prévu, vous devriez voir un bouton « with Apple » sur l’écran de connexion.
Adresses e-mail privées
Si les utilisateurs choisissent de « masquer mon e-mail » lors de la connexion, le forum recevra une adresse de « relais privé » Apple pour l’utilisateur. Pour permettre à votre forum de communiquer avec cette adresse, vous devez la vérifier auprès d’Apple.
-
Rendez-vous sur Sign In - Apple et connectez-vous
-
Allez dans « Certificates Identities and Profiles »
-
Cliquez sur « More » à gauche, puis sur « Configure » sous « Sign in with Apple for Email Communication »
-
Cliquez sur + à côté de « Email Sources »
-
Sous « Domains », entrez le nom de domaine depuis lequel votre site envoie des e-mails. (Pour les clients hébergés par CDCK, il s’agit de
discoursemail.com) -
Enregistrez et vérifiez que l’adresse SPF est validée pour cette adresse
Notez que la saisie d’une adresse e-mail individuelle ici cassera la fonctionnalité « réponse par e-mail » de Discourse. Vous devez ajouter tout le domaine.

