Verbinden von Customer Engagement (on-premises) mit Exchange Online

In diesem Artikel wird beschrieben, wie die serverbasierte Authentifizierung zwischen Dynamics 365 (on-premises) und Exchange Online konfiguriert wird. Im folgenden Diagramm wird die Kommunikation zwischen Dynamics 365 (on-premises), Azure Active Directory und Exchange Online dargestellt.

Berechtigungen sind erforderlich

Microsoft Dynamics 365

• Sicherheitsrolle des Systemadministrators
• Wenn Sie ein selbstsigniertes Zertifikat für Evaluierungszwecke verwenden, müssen Sie Mitglieder der lokalen Administrierendengruppe auf dem Computer sein, auf dem Microsoft Dynamics 365 Server ausgeführt wird.
• Das Konto, mit dem Sie sich bei den CRM-Bereitstellungsservern anmelden, muss über volle lokale Administratorrechte verfügen.

Exchange Online

• Office 365-Mitgliedschaft der globalen Administratoren. Dies ist erforderlich für den Zugriff auf das Office 365-Abonnement auf Administratorebene und für die Ausführung der Microsoft AzurePowerShell-Cmdlets.

Einrichten der serverbasierten Authentifizierung mit Microsoft Dynamics 365 und Exchange Online

Führen Sie die Schritte in der vorgesehenen Reihenfolge aus, um Dynamics 365 (on-premises) mit Exchange Online zu installieren.

Überprüfen der Voraussetzungen

Bevor Sie Dynamics 365 (on-premises) und Exchange Online für serverbasierte Authentifizierung konfigurieren, müssen die folgenden Voraussetzungen erfüllt sein:

• Microsoft Dynamics 365 Hybrid Connector. Die Microsoft Dynamics 365 Hybrid Connector ist ein kostenloser Konnektor, mit dem Sie die serverbasierte Authentifizierung mit Microsoft Dynamics 365 (on-premises) und Exchange Online verwenden können. Weitere Informationen: Microsoft Dynamics 365 Hybrid Connector
• Ein von einer vertrauenwürdigen Zertifizierungsautorität ausgebenes x509-Zertifikat, das für Authentifizierung zwischen Dynamics 365 (on-premises) und Exchange Online verwendet wird. Das Zertifikat sollte einen KeySpec-Wert von 1 haben. Wenn Sie die serverbasierte Authentifizierung evaluieren, können Sie ein selbstsigniertes Zertifikat verwenden.
• Stellen Sie sicher, dass alle Server, auf denen der Asynchronous Processing Service läuft, über das Zertifikat verfügen, das für die Server-zu-Server-Authentifizierung verwendet wird.
• Stellen Sie sicher, dass das Konto, das den asynchronen Verarbeitungsdienst ausführt, Lesezugriff auf private Schlüssel des Zertifikats hat. Mehr Informationen: Gewähren Sie dem asynchronen Prozessservice-Servicekonto Lesezugriff, um auf das Zertifikat zuzugreifen

Serverasierte Authentifizierung konfigurieren

1. Auf dem Microsoft Dynamics 365 Server, auf dem die Serverrolle für Bereitstellungstools ausgeführt wird, starten Sie das Azure Active Directory-Modul für Windows PowerShell.

2. Bereiten Sie das Zertifikat vor.

   Ändern Sie das Verzeichnis in das Verzeichnis der Datei CertificateReconfiguration.ps1 (standardmäßig C:\Program Files\Microsoft Dynamics CRM\Tools).

$CertificateScriptWithCommand = ".\CertificateReconfiguration.ps1 -certificateFile c:\Personalcertfile.pfx -password personal_certfile_password -updateCrm -certificateType S2STokenIssuer -serviceAccount contoso\CRMAsyncService -storeFindType FindBySubjectDistinguishedName"
Invoke-Expression -command $CertificateScriptWithCommand

3. Bereiten Sie die Windows PowerShell Sitzung vor.

   Die folgenden Cmdlets ermöglichen dem Computer, Remote-Befehle zu empfangen und Office 365-Module zur Windows PowerShell-Sitzung hinzuzufügen. Weitere Informationen zu diesen Cmdlets finden Sie unter Windows PowerShell-Kern-Cmdlets.

Enable-PSRemoting -force
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Install-Module MSOnline
Install-Module MSOnlineExt
Import-Module MSOnline -force
Import-Module MSOnlineExt -force

4. Stellen Sie mit Office 365 eine Verbindung her.

   Wenn Sie den Connect-MsolService-Befehl ausführen, müssen Sie ein gültiges Microsoft-Konto, das die Office 365-Mitgliedschaft der globalen Administratoren für die erforderliche Exchange Online-Lizenz umfasst. Ausführliche Informationen zu jedem der hier aufgeführten Azure Active Directory PowerShell-Befehle finden Sie unter MSDN: Verwalten von Azure AD mithilfe von Windows PowerShell.

$msolcred = get-credential
connect-msolservice -credential $msolcred

5. Legen Sie das Zertifikat fest.

$Certificate = New-Object System.Security.Cryptography.X509Certificates.X509Certificate2
$Certificate.Import("c:\Personalcertfile.cer")
$CERCertificateBin = $Certificate.GetRawCertData()
$CredentialValue = [System.Convert]::ToBase64String($CERCertificateBin)

6. Legen Sie den Azure Active Directory Dienstprinzipalnamen (Service Principal Name, SPN) in Exchange Online fest.

   Ersetzen Sie *.contoso.com durch den Namen der Domäne, in der sich Microsoft Dynamics 365 Server befindet.

$RootDomain = "*.contoso.com"
$CRMAppId = "00000007-0000-0000-c000-000000000000" 
New-MsolServicePrincipalCredential -AppPrincipalId $CRMAppId -Type asymmetric -Usage Verify -Value $CredentialValue
$CRM = Get-MsolServicePrincipal -AppPrincipalId $CRMAppId
$ServicePrincipalName = $CRM.ServicePrincipalNames
$ServicePrincipalName.Remove("$CRMAppId/$RootDomain")
$ServicePrincipalName.Add("$CRMAppId/$RootDomain")
Set-MsolServicePrincipal -AppPrincipalId $CRMAppId -ServicePrincipalNames $ServicePrincipalName

7. Konfigurieren von Microsoft Dynamics 365 Server für die serverbasierte Authentifizierung mit Exchange.

Add-PSSnapin Microsoft.Crm.PowerShell 
$setting = New-Object "Microsoft.Xrm.Sdk.Deployment.ConfigurationEntity"
$setting.LogicalName = "ServerSettings"
$setting.Attributes = New-Object "Microsoft.Xrm.Sdk.Deployment.AttributeCollection"
$attribute1 = New-Object "System.Collections.Generic.KeyValuePair[String, Object]" ("S2SDefaultAuthorizationServerPrincipalId", "00000001-0000-0000-c000-000000000000")
$setting.Attributes.Add($attribute1)
$attribute2 = New-Object "System.Collections.Generic.KeyValuePair[String, Object]" ("S2SDefaultAuthorizationServerMetadataUrl", "https://accounts.accesscontrol.windows.net/metadata/json/1")
$setting.Attributes.Add($attribute2)
Set-CrmAdvancedSetting -Entity $setting

Legen Sie die Exchange Online-Mandanten-ID fest

1. Führen Sie im Azure Active Directory-Modul für die Windows PowerShell-Shell, die folgenden Befehle aus.

$CRMContextId = (Get-MsolCompanyInformation).ObjectID
$CRMContextId

2. Kopieren Sie die GUID, die in der Zwischenablage angezeigt wird.

3. Aktualisieren Sie S2STenantId für die Organisation, indem Sie diese Befehle ausführen, bei denen der OrganisationName der eindeutige Name der Organisation und ExchangeOnlineTenantId die TenantId des zuvor abgerufenen Schritts ist.

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

    if($ID)
        {
          Set-CrmAdvancedSetting -ID $orgInfo.ID -configurationEntityName "Organization" -setting "S2STenantId" -value $CRMContextId
        }

Aufgetretener Fehler während der Aktivierung des serverbasierten Authentifizierungsassistenten

Fehler: Authentifizierungsfehler. Dieser Fehler kann zurückgegeben werden, wenn das Zertifikat, das für die Server-zu-Server-Authentifizierung verwendet worden ist, fehlt oder ungültig ist. Zum Auflösen aktualisieren oder installieren Sie das Zertifikat und versuchen Sie es erneut.

Erstellen eines E-Mail-Serverprofils

1. Gehen Sie zu Einstellungen>E-Mail-Konfiguration>E-Mail-Serverprofile.
2. Wählen Sie Neu>Exchange Online (Hybrid) aus.
3. Für ein Exchange-E-Mail-Serverprofil geben Sie die folgenden Details an.

4. Wählen Sie Speichern aus.
5. Wählen Sie Verbindung testen und überprüfen Sie die Ergebnisse. Um Problem ezu diagnostizieren lesen Sie den folgenden Abschnitt.

Problembehandlung der Profil-Verbindung für Exchange Online (Hybrid)

Wenn Sie Verbindung testen ausgeführt haben und Probleme mit der Profil-Verbindung für Exchange Online (hybrid) haben, verwenden Sie die Informationen im Dialogfeld Verbindung testen, um die Verbindung zu diagnostizieren und zu beheben.

Sie können Informationen über periodisch wiederkehrende Probleme und weitere Informationen zur Problembehandlung in Blog: Postfächer in Microsoft Dynamics CRM 2015 testen und Problembehandlung und Überwachung der serverseitigen Synchronisierung finden.

Konfigurieren der standardmäßigen E-Mail-Verarbeitung und -Synchronisierung

Legen Sie die serverseitige Synchronisierung als Standardkonfigurationsmethode fest.

1. Gehen Sie zu Einstellungen>E-Mail-Konfiguration>E-Mail-Konfigurationseinstellungen.
2. Legen Sie die Verarbeitungs- und Synchronisierungsfelder wie folgt fest:

• Serverprofil: Das Profil, das Sie im obigen Abschnitt erstellten.
• Eingehende E-Mail: Serverseitige Synchronisierung oder E-Mail-Router
• Ausgehende E-Mail: Serverseitige Synchronisierung oder E-Mail-Router
• Termine, Kontakte und Aufgaben: Serverseitige Synchronisierung oder E-Mail-Router

Wenn Sie für die Option E-Mail-Verarbeitung für nicht genehmigte Benutzende und Warteschlangen den Standardwert (ausgewählt) beibehalten, müssen Sie E-Mails und Warteschlangen für Benutzerpostfächer genehmigen, wie unten unter E-Mail genehmigen beschrieben.

3. Klicken Sie auf OK.

Postfächer konfigurieren

Um Postfächer zur Nutzung des Standardprofils einzurichten, müssen Sie zuerst das Server-Profil und die Zustellungsmethode für E-Mails, Termine, Kontakte und Aufgaben festlegen.

Zusätzlich zu Administratorberechtigungen müssen Sie auch über Lese- und Schreibberechtigungen für die Postfachentität verfügen, um die Zustellungsmethode für das Postfach einrichten zu können.

Wählen Sie eine der folgenden Methoden aus:

Bearbeiten von Postfächern, um das Profil und die Zustellungsmethoden festzulegen

1. Gehen Sie zu Einstellungen>E-Mail-Konfiguration>Postfächer.
2. Wählen Sie Aktive Postfächer
3. Wählen Sie die zu konfigurierenden Postfächer aus, und wählen Sie Bearbeiten.
4. Legen Sie im Formular Mehrere Datensätze ändern unter Synchronisierungsmethode das Serverprofil auf das Exchange Server Profil fest, dass Sie zuvor erstellt haben.
5. Legen Sie Eingehende und Ausgehende E-Mails auf Serverseitige Synchronisierung oder E-Mail-Router fest.
6. Legen Sie für Termine, Kontakte und Aufgaben die serverseitige Synchronisierung fest.

7. Wählen Sie Ändern aus.

E-Mail genehmigen

Sie müssen jedes Benutzerpostfach oder jede Warteschlange genehmigen, bevor das Postfach E-Mails bearbeiten kann.

1. Gehen Sie zu Einstellungen>E-Mail-Konfiguration>Postfächer.
2. Wählen Sie Aktive Postfächer
3. Wählen Sie die Postfächer aus, die Sie genehmigen möchten, und wählen Sie dann Weitere Befehle(…)>E-Mail genehmigen aus.
4. Wählen Sie OK aus.

Testen der Konfiguration von Postfächern

1. Gehen Sie zu Einstellungen>E-Mail-Konfiguration>Postfächer.
2. Wählen Sie Aktive Postfächer
3. Wählen Sie die Postfächer, die Sie testen möchten, und wählen Sie dann Postfächer testen und aktivieren.

Dadurch wird die ein- und ausgehende E-Mail-Konfiguration der ausgewählten Postfächer getestet, und diese werden für die E-Mail-Verarbeitung aktiviert. Wenn ein Fehler in einem Postfach auftritt, wird eine Warnung auf der Warnungspinnwand des Postfachs und des Profilbesitzers angezeigt. Je nach Typ des Fehlers versucht Microsoft Dynamics 365, die E-Mail nach einiger Zeit erneut zu verarbeiten oder deaktiviert das Postfach für E-Mail-Verarbeitung.

Das Ergebnis des E-Mail-Konfigurationstests wird in den Feldern Eingehender E-Mailstatus, Ausgehender E-Mailstatus und Status von Terminen, Kontakten und Aufgaben eines Postfachdatensatzes angezeigt. Eine Warnmeldung wird auch generiert, wenn die Konfiguration für einPostfachs erfolgreich abgeschlossen wird. Diese Warnung wird dem Postfachbesitzer angezeigt.

Testen Sie die E-Mail-Konfiguration für alle Postfächer, die diesem E-Mail-Serverprofil zugeordnet sind.

1. Gehen Sie zu Einstellungen>E-Mail-Konfiguration>E-Mail-Serverprofile.
2. Wählen Sie das erstellte Profil aus, und wählen Sie dann Postfächer testen und aktivieren.

Wenn Sie die E-Mail-Konfiguration testen, wird ein asynchroner Auftrag im Hintergrund ausgeführt. Es kann einige Minuten in Anspruch nehmen, bis der Test abgeschlossen wurde. Microsoft Dynamics 365 testet die E-Mail-Konfiguration für alle Postfächer, die dem Exchange Serverprofil zugeordnet sind. Für die Postfächer, die mit serverseitiger Synchronisierung für Aufgaben, Termine und Kontakte konfiguriert sind, wird auch geprüft, ob diese korrekt konfiguriert sind,.

Gewähren Sie dem asynchronen Prozessservice-Servicekonto Lesezugriff auf das Zertifikat

Dieser Ablauf erklärt, wie dem asynchronen Verarbeitungsdienst-Service-Konto Lesezugriff auf private Schlüssel des Zertifikats gewährt wird.

1. Geben Sie auf dem Computer, auf dem sich das Zertifikat befindet, in das Suchfeld mmc.exe ein und drücken Sie dann die Eingabetaste.
2. Wählen Sie in der Microsoft Management Console Datei, und wählen Sie dann Andocken hinzufügen/entfernen aus.
3. Wählen Sie Zertifikate und wählen Sie Hinzufügen und Computerkonto und wählen Sie Weiter und dann lokaler Computer und Beenden aus.
4. Wählen Sie OK aus, um das Dialogfeld Andocken hinzuzufügen oder zu entfernen.
5. Erweitern Sie Zertifikate - (Lokaler Computer) und erweitern Sie Persönlich und klicken Sie dann auf Zertifikate.
6. Klicken Sie mit der rechten Maustaste auf das Zertifikat, mit dem Sie sich mit Exchange Online authentifizieren und wählen Sie dann Alle Aufgaben>Private Schlüssel verwalten.
7. Wählen Sie Hinzufügen und suchen und wählen Sie das Dienstkonto, unter dem der asynchrone Verarbeitungsdienst ausgeführt wird, und wählen Sie die Lesen zulassen Berechtigung, und wählen Sie dann OK aus.
8. Starten Sie den Microsoft Dynamics CRM asynchronen Verarbeitungsdienst und wählen dann Microsoft Dynamics CRM asynchrone Verarbeitungsdienst (Wartung) Services aus.

Siehe auch

Serverseitige Synchronisierung
Problembehandlung und Überwachung der serverseitigen Synchronisierung