|
OpenID Connect (OIDC) |
Faire défiler Précédente Haut de page Suivante Plus |

Intégration OIDC (Authentification unique)
MDaemon Webmail prend en charge l'authentification unique (SSO) via OpenID Connect (OIDC). Au lieu de se connecter à Webmail avec leur adresse e-mail et leur mot de passe MDaemon, les utilisateurs peuvent cliquer sur le bouton Se connecter avec SSO pour se connecter via votre fournisseur d'identité (IdP) OIDC, par exemple Google ou Microsoft Azure/Entra ID.
Pour configurer cette fonctionnalité, vous devez d'abord créer une application dans l'interface de gestion de votre IdP, en indiquant à cette occasion l'URI de redirection de Webmail (voir ci-dessous). Configurez ensuite les paramètres OIDC de Webmail à l'aide des options ci-dessous.
Activer l'intégration OIDC
Lorsque cette option est activée, un bouton Se connecter avec SSO apparaît sur la page de connexion de Webmail. Les utilisateurs peuvent cliquer sur ce bouton pour se connecter à leur compte Webmail en s'authentifiant auprès de l'IdP sélectionné, au lieu d'indiquer leur adresse e-mail et leur mot de passe MDaemon.
URL de l'émetteur
Ce champ de texte est destiné à l'URL de base fournie par votre fournisseur d'identité OIDC. MDaemon l'utilise pour découvrir la configuration de l'IdP et d'autres données, comme les informations sur l'utilisateur et les clés publiques. N'incluez pas la partie "/.well-known/openid-configuration" qui est couramment ajoutée à la fin de l'URL de l'émetteur. Selon votre IdP, l'URL ressemblera à ceci : https://login.microsoftonline.com/<tenant_id>/v2.0, https://accounts.google.com ou https://<your-domain>.okta.com .
ID client
Il s'agit de votre ID client unique, obtenu auprès de votre IdP lors de l'enregistrement de l'application.
Code secret client
Ce champ est destiné à la clé secrète générée par l'IdP lors de l'enregistrement. Elle est utilisée avec l'ID client pour authentifier MDaemon en tant que client de confiance lors de l'échange de codes d'autorisation contre des jetons d'accès. Certains IdP font expirer le code secret client ; vous devrez donc peut-être le remplacer périodiquement.
Lors de l'enregistrement de votre application OIDC auprès de votre IdP, votre URI de redirection vous sera demandé. L'URI indiqué ici est construit à partir du Nom d'hôte SMTP de votre Domaine par défaut. Par exemple : https://mail.example.com/WorldClient.dll?View=OIDC
Périmètres
Les périmètres déterminent quels ensembles précis de données l'IdP partage. Les valeurs par défaut sont les valeurs standard d'OIDC : openid active le flux OIDC et est obligatoire, profile fournit des informations de base sur l'utilisateur (par exemple preferred_username) et email partage l'adresse e-mail de l'utilisateur. Vous pouvez ajouter ou modifier des périmètres selon les besoins de votre configuration ou les exigences de votre IdP.
Réclamation par e-mail
Ce champ permet d'indiquer le nom de la revendication (paire clé-valeur) qui contient les données nécessaires pour identifier l'utilisateur MDaemon qui se connecte. Il s'agit le plus souvent, par exemple, de email, preferred_username, sub ou oid (Azure/Entra ID). La configuration la plus simple consiste à indiquer, si possible, une revendication dont vous savez qu'elle contiendra l'adresse e-mail MDaemon de l'utilisateur, comme email ou une revendication personnalisée. Si vous choisissez "sub" ou "oid", cette revendication ne contiendra pas d'adresse e-mail. Elle contiendra à la place un code ou un identifiant unique propre à cet utilisateur, ce qui vous obligera à utiliser les options de la section Réclamations d'e-mail OIDC ci-dessous pour associer cet identifiant sub ou oid au bon utilisateur MDaemon.
|
Lorsque vous indiquez la Réclamation par e-mail, n'utilisez pas une revendication que l'utilisateur peut modifier via une page de profil en libre-service. Par exemple, si la configuration de votre IdP comporte une clé "secondary_email" modifiable par l'utilisateur et que vous l'avez choisie comme Réclamation par e-mail, n'importe quel utilisateur pourrait remplacer cette adresse e-mail par celle d'un autre utilisateur de votre serveur, puis accéder au compte de messagerie de cet utilisateur. Veillez toujours à choisir une revendication que seul un administrateur peut modifier. |
Les options de cette section permettent d'associer des valeurs de revendication personnalisées provenant de l'IdP à des adresses e-mail précises dans MDaemon. Cela est utile lorsque tout ou partie des adresses e-mail contenues dans la revendication email de l'IdP ne correspondent pas aux adresses e-mail de vos utilisateurs MDaemon. Dans ce cas, vous pouvez utiliser ces options pour associer l'adresse e-mail non-MDaemon de chaque utilisateur à son adresse MDaemon. Il en va de même si vous utilisez preferred_username comme Réclamation par e-mail mais que le nom d'utilisateur ne correspond pas toujours à l'adresse e-mail MDaemon. Vous utiliserez également cette fonctionnalité si vous choisissez d'utiliser la revendication sub (ou oid dans Azure/Entra ID) dans votre option Réclamation par e-mail, puis d'associer l'identifiant unique de chaque utilisateur à son compte de messagerie MDaemon.
Pour associer une valeur de revendication à un utilisateur précis :
1.Utilisez la console de votre IdP ou un autre outil pour rechercher l'utilisateur concerné.
2.Repérez la valeur de la revendication que vous avez indiquée ci-dessus comme Réclamation par e-mail.
3.Copiez la valeur de la revendication et collez-la dans le champ Valeur de la réclamation.
4.Dans le champ E-mail, saisissez l'adresse de l'utilisateur MDaemon correspondant.
5.Cliquez sur Ajouter.
6.Cliquez sur Enregistrer.
Pour modifier une entrée :
1.Cliquez sur l'entrée que vous souhaitez modifier.
2.Cliquez sur Modifier.
3.Apportez les modifications souhaitées.
4.Cliquez sur Mettre à jour.
5.Cliquez sur Enregistrer.
Pour supprimer une entrée :
1.Cliquez sur l'entrée que vous souhaitez supprimer.
2.Cliquez sur Supprimer.
3.Cliquez sur Enregistrer.