Microsoft Dynamics 365 CRM-Authentifizierung

Der UiPath Integration Service ermöglicht die sichere Konnektivität zu Ihrer Microsoft Dynamics 365 CRM-Instanz mithilfe der OAuth 2.0-basierten Authentifizierung. Nach der Authentifizierung können Sie eine Verbindung erstellen, die den Zugriff auf API-Ebene auf Dynamics 365 CRM-Daten für Automatisierungsworkflows ermöglicht.

Durch Hinzufügen einer Verbindung zu Microsoft Dynamics 365 CRM können UiPath-Produkte mit Ihren CRM-Daten interagieren – einschließlich Lesen, Schreiben, Ändern und Löschen von Datensätzen, je nach den Berechtigungen des authentifizierten Benutzers in Dynamics 365 CRM.

Unterstützte Authentifizierungstypen

Beim Erstellen einer Dynamics 365 CRM-Verbindung können Sie zwischen zwei Authentifizierungstypen wählen:

• OAuth 2.0: Autorisierungscode (Standard und empfohlen)
• Mitbringen Ihrer eigenen OAuth 2.0-App (benutzerdefinierte App-Registrierung)

OAuth 2.0-Autorisierungscode

Dies ist die einfachste Authentifizierungsmethode. Diese Option verwendet die von UiPath verwaltete Azure AD-Anwendung, um die Benutzeranmeldung und den Tokenerfassung zu verwalten.

1. Wählen Sie auf dem Bildschirm zur Verbindungserstellung den OAuth 2.0 Autorisierungscode aus.

2. Mandanten-URL eingeben (https://<yourorg>.crm.dynamics.com)

   Hinweis:

   Der Wert der Mandanten-URL muss genau Ihre Dynamics 365 CRM-Basisdomäne sein.

3. Klicken Sie auf Verbinden (Connect).

4. Sie werden zu den Anmelde- und Zustimmungsbildschirmen von Microsoft umgeleitet, um sich zu authentifizieren.

   Diese Methode erfordert keine zusätzliche Einrichtung in Azure AD und ist für die meisten Benutzer geeignet.

Bringen Sie Ihre eigene OAuth 2.0-App mit

Verwenden Sie diese Option, wenn Ihre Organisation eine zentrale Kontrolle über Azure AD-App-Registrierungen, -Scopes oder -Compliancerichtlinien benötigt.

Wenn Sie Eigene OAuth 2.0-App mitbringen auf dem Verbindungsbildschirm auswählen, müssen Sie die folgenden Details angeben:

• Client-ID
• Geheimer Clientschlüssel
• Mandanten-URL

Wichtig:

Der Rückruf-/Umleitungs-URI https://{baseURL}/provisioning_/callback (z. B. https://cloud.uipath.com/provisioning_/callback) muss genau so wie auf dem Verbindungsbildschirm angezeigt zu Ihren Azure AD-App-Registrierungseinstellungen unter Umleitungs-URIs mit dem Webtyp hinzugefügt werden.

Diese Rückruf-URL wird von UiPath vorkonfiguriert und kann nicht auf der Integration Service-Benutzeroberfläche geändert werden.

Verwendung einer benutzerdefinierten App

Verwenden Sie diese Option, wenn:

• Ihre Organisation erfordert vom Administrator verwaltete Azure AD App-Registrierungen.
• Sie möchten eine detaillierte Kontrolle über App-Berechtigungen und -Scopes.
• Sie müssen interne Sicherheitsrichtlinien für OAuth-Anwendungen befolgen.

Hinweis:

• Die Administratorzustimmung kann in Ihrem Mandanten für die von Ihnen angeforderten App-Berechtigungen erforderlich sein.
• Die benutzerdefinierte App muss mit delegierten Berechtigungen für Dynamics CRM konfiguriert werden.

Erläuterung der Pflichtfelder

Feld	Beschreibung
Client-ID	Die Azure AD-Anwendungs-ID (nur erforderlich, wenn Sie Ihre eigene App verwenden).
Geheimer Clientschlüssel	Das Geheimnis, das Sie für Ihre Azure AD-App generiert haben (erforderlich für benutzerdefinierte App).
Mandanten-URL	Ihre Dynamics 365 CRM-Instanz-URL (für beide Optionen).
Rückruf-URL	Vorab ausgefüllter Wert, der bei Verwendung einer benutzerdefinierten App angezeigt wird; müssen Sie diese URL in Azure AD registrieren.

Abrufen Ihrer Anmeldeinformationen

Um Ihre Mandanten-URL zu finden, wenden Sie sich an Ihren Microsoft Dynamics-Administrator.

Falls Sie Zugriff haben und einen einzigen globalen Mandanten verwenden, führen Sie die folgenden Schritte aus:

1. Wechseln Sie zu https://portal.azure.com.

2. Wählen Sie Azure Active Directory aus.

3. Wechseln Sie im Abschnitt Verwalten zu Eigenschaften .

4. Ihr Mandant ist die Mandanten-ID, zum Beispiel: sample083151e4.api.crm10.dynamics.com.

   Hinweis:

   Any mistake in the Tenant URL prevents you from authenticating and creating a connection.

Wenn Sie Ihre eigene private OAuth 2.0-Anwendung erstellen möchten, führen Sie die in der Dokumentation zu Microsoft Dynamics 365 beschriebenen Schritte aus:

• Schnellstart: Registrieren einer Anwendung bei der Microsoft Identity-Plattform
• Tutorial: Registrieren einer App mit Microsoft Entra ID

Berechtigungen und Zustimmung

Um ordnungsgemäß zu funktionieren, erfordert die Dynamics 365 CRM-Verbindung die folgenden OAuth-Scopes:

• user_impersonation
• offline_access
• User.Read

Sie können die Verbindung verwenden, um die Microsoft Dynamics 365 CRM-Aktivitäten in UiPath Studio zu aktivieren und Automatisierungen für die Verwaltung von Konten, Leads, Opportunitys, Vorfällen und anderen CRM-Funktionen zu erstellen. Folgende verschiedene berechtigungsbasierte Anwendungsfälle sind möglich:

Scope/Berechtigung	Use case	Aktivität/Ereignis
user_impersonation (erforderlich)	Der Scope user_impersonation ist erforderlich, um in Ihrem Authentifizierungsablauf mit der Azure Management-API zu arbeiten. Der Identitätswechsel wird verwendet, um die Geschäftslogik (Code) im Namen eines anderen Microsoft Datascope-Benutzers auszuführen, um eine gewünschte Funktion oder einen gewünschten Dienst mithilfe der entsprechenden Rolle und objektbasierten Sicherheit dieses Benutzers bereitzustellen, dessen Identität angenommen wurde. Dies ist erforderlich, da die Datascope-Webdienste von verschiedenen Clients und Diensten im Namen eines Datascope-Benutzers aufgerufen werden können, z. B. in einem Workflow oder einer benutzerdefinierten ISV-Lösung.	Keine Angabe
offline_access (erforderlich)	offline_access ist erforderlich, um das Aktualisierungstoken im Endpunkt der Authentifizierungsanforderung zu erhalten. Wenn Sie einen Autorisierungscode im OAuth 2.0-Autorisierungscode-Flow ohneoffline_access-Scope einlösen, erhalten Sie kein Aktualisierungstoken vom /token -Endpunkt.	Keine Angabe
User.Read (erforderlich)	Ermöglicht Benutzern die Anmeldung bei der App und ermöglicht der App, das Profil angemeldeter Benutzer zu lesen. Dadurch kann die App auch grundlegende Unternehmensinformationen von angemeldeten Benutzern lesen.	Keine Angabe

Abhängig von den Azure AD-Richtlinien Ihres Unternehmens kann die Administratorzustimmung erforderlich sein.

Aktualisierungstokens für OAuth-Anwendungen

Aktualisierungstokens für OAuth-Anwendungen können von Microsoft jederzeit für ungültig erklärt oder widerrufen werden. Dafür kann es verschiedene Gründe geben, z. B. Timeouts und Widerrufe. Weitere Informationen finden Sie in der offiziellen Dokumentation von Microsoft .

Hinweis:

Die Ungültigkeit von Token führt zu fehlgeschlagenen Verbindungen und Automatisierungen können nicht ausgeführt werden, ohne Verbindungen zu reparieren.

Dieses Problem betrifft alle Microsoft Graph-basierten Connectors.

Stellen Sie sicher, dass Sie die Best Practices von Microsoft beim Erstellen Ihrer OAuth-Anwendungen befolgen. Ausführliche Informationen zum Erstellen einer Microsoft OAuth-App finden Sie in der Microsoft- Dokumentation.

Fügen Sie die Microsoft Dynamics 365-Verbindung hinzu

1. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the Connections tab.
3. Select Add connection.
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. Sie können zwischen zwei Authentifizierungstypen wählen: OAuth 2.0-Autorisierungscode oder Mitbringen Ihrer eigenen OAuth 2.0-App.
6. Geben Sie die erforderlichen Anmeldeinformationen ein und wählen Sie Verbinden aus .

Weitere Informationen zu Microsoft Dynamics 365 finden Sie in der Dokumentation zu Microsoft Dynamics 365.

Fehlerbehebung bei häufigen Einrichtungsproblemen

• Ungültiger Umleitungs-URI – Stellen Sie sicher, dass Ihre Azure AD-App genau die Rückruf-URL https://{baseURL}/provisioning_/callback (z. B. https://cloud.uipath.com/provisioning_/callback) in den Umleitungs-URIs registriert hat.
• Berechtigungen nicht erteilt – Für Dynamics CRM-Scopes kann die Administratorzustimmung erforderlich sein.
• Falsche Mandanten-URL – Stellen Sie sicher, dass Sie die genaue CRM-Basis-URL Ihrer Organisation verwenden.
• Probleme mit Aktualisierungstokens/Zustimmung – Diese können zu fehlgeschlagenen Verbindungen führen, wenn sich die Azure AD-Konfiguration nach der ersten Zustimmung ändert.