Zum Inhalt springen

Microsoft Dynamics CRM Verbindungshandbuch für Jitterbit App Builder

Übersicht

Diese Anleitung beschreibt die Systemanforderungen und Anweisungen zum Anschließen App Builder zu Microsoft Dynamics CRM.

Systemanforderungen

Aktives Konto

  • Microsoft Dynamics CRM

Client-Webbrowser

Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

Kante: 84+

Anschlussanleitung

Voraussetzungen

Bevor Sie eine Verbindung einrichten von App Builder zum Microsoft Dynamics CRM sollten Sie die folgenden Schritte durchführen:

  • Stellen Sie sicher, dass Sie über ein aktives Dynamics CRM -Konto verfügen

  • Überprüfen Sie, ob Sie sich bei einem aktiven Azure-Konto mit der Berechtigung zum Konfigurieren von Verbindungen anmelden können.

Registrieren einer App in Microsoft Azure

Die Methode zur Authentifizierung von App Builder zu Dynamics CRM ist OAuth 2.0. Wir werden den OAuth-Flow mit Microsoft Azure konfigurieren.

  1. Navigieren Sie zum Microsoft Entra ID Admin Center-Portal

  2. Wählen Sie unter Verwalten App-Registrierungen > Neue Registrierung

  3. Geben Sie einen Namen ein. Beispiel: App Builder Dynamics CRM

  4. Wählen Sie aus, wer die Anwendung verwenden kann

  5. Klicken Sie auf Registrieren

Wenn die Registrierung abgeschlossen ist, zeigt das Azure Portal die App-Registrierung auf dem Übersichtsbildschirm an. Beachten Sie den Wert in Anwendungs-ID (Client) als OAuthClientID und die Verzeichnis-ID (Mandant) als AzureTenantID.

Hinzufügen einer Umleitungs-URI

Die Umleitungs URL stellt den Ort dar, an den Microsoft den Client des Benutzers umleitet und weiterleitet

die Sicherheitstoken nach der Authentifizierung.

  1. Navigieren Sie zur registrierten App in Microsoft Entra ID

  2. Klicken Sie auf Umleitungs-URI hinzufügen, um den Wert einzugeben. Beispiel: http://localhost/auth-response

Hinzufügen eines Client-Geheimnisses

Client-Geheimnisse werden auch als Anwendungskennwort bezeichnet. Die registrierte App in Microsoft Azure erfordert die Erstellung eines Client-Geheimnis-Datensatzes für jede App Builder Umfeld, in der die Verbindung verwendet wird. Wenn Ihre App Builder Wenn die Konfiguration über eine Entwicklungs-, Qualitätssicherungs- und Umfeld verfügt, benötigen Sie drei entsprechende Client-Geheimdatensätze.

Mit den Client-Geheimnissen ist ein Ablaufdatum verknüpft und ihre maximale Gültigkeitsdauer beträgt zwei Jahre.

Durch das Generieren eines Client-Geheimnisdatensatzes erhalten Sie einen Client-Geheimnis-Wert und eine Geheim-ID. Der Wert ist codiert und kann nur einmal kopiert und verwendet werden (ansonsten müsste ein neues Token generiert werden, um einen neuen Wert zu erfassen).

  1. Navigieren Sie zur registrierten App in Microsoft Entra ID

  2. Wählen Sie unter Verwalten Zertifikate und Geheimnisse

  3. Klicken Sie auf Neues Client-Geheimnis

  4. Geben Sie eine Beschreibung ein. Beispiel: App Builder Produktion

  5. Wählen Sie einen Ablauf-Wert. Beispiel: 730 Tage (24 Monate)

  6. Klicken Sie auf Hinzufügen

  7. Notieren Sie den Wert, da er verschlüsselt wird. Sie benötigen ihn als OAuthClientSecret

API Berechtigungen zuweisen

Die registrierte App in Microsoft Azure benötigt Berechtigungen, die Dynamics CRM zugewiesen sind. Dies sollte basierend darauf konfiguriert werden, wie Sie es integrieren möchten mit App Builder.

  1. Navigieren Sie zur registrierten App in Microsoft Entra ID

  2. Wählen Sie unter Verwalten API Berechtigungen

  3. Klicken Sie auf Berechtigung hinzufügen

  4. Klicken Sie auf Dynamics ERP

  5. Wenn Sie planen, dass Ihre Anwendung eine Verbindung ohne Benutzerkontext herstellt, wählen Sie Anwendungsberechtigungen (OAuthGrantType=Client). Andernfalls verwenden Sie Delegierte Berechtigungen (OAuthGrantType=Code).

  6. Klicken Sie auf Berechtigung hinzufügen und definieren Sie Berechtigungen entsprechend Ihren Geschäftsanforderungen

Weitere Einzelheiten finden Sie unter Schnellstart: Registrieren einer Anwendung bei der Microsoft Identity Platform

Für diesen Konfigurationsschritt sollten Sie den Wert der Anwendungs-(Client-)ID für die oben registrierte App an einen leicht zu verwendenden Ort kopieren, beispielsweise in Ihre Zwischenablage.

  1. Navigieren Sie zu Dynamics CRM

  2. Erstellen Sie einen Anwendungsbenutzer

  3. Geben Sie den Client-ID-Wert aus der registrierten App ein. Dies ist der Anwendungs-(Client-)ID-Wert in Microsoft Azure.

  4. Weisen Sie dem neuen Benutzer eine Rolle zu

Hinzufügen eines Servers

  1. Navigieren Sie zu App Builder IDE

  2. Klicken Sie im Menü Verbinden auf die Schaltfläche Datenserver

  3. Klicken Sie im Bereich „Datenserver“ auf die Schaltfläche + Server. Dadurch wird die Serverseite angezeigt. Geben Sie die folgenden Informationen ein:

    • Servername: Ein identifizierbarer und eindeutiger Servername. Beispiel: Dynamics CRM

    • Typ: Wählen Sie Dynamics CRM aus dem Dropdown-Menü

    • Url: Geben Sie die URL für den Zugriff auf Dynamics CRM ein, muss mit http:// oder https:// beginnen.

  4. Klicken Sie auf die Schaltfläche Speichern

    Anhang

  5. Klicken Sie auf die Schaltfläche Erweiterte Einstellungen.

  6. Geben Sie im Feld „Erweitert“ die folgenden Informationen und die entsprechenden Werte ein und trennen Sie die einzelnen Werte durch ein Semikolon:

    1. AzureTenant - Mandanten-ID-Wert für Azure-Dienst

    2. InitiateOAuth - Eigenschaft zum Initiieren des Prozesses zum Abrufen/Aktualisieren des OAuth-Zugriffstokens bei Verbindung. Beispiel: GETANDREFRESH

    3. OAuthClientID - ID-Wert, der zugewiesen wird, wenn die App beim OAuth-Server registriert ist

    4. OAuthClientSecret - Wert, der zugewiesen wird, wenn die App beim OAuth-Server registriert ist

    5. OAuthGrantType - Berechtigungstyp für den OAuth-Flow. Beispiel: CLIENT

    6. OAuthSettingsLocation - Speicherort der Einstellungsdatei, in der OAuth-Werte gespeichert werden. Beispiel: C:\inetpub\wwwroot\App Builder\App_Data\CData\DynamicsCRM;

Beispiel für erweiterte Einstellungen:

AzureTenant=<TenantID>;
InitiateOAuth=GETANDREFRESH;
OAuthClientId=<ClientID>;
OAuthClientSecret=<ClientSecret>;
OAuthGrantType=CLIENT;
OAuthSettingsLocation=C:\inetpub\wwwroot\App Builder\App_Data\CData\DynamicsCRM;