Connecter Dynamics 365 Customer Engagement (local) à Exchange Online

Avertissement

Cette configuration utilise le protocole services Web Exchange (EWS) pour communiquer avec Exchange Online, que Microsoft retirera d’Exchange Online en avril 2027. En savoir plus dans Deprecation de services Web Exchange dans Exchange Online.

L’utilisation de cette fonctionnalité nécessite un processus de connexion manuel. À partir du 1er octobre 2025, aucune nouvelle mise à jour n’est disponible, et aucun nouveau locataire ne se connecte à cette fonctionnalité.

Cette intégration sera supprimée au cours des mois suivants :

Dates importantes

May 25, 2026 — Fin du support pour Dynamics CRM Customer Engagement v8.0 (local) avec Exchange Online.
1 octobre 2026 — Échéance recommandée pour migrer vers Dynamics 365 (en ligne), ou ajouter le locataire à la liste d’autorisation avec EWS pour bénéficier du support jusqu’au 1 avril 2027.
April 1, 2027 — Fin du support pour Dynamics CRM Customer Engagement v9.0 (local) avec Exchange Online.

Si vous avez besoin d’une fonctionnalité de synchronisation côté serveur, migrez vers Dynamics 365 (en ligne). Pour en savoir plus, consultez Dynamics CRM (local) pour Dynamics 365 migration et Dynamics CRM (local) pour Dynamics 365 vue d’ensemble du processus de migration en ligne.

Une autre alternative consiste à utiliser les versions locales prises en charge de Exchange Server au lieu de Exchange Online. En savoir plus dans Connecter Customer Engagement (local) à Exchange Server (local).

Apprenez à configurer l’authentification basée sur serveur entre Dynamics 365 Customer Engagement (sur site) et Exchange Online pour permettre la synchronisation côté serveur. Le schéma suivant montre comment Dynamics 365 Customer Engagement (sur site), Azure Active Directory et Exchange Online communiquent.

Capture d’écran d’un diagramme montrant la communication entre Dynamics 365, Azure Active Directory et Exchange Online.

Autorisations requises

Microsoft Dynamics 365

Vous devez être affecté au rôle de sécurité Administrateur système.
Si vous utilisez un certificat auto-signé à des fins d’évaluation, vous devez avoir une adhésion locale au groupe Administrateurs sur l’ordinateur où Microsoft Dynamics 365 serveur fonctionne.
Le compte que vous utilisez pour vous connecter aux serveurs de déploiement CRM doit disposer de tous les droits d’administrateur local.

Échange en ligne

Vous devez être administrateur mondial Office 365. Ce rôle vous donne un accès administratif à l’abonnement Office 365 et vous permet d’exécuter les cmdlets Microsoft AzurePowerShell.

Important

Dans ce déploiement, l’administrateur Dynamics 365 peut approuver les boîtes aux lettres.
Pour configurer votre accès Dynamics 365 Customer Engagement (sur site) à Exchange Online, demandez à l'administrateur Exchange Online de votre locataire de contacter le support Exchange pour activer cet accès à votre ID locataire Exchange Online.

Configurer l’authentification basée sur serveur avec Microsoft Dynamics 365 et Exchange Online

Suivez les étapes de l’ordre fourni pour configurer Dynamics 365 Customer Engagement (localement) avec Exchange Online.

Important

Complétez les étapes décrites ici dans l’ordre fourni. Si une tâche n'est pas terminée, comme une commande PowerShell de Windows qui renvoie un message d'erreur, résolvez le problème avant de passer à la commande, tâche ou étape suivante.

Vérification des conditions préalables requises

Avant de configurer Dynamics 365 Customer Engagement (sur site) et Exchange Online pour l’authentification basée sur serveur, assurez-vous de remplir les conditions suivantes :

Microsoft Dynamics 365 connecteur hybride. Microsoft Dynamics 365 Hybrid Connector est un connecteur gratuit qui vous permet d’utiliser l’authentification basée sur le serveur avec Microsoft Dynamics 365 (on-premises) et Exchange Online. Pour plus d’informations, voir Microsoft Dynamics 365 Connecteur hybride.
Un certificat numérique x509 délivré par une autorité de certification de confiance pour authentifier entre Dynamics 365 Customer Engagement (sur site) et Exchange Online. Le certificat doit comporter une valeur KeySpec de 1. Si vous évaluez l’authentification basée serveur, vous pouvez utiliser un certificat auto-signé.
Tous les serveurs qui exécutent le Service de Traitement Asynchrone possèdent le certificat utilisé pour l’authentification serveur-à-serveur.
Le compte qui exécute le Service de traitement asynchrone a accès à la lecture des clés privées du certificat. Pour plus d’informations, voir Accorder l’accès au compte de lecture du service de traitement asynchrone au certificat.

Configurer l’authentification basée sur un serveur

Préparer le certificat.

Changez le répertoire à l'emplacement du fichier CertificateReconfiguration.ps1 (par défaut c'est C:\Program Files\Microsoft Dynamics CRM\Tools).

$certificateParameters = @{
    CertificateFile = "C:\Personalcertfile.pfx"
    Password = "personal_certfile_password"
    UpdateCrm = $true
    CertificateType = "S2STokenIssuer"
    ServiceAccount = "contoso\CRMAsyncService"
    StoreFindType = "FindBySubjectDistinguishedName"
}

.\CertificateReconfiguration.ps1 @certificateParameters

Configurez une nouvelle application Entra ID pour configurer la synchronisation côté serveur et l’application de gestion de la relation client avec le certificat de l’étape précédente.

Assurez-vous d’ajouter et d’accorder les autorisations d’API suivantes à la nouvelle application :
- Application.ReadWrite.All
- Organization.Read.All
- User.Read
Créez un secret client pour cette nouvelle application et modifiez l’enregistrement de l’application pour créer un secret client.

Remarque

La nouvelle application que vous configurez à l’étape précédente n’est nécessaire que pour la configuration et les nouvelles permissions de l’API. Vous pouvez supprimer l’application une fois toutes les étapes de configuration terminées.

Dans la session PowerShell de l’étape 2, appelez la commande ConfigureCrmServerSideSync.

Téléchargez le script et remplacez le script existant si le scriptConfigureCrmServerSideSync.ps1 présent dans le répertoire de session PowerShell actuel est différent de celui du lien de téléchargement.

$privateKeyPassword = ConvertTo-SecureString `
    "personal_certfile_password" -AsPlainText -Force

$serverSideSyncParameters = @{
    PrivateKeyPassword = $privateKeyPassword
    PfxFilePath = "C:\Personalcertfile.pfx"
    OrganizationName = "organization_name"
    MicrosoftEntraIdTenantIdOrDomainName = "microsoft_entraid_tenantid_or_domain_name"
    ClientID = "app_id_from_step3"
    ClientSecret = "client_secret"
}

.\ConfigureCrmServerSideSync.ps1 @serverSideSyncParameters

Important

Pour les clients utilisant Exchange Online avec Government Community Cloud (GCC) High pour les environnements gouvernementaux américains, changez l’URL S2SDefaultAuthorizationServerMetadataUrl dans le script PowerShell en https://login.microsoftonline.us/metadata/json/1.

Définir l’ID du client Exchange Online

Localisez l’ID du locataire. Mettez à jour la commande PowerShell suivante avec l’ID du locataire et exécutez-la.
```
$CRMContextId = "tenant_id"
$CRMContextId
```
Copiez le GUID qui apparaît sur le clipboard.

Mettez à jour S2STenantId pour l’organisation en exécutant ces commandes. Remplacez-le OrganizationName par le nom unique de l’organisation et ExchangeOnlineTenantId par l’identifiant locataire que vous avez obtenu à l’étape précédente.

$organizationName = "OrganizationName"
$CRMContextId = "ExchangeOnlineTenantId"
$orgInfo = Get-CrmOrganization -Name $organizationName

if ($orgInfo.ID) {
    $advancedSettingParameters = @{
        ID = $orgInfo.ID
        ConfigurationEntityName = "Organization"
        Setting = "S2STenantId"
        Value = $CRMContextId
    }

    Set-CrmAdvancedSetting @advancedSettingParameters
}

Erreur reçue pendant l’activation de l’Assistant d’authentification basé sur un serveur

Erreur : échec de l’authentification. Cette erreur peut survenir lorsque le certificat utilisé pour l’authentification serveur à serveur est manquant ou invalide. Pour résoudre cette erreur, mettez à jour ou installez le certificat et réessayez.

Créer un profil de serveur de messagerie

Accédez à Paramètres>Configuration de la messagerie>Profils du serveur de messagerie.
Sélectionnez Nouveau>Exchange Online (Hybride).

Pour un profil de serveur de messagerie Exchange, spécifiez les détails suivants.

Champs	Descriptif
Nom	Spécifiez un nom explicite pour le profil.
Descriptif	Tapez une description courte de l’objectif du profil de serveur de messagerie.
Type de serveur	Prérempli avec Exchange Online (Hybrid).
Propriétaire	Prérempli avec le nom du propriétaire du profil de serveur de messagerie.
Utiliser l’identifiant de locataire par défaut	Si vous utilisez les commandes PowerShell précédentes pour définir l’ID du locataire Exchange Online (recommandé), sélectionnez Oui pour utiliser cet ID. Si vous définissez ce champ sur Non, vous devez spécifier manuellement l’ID du locataire Exchange Online (ce qui n’est pas recommandé).
ID du locataire Exchange Online	Si vous utilisez les commandes PowerShell précédentes pour définir l’ID du locataire Exchange Online (recommandé), l’ID est prérempli dans ce champ.
Découverte automatique de l’emplacement de serveur	Prérempli avec l’URL Exchange Online. Sélectionnez Oui (recommandé) si vous souhaitez utiliser le service de découverte automatique pour déterminer l’emplacement du serveur. Si vous définissez ce champ sur Non, vous devez spécifier manuellement l’emplacement du serveur de messagerie.
Emplacement de serveur entrant et Emplacement de serveur sortant	Si vous sélectionnez Non dans Découverte automatique de l’emplacement de serveur, entrez une URL pour Emplacement de serveur entrant et Emplacement de serveur sortant.
Paramètres supplémentaires
Traiter le courrier électronique depuis	Sélectionnez une date et une heure. La synchronisation côté serveur traite les e-mails reçus après la date et l’heure pour toutes les boîtes aux lettres associées à ce profil. Si vous définissez une valeur inférieure à la date actuelle, le changement s’applique à toutes les nouvelles boîtes aux lettres associées et leurs e-mails traités précédemment sont retirés.
Intervalle d’interrogation minimal en minutes	Tapez l’intervalle d’interrogation minimal, en minutes, pour les boîtes aux lettres associées à ce profil de serveur de messagerie. L’intervalle d’interrogation détermine la fréquence à laquelle la synchronisation côté serveur interroge vos boîtes aux lettres pour rechercher de nouveaux e-mails.
Déplacer les e-mails en échec vers le dossier Non distribuables	Pour déplacer l’e-mail non livré dans le dossier Non livrable , sélectionnez Oui. S'il y a une erreur dans le suivi des messages email dans Dynamics 365 en tant qu'activités email, et si cette option est définie sur Oui, le message est déplacé dans le dossier Undeliverable.

Sélectionnez Enregistrer.
Sélectionnez Tester la connexion et analysez les résultats. Pour diagnostiquer les problèmes, voir la section suivante.

Résoudre les problèmes de connexion du profil Exchange Online (Hybride)

Si vous lancez Test Connection et rencontrez des problèmes avec la connexion du profil Exchange Online (Hybrid), utilisez les informations dans la boîte de dialogue Test Connection pour diagnostiquer et corriger la connexion.

Vous pouvez obtenir des informations sur les problèmes récurrents et d’autres informations de dépannage dans Blog : Test et activation de boîtes aux lettres dans Microsoft Dynamics CRM 2015 et Résolution des problèmes et contrôle de la synchronisation côté serveur.

Configurer le traitement par défaut et la synchronisation de messagerie

Définissez la synchronisation côté serveur comme méthode de configuration par défaut.

Accédez à Paramètres>Configuration de la messagerie>Paramètres de configuration de la messagerie.
Définissez les champs de traitement et de synchronisation comme suit :
- Profil serveur : Le profil que vous avez créé dans la section précédente.
- Courrier électronique entrant : synchronisation côté serveur ou E-mail Router
- Courrier électronique sortant : synchronisation côté serveur ou E-mail Router
- Rendez-vous, Contacts et Tâches : Synchronisation côté serveur ou E-mail Router
Remarque

Si vos utilisateurs utilisent Dynamics 365 for Outlook principalement sur leurs ordinateurs de bureau, Microsoft Dynamics 365 for Outlook pourrait être un meilleur choix.

Si vous laissez le formulaire de traitement des e-mails non approuvé utilisateur et les files d’attente aux valeurs par défaut (sélectionnées), vous devez approuver les e-mails et les files d’attente pour les boîtes aux lettres utilisateur comme indiqué dans la section suivante, Approuver l’email.
Cliquez sur OK.

Configurer des boîtes aux lettres

Pour configurer les boîtes aux lettres pour utiliser le profil par défaut, configurez d’abord le profil serveur et la méthode de livraison pour les emails, rendez-vous, contacts et tâches.

En plus des permissions administrateur, vous avez besoin des privilèges de lecture et d’écriture sur l’entité Boîte aux lettres pour définir la méthode de livraison de la boîte aux lettres.

Sélectionnez l’une des méthodes suivantes :

Capture d’écran des options pour appliquer les paramètres de messagerie par défaut à des boîtes aux lettres sélectionnées.

Modifier les boîtes aux lettres pour définir le profil et les modes de livraison

Accédez à Paramètres>Configuration de la messagerie>Boîtes aux lettres.
Sélectionnez Boîtes aux lettres actives.
Sélectionnez les boîtes aux lettres à configurer, puis sélectionnez Modifier.
Dans le formulaire Modifier plusieurs enregistrements, sous Méthode de synchronisation, définissez Profil de serveur sur le profil Exchange Server créé précédemment.
Définissez Courrier électronique entrant et sortant sur Synchronisation côté serveur ou E-mail Router.
Définissez Rendez-vous, Contacts et Tâches sur Synchronisation côté serveur.

Remarque

Si vos utilisateurs utilisent Dynamics 365 for Outlook principalement sur leurs ordinateurs de bureau, Microsoft Dynamics 365 for Outlook pourrait être un meilleur choix.
Sélectionnez Modifier.

Approuver l’adresse de messagerie

Vous devez approuver chaque boîte aux lettres d’utilisateur ou file d’attente avant que la boîte aux lettres puisse traiter du courrier électronique.

Accédez à Paramètres>Configuration de la messagerie>Boîtes aux lettres.
Sélectionnez Boîtes aux lettres actives.
Sélectionnez les boîtes aux lettres à approuver, puis sélectionnez Plus de commandes (...)>Approuver l’adresse de messagerie.
Cliquez sur OK.

Tester la configuration des boîtes aux lettres

Accédez à Paramètres>Configuration de la messagerie>Boîtes aux lettres.
Sélectionnez Boîtes aux lettres actives.
Sélectionnez les boîtes aux lettres que vous voulez tester, puis sélectionnez Tester & activer les boîtes aux lettres.

Cette action teste la configuration des emails entrants et sortants des boîtes aux lettres sélectionnées et les permet de traiter les e-mails. Si une erreur survient dans une boîte aux lettres, une alerte apparaît sur le mur Alertes de la boîte aux lettres et sur le propriétaire du profil. Selon la nature de l’erreur, Microsoft Dynamics 365 essaie de traiter le message à nouveau après un moment, ou désactive la boîte aux lettres pour le traitement du courrier électronique.

Le résultat du test de configuration des emails apparaît dans les champs État de l’email entrant, État de l’email sortant et Rendez-vous, Contacts et statut des tâches d’un enregistrement de boîte aux lettres. Une alerte est également générée lorsque la configuration se termine correctement pour une boîte aux lettres. Cette alerte apparaît sur l’écran du propriétaire de la boîte aux lettres.

Astuce

Si vous ne pouvez pas synchroniser les contacts, rendez-vous et tâches pour une boîte aux lettres, envisagez de sélectionner les éléments Synchroniser avec Exchange uniquement depuis cette organisation Dynamics 365, même si Exchange était configuré pour synchroniser avec une autre case d'organisation. En savoir plus sur cette case à cocher.

Test de la configuration de la messagerie pour toutes les boîtes aux lettres associées à un profil de serveur de messagerie

Accédez à Paramètres>Configuration de la messagerie>Profils du serveur de messagerie.
Sélectionnez le profil que vous avez créé, puis sélectionnez Tester & activer les boîtes aux lettres.

Lorsque vous testez la configuration de messagerie, une tâche asynchrone s’exécute en arrière-plan. La fin du test peut prendre quelques minutes. Microsoft Dynamics 365 teste la configuration de la messagerie pour toutes les boîtes aux lettres associées au profil Exchange Server. Pour les boîtes aux lettres que vous configurez avec une synchronisation côté serveur pour synchroniser les rendez-vous, tâches et contacts, elle vérifie aussi qu’elles sont bien configurées.