Configurer le flux d’informations d’identification du client pour SMTP OAuth2 à l’aide d’un ID client et d’un secret

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 2 minutes de lecture
  • Configurez les comptes de messagerie sortants dans une ServiceNow instance à l’aide d’un ID client et d’un secret.

    Avant de commencer

    Créez un compte Microsoft Azure pour configurer un profil OAuth.

    Effectuez les étapes de configuration à l’aide de votre Microsoft Azure compte de développeur. Consultez la documentation du produit Microsoft Azure pour obtenir des instructions sur la création et la configuration d’applications personnalisées.

    Rôle requis : Microsoft Azure administrateur du portail et admin

    Procédure

    1. Connectez-vous au portail d’inscription avec les Microsoft Azure informations d’identification de votre organisation.
      Pour plus d’informations, consultez la Microsoft Azure documentation du portail d’inscription.
    2. Enregistrez une nouvelle application personnalisée en renseignant le nom de l’application, le type de compte pris en charge et l’URL de redirection, puis sélectionnez Enregistrer.
      Remarque :
      Saisissez l’URL de redirection au format suivant : https://<instance>/oauth_redirect.do.
      Une vue d’ensemble des informations de base de l’application s’affiche.
    3. Copiez l’ID client dans un fichier texte.
      Vous utiliserez cet ID client et la valeur de secret client générée au cours des étapes suivantes pour inscrire l’application en tant que fournisseur OAuth tiers sur votre ServiceNow instance. Vous utilisez l’ID d’application comme ID client lorsque vous connectez l’application à votre instance.
    4. Activez le protocole SMTP. Autorisation SendAsApp .
      1. Dans Microsoft Azure, accédez à Gérer > Autorisations d’API.
      2. Sélectionnez Ajouter une autorisation.
      3. Sélectionnez la Microsoft Office 365 vignette.
      4. Sélectionnez Autorisations d’application.
      5. Dans le champ Sélectionner les autorisations , entrez SMTP SendAsApp.
      6. Cochez la case SMTP SendAsApp .
      7. Sélectionnez Ajouter des autorisations.
    5. Sélectionnez Accorder le consentement de l’administrateur pour <nom de votre organisation>, puis sélectionnez Oui pour confirmer.
    6. Ajoutez un secret client.
      1. Dans Microsoft Azure, accédez à Gérer > Certificats et secrets.
      2. Sélectionnez Nouveau secret client.
      3. Fournissez une description et une date d’expiration, puis sélectionnez Ajouter.
    7. Copiez la valeur (valeur secrète) dans un fichier texte.
    8. Enregistrer les principaux de service pour Microsoft Exchange utiliser PowerShell.
      1. Exécutez les commandes suivantes.
        Install-Module -Name ExchangeOnlineManagement -allowprerelease
        Import-module ExchangeOnlineManagement
        Connect-ExchangeOnline -Organization <tenantId>
        Pour plus d’informations, consultez Authentifier une connexion SMTP à l’aide d’OAuth
      2. Enregistrez le principal de service d’une Microsoft Azure AD application en exécutant la commande suivante.
        New-ServicePrincipal -AppId <APPLICATION_ID> -ObjectId <OBJECT_ID>
        Important :
        Pour la valeur OBJECT_ID, accédez à Vue d'ensemble > Applications gérées dans le répertoire local et copiez l’ID de l’objet.
      3. Ajoutez une autorisation à l’ID d’e-mail de l’utilisateur à l’aide de la commande suivante.
        Add-MailboxPermission -Identity "<email_id>" -User <object_id> -AccessRights FullAccess 
        
    9. Accédez à la Vue d'ensemble > Points de terminaison et copiez le point de terminaison de jeton OAuth 2.0 (v2) dans un fichier texte.
      Vous utilisez le point de terminaison de jeton OAuth 2.0 (v2) lors de l’enregistrement d’un fournisseur OAuth. Pour plus d'informations, consultez Enregistrer un fournisseur OAuth.

    Que faire ensuite

    Enregistrer un fournisseur OAuth