Paramètres de messagerie

    Aperçu

    L’onglet Mail Settings configure le serveur de messagerie que ManageEngine ADSelfService Plus utilise pour envoyer les codes d’authentification multi-facteurs (MFA), les rapports et les notifications par email. C’est le premier onglet de la page Mail / SMS Server Settings, sous Admin > Product Settings > Mail / SMS Settings, et il s’applique aux modes Active Directory et Microsoft Entra ID. ADSelfService Plus prend en charge deux modes de livraison : SMTP, qui se connecte à votre serveur de messagerie via le protocole SMTP, et API, qui envoie les mails directement via l’API de votre fournisseur. Le serveur de messagerie doit être configuré ici avant que toute notification par email, rapport ou code à usage unique puisse être envoyé.

    Prérequis

    Confirmez les points suivants avant de configurer le serveur de messagerie :

    • Vous êtes connecté au portail administrateur ADSelfService Plus avec des privilèges d’administrateur.
    • Vous avez les détails de votre serveur de messagerie à portée de main : le nom d’hôte ou l’adresse IP, le numéro de port, et les identifiants d’authentification (un nom d’utilisateur et un mot de passe pour Basic Authentication, ou les identifiants OAuth pour OAuth Authentication).
    • Pour OAuth Authentication ou le mode API, ADSelfService Plus fonctionne sur le protocole HTTPS avec un certificat SSL valide, car Microsoft Azure et Google Identity exigent que les URI de redirection non-localhost utilisent HTTPS.

    Comment ça fonctionne

    En mode SMTP, ADSelfService Plus se connecte à votre serveur de messagerie et envoie des emails via le protocole SMTP en utilisant l’une des deux méthodes d’authentification. Basic Authentication utilise un nom d’utilisateur et un mot de passe. OAuth Authentication utilise une authentification par jeton via Microsoft ou Google, sans stockage de mot de passe : ADSelfService Plus obtient un jeton d’accès OAuth depuis Azure AD ou la plateforme Google Identity et l’utilise pour s’authentifier. En mode API, ADSelfService Plus envoie les mails directement via l’API du fournisseur au lieu de SMTP, en utilisant l’API Microsoft Graph (avec un tenant ID, client ID, et client secret) ou l’API Gmail (avec un compte de service Google disposant d’une délégation à l’échelle du domaine et d’une clé privée JSON).

    Instructions de configuration

    Ouverture de l’onglet Mail Settings

    1. Connectez-vous au portail administrateur ADSelfService Plus avec des privilèges d’administrateur.
    2. Naviguez vers Admin > Product Settings > Mail / SMS Settings.
    3. Cliquez sur l’onglet Mail Settings. La section Configure Mail Server apparaît.
    Paramètres de messagerie

    Configuration d’un serveur de messagerie SMTP

    1. À côté de Mode, sélectionnez SMTP.
    2. Dans Server Name or IP, saisissez le nom d’hôte ou l’adresse IP de votre serveur de messagerie.
    3. Dans Port, saisissez le port sur lequel le serveur de messagerie écoute. La valeur par défaut est 25.
    4. Dans From Address, saisissez l’adresse email à partir de laquelle ADSelfService Plus enverra les notifications, rapports et alertes (par exemple noreply@adselfserviceplus.com).
    5. Dans Admin Mail Address, saisissez l’adresse email qui doit recevoir les notifications concernant les mails envoyés par ADSelfService Plus.
    6. Dans la liste déroulante Secure Connection (SSL/TLS), choisissez l’option prise en charge par votre serveur de messagerie : None, SSL, ou TLS.
    7. À côté de Authentication Type, choisissez Basic Authentication ou OAuth Authentication, puis complétez les champs correspondants décrits ci-dessous.
    8. Cliquez sur Enregistrer les paramètres.
    Remarque : Dans le champ Admin Mail Address, vous pouvez saisir plusieurs adresses. L’indication à l’écran indique d’utiliser une virgule (,) pour séparer plusieurs adresses email.
    Remarque : Une fois les paramètres du serveur de messagerie enregistrés avec succès, ADSelfService Plus envoie un email de test à l’adresse indiquée dans le champ Admin Mail Address. Utilisez-le pour confirmer que la configuration fonctionne.

    Authentification de base

    Lorsque Authentication Type est défini sur Basic Authentication :

    1. Dans Username et Password, saisissez les identifiants utilisés pour accéder au serveur de messagerie.
    2. Si votre serveur de messagerie ne nécessite pas d’authentification, laissez les deux champs vides. L’indication à l’écran indique Leave the fields empty if the mail server doesn't require authentication.

    OAuth Authentication

    Lorsque Authentication Type est défini sur OAuth Authentication, sélectionnez votre Mail Provider, puis fournissez les identifiants correspondants :

    • Microsoft : saisissez le Username, Tenant ID, Client ID et Client Secret. ADSelfService Plus considère Azure Cloud (default) comme l’environnement Azure ; pour le modifier, utilisez la liste déroulante Azure Environment, qui propose également Azure China et Azure US Government.
    • Google : saisissez le Username, Client ID et Client Secret.
    Important : OAuth Authentication nécessite qu’ADSelfService Plus fonctionne en HTTPS avec un certificat SSL valide, car Microsoft et Google rejettent les URI de redirection non-localhost qui ne sont pas en HTTPS. Pour obtenir les identifiants Microsoft, enregistrez une application dans le portail Azure sous App registrations et créez un client secret sous Certificates & secrets. Pour obtenir les identifiants Google, créez des identifiants client OAuth dans la console Google API avec l’API Gmail activée.

    Configuration d’un serveur de messagerie via une API

    Utilisez cette méthode pour envoyer les mails directement via l’API de votre fournisseur au lieu de SMTP.

    1. À côté de Mode, sélectionnez API.
    2. Dans Mail Provider, sélectionnez Microsoft ou Google.
    3. Dans From Address, saisissez l’adresse email à partir de laquelle ADSelfService Plus enverra les mails.
    4. Dans Admin Mail Address, saisissez l’adresse email qui doit recevoir les notifications concernant les mails envoyés par ADSelfService Plus.
    5. Si le fournisseur est Microsoft, saisissez le Tenant ID, Client ID et Client Secret. ADSelfService Plus considère Azure Cloud (default) comme l’environnement Azure ; pour le modifier, utilisez la liste déroulante Azure Environment (Azure China ou Azure US Government).
    6. Si le fournisseur est Google, téléversez le fichier de clé privée JSON généré pour votre compte de service Google.
    7. Cliquez sur Enregistrer les paramètres.
    L’onglet Mail Settings de la page Mail / SMS Server Settings, affichant la section Configure Mail Server avec Mode, Nom ou IP du serveur, Port, Adresse d’expéditeur, Adresse mail de l’administrateur, Connexion sécurisée, et la section Authentication.
    Important : Pour l’API Microsoft, accordez à l’application la permission Microsoft Graph Mail et le consentement administrateur avant d’enregistrer. Pour l’API Google, la clé privée JSON ne peut être téléchargée qu’une seule fois, lors de sa création.

    Limitations

    • Pour une configuration API Google, la clé privée JSON ne peut être téléchargée qu’une seule fois, lors de sa création. En cas de perte, vous devez générer une nouvelle clé ; l’original ne peut pas être récupéré.
    • Pour les configurations OAuth et API Microsoft, le client secret a une date d’expiration. Lorsqu’il expire, générez un nouveau client secret et mettez-le à jour dans ADSelfService Plus, sinon la livraison des emails s’arrête.

    Conseils

    • Configurez le serveur de messagerie avant de configurer les notifications par email, les rappels d’expiration ou la vérification d’identité basée sur OTP. Ces fonctionnalités en dépendent et vous inviteront à configurer un serveur de messagerie si celui-ci est manquant.
    • Utilisez l’email de test envoyé à Admin Mail Address lors de l’enregistrement pour confirmer que le serveur, le port et les identifiants sont corrects.
    • Préférez le mode OAuth Authentication ou API plutôt que Basic Authentication lorsque votre fournisseur le supporte, car aucun mot de passe n’est stocké. Les deux nécessitent qu’ADSelfService Plus fonctionne en HTTPS.
    • Suivez la date d’expiration de tout secret client Microsoft et renouvelez-le à l’avance pour éviter une interruption dans la livraison des e-mails.
    • Configurez votre passerelle SMS dans l’onglet SMS Settings et choisissez les événements qui déclenchent des alertes dans l’onglet Notification Settings de la même page.