Dynamics 365-Einrichtungsleitfaden

Diese Anleitung führt Sie durch die Registrierung einer Azure AD-Anwendung, damit BuiltWith sich bei Ihrer Dynamics 365-Instanz authentifizieren und Leads automatisch aktualisieren kann. Sie benötigen Administratorrechte für Azure Active Directory und Dynamics 365.

Schritt 1 – Registrieren einer neuen App in Azure Active Directory

Melden Sie sich mit Ihrem Azure-Administratorkonto bei portal.azure.com an. Wählen Sie im linken Menü Azure Active Directory aus, anschließend App-Registrierungen und klicken Sie auf + Neue Registrierung .

Geben Sie einen Namen wie „BuiltWith Integration“ ein. Wählen Sie unter „Unterstützte Kontotypen “ die Option „Nur Konten in diesem Organisationsverzeichnis (Einzelmandant)“ . Lassen Sie das Feld „Umleitungs-URI“ leer und klicken Sie auf „Registrieren“ .

Kopieren Sie auf der App-Übersichtsseite die Anwendungs-ID (Client-ID) und die Verzeichnis-ID (Mandanten-ID ) – Sie benötigen beide, um die Anmeldeinformationen bei BuiltWith einzugeben.

Schritt 2 – API-Berechtigungen für Dynamics 365 konfigurieren

Klicken Sie in Ihrer App-Registrierung im linken Menü auf „API-Berechtigungen“ und anschließend auf „+ Berechtigung hinzufügen “. Wählen Sie Dynamics CRM aus (falls es nicht in der Liste erscheint, suchen Sie unter „Von meiner Organisation verwendete APIs“). Wählen Sie „Delegierte Berechtigungen“ aus, aktivieren Sie „Benutzeridentitätswechsel “ und klicken Sie auf „Berechtigungen hinzufügen“ .

Schritt 3 – Erstellen Sie ein Kundengeheimnis

Klicken Sie in Ihrer App-Registrierung auf Zertifikate & Geheimnisse . Klicken Sie unter Clientgeheimnisse auf + Neues Clientgeheimnis , geben Sie eine Beschreibung wie BuiltWith ein, wählen Sie einen Ablaufzeitraum und klicken Sie auf Hinzufügen .

Kopieren Sie sofort den geheimen Wert (die lange Zeichenfolge in der Spalte „Wert“, nicht die geheime ID). Dieser Wert wird nur einmal angezeigt und verschwindet, sobald Sie die Seite verlassen.

Schritt 4 – Administratorzustimmung erteilen

Kehren Sie in Ihrer App-Registrierung zu den API-Berechtigungen zurück und klicken Sie auf „Administratorzustimmung erteilen für“ Klicken Sie zur Bestätigung auf „Ja“ . In der Statusspalte sollte nach Erteilung der Zustimmung neben jeder Berechtigung ein grünes Häkchen angezeigt werden.

Schritt 5 – Fügen Sie die App als Dynamics 365-Anwendungsbenutzer hinzu

Gehen Sie zu admin.powerplatform.microsoft.com und wählen Sie Ihre Umgebung aus. Navigieren Sie zu Einstellungen → Benutzer + Berechtigungen → Anwendungsbenutzer und klicken Sie auf + Neuer App-Benutzer .

Klicken Sie auf „+ App hinzufügen“ , suchen Sie nach dem Registrierungsnamen Ihrer App (BuiltWith Integration) und wählen Sie ihn aus. Wählen Sie Ihre Geschäftseinheit aus und klicken Sie auf „Erstellen“ .

Öffnen Sie den neu erstellten Anwendungsbenutzer und weisen Sie ihm die Sicherheitsrolle „Vertriebsmitarbeiter “ oder eine benutzerdefinierte Rolle mit Lese- und Schreibzugriff auf die Lead-Entität zu. Die Rolle benötigt mindestens die Berechtigungen „Erstellen“, „Lesen“, „Schreiben“, „Anhängen“ und „Anhängen an“ für die Lead-Entität.

Schritt 6 – Anmeldeinformationen in BuiltWith eingeben

Kehren Sie zur BuiltWith Dynamics 365-Verbindungsseite zurück und füllen Sie die folgenden Felder aus:

Client-ID — die in Schritt 1 kopierte Anwendungs-ID (Client-ID).
Client Secret – der in Schritt 3 kopierte geheime Wert (nicht die geheime ID).
Mandanten-ID — die in Schritt 1 kopierte Verzeichnis-(Mandanten-)ID.
Dynamics 365-URL – Ihre Dynamics 365-Instanz-URL, z. B. https://yourorg.crm.dynamics.com. Diese finden Sie im Power Platform Admin Center unter Umgebungen → Ihre Umgebung → Umgebungs-URL.

Klicken Sie auf Speichern . BuiltWith überprüft die Anmeldeinformationen mit einem Testaufruf an Ihre Dynamics 365-Instanz. Nach der Bestätigung startet die Lead-Anreicherung automatisch.

Sollten Sie einen Authentifizierungsfehler sehen, vergewissern Sie sich, dass in Schritt 4 die Administratorzustimmung erteilt wurde und dass dem Anwendungsbenutzer in Schritt 5 die richtige Sicherheitsrolle zugewiesen wurde.