Ce guide explique comment provisionner automatiquement les comptes utilisateur dans Discourse lorsqu’un fournisseur d’authentification externe est activé, afin que les utilisateurs soient créés automatiquement sans être affichés une page d’inscription.
Niveau d’utilisateur requis : Administrateur
Provisionnement automatique des comptes utilisateur avec authentification externe
Lorsque vous connectez Discourse à un fournisseur d’identité externe via DiscourseConnect, le plugin OpenID Connect, le plugin OAuth2 Basic, SAML ou tout autre fournisseur d’authentification, Discourse crée des comptes utilisateur lors de la première connexion. Par défaut, il affiche une page d’inscription avant de créer le compte, même lorsque le fournisseur a déjà fourni tous les détails requis (e-mail, nom d’utilisateur et nom).
Le provisionnement automatique supprime cette étape supplémentaire. Avec les paramètres appropriés activés, Discourse crée silencieusement le compte en arrière-plan et connecte directement l’utilisateur, offrant ainsi une expérience fluide.
Activation du provisionnement automatique
Pour passer l’étape d’inscription, vous devez activer le paramètre de site auth_skip_create_confirm. Ce paramètre se trouve dans Admin > Tous les paramètres de site > Page de connexion.
Facultatif : Activer les paramètres de remplacement
Ces paramètres indiquent à Discourse de faire confiance aux valeurs fournies par votre fournisseur d’identité et de les utiliser directement, sans demander à l’utilisateur de les examiner. Accédez à Admin > Tous les paramètres de site > Page de connexion et cochez les éléments suivants :
| Paramètre | Description |
|---|---|
auth_overrides_username |
Utilise le nom d’utilisateur du fournisseur directement à chaque connexion et empêche l’utilisateur de le modifier localement. S’applique à tous les fournisseurs d’authentification. |
auth_overrides_email |
Utilise l’e-mail du fournisseur directement à chaque connexion et empêche l’utilisateur de le modifier localement. S’applique à tous les fournisseurs d’authentification. |
auth_overrides_name |
Utilise le nom complet du fournisseur directement à chaque connexion et empêche l’utilisateur de le modifier localement. S’applique à tous les fournisseurs d’authentification. |
auth_overrides_avatar |
Utilise l’avatar du fournisseur directement à chaque connexion et empêche l’utilisateur de le modifier localement. S’applique à tous les fournisseurs d’authentification. |
Les plugins OAuth2 Basic, OpenID Connect et SAML disposent également de leurs propres paramètres de remplacement spécifiques au plugin (
oauth2_overrides_email,openid_connect_overrides_email,saml_sync_email). Ceux-ci fonctionnent de la même manière que le paramètre globalauth_overrides_email, mais ne s’appliquent qu’à leur fournisseur respectif. Pour la plupart des configurations, les paramètres globaux ci-dessus sont suffisants.
FAQ
Ces paramètres s’appliquent-ils à tous les plugins d’authentification ou uniquement à DiscourseConnect ?
Les paramètres auth_skip_create_confirm et auth_overrides * s’appliquent à tous les fournisseurs d’authentification externes, y compris DiscourseConnect, OpenID Connect, OAuth2 Basic, SAML et tout autre plugin construit sur le framework d’authentification de Discourse.
Puis-je créer des comptes pour les utilisateurs avant qu’ils ne se connectent ?
Oui, mais uniquement lors de l’utilisation de DiscourseConnect. Utilisez la route API sync_sso comme décrit dans Sync DiscourseConnect user data with the sync_sso route.
Quelle est la différence entre DiscourseConnect et les plugins OAuth2/OIDC ?
DiscourseConnect est le protocole SSO personnalisé de Discourse. Il donne à votre site externe un contrôle total sur les comptes Discourse, y compris la possibilité de pousser l’appartenance aux groupes, de remplacer les champs et de pré-créer des comptes via l’API. Les plugins OAuth2 et OpenID Connect utilisent des protocoles standards de l’industrie, ce qui les rend plus faciles à connecter à des fournisseurs d’identité tiers avec une configuration minimale.