Zum Inhalt springen

Microsoft SharePoint OAuth-Verbindungsanleitung für Jitterbit App Builder

Voraussetzungen

  • Sie müssen über ein Microsoft Azure-Konto verfügen.

Erstellen eines OAuth-Sicherheitsanbieters

Erstellen Sie einen OAuth-Sicherheitsanbieter im App Builder, bevor Sie die Azure-App-Registrierung konfigurieren.

  1. Gehen Sie zu IDE > Sicherheitsanbieter.

  2. Klicken Sie auf + Datenquellenauthentifizierung. Die Seite Anbieter öffnet sich. Geben Sie die folgenden Details ein:

    • Unter Einstellungen:

      • Name: Identifiziert den Sicherheitsanbieter und erscheint in der URL. Beispiel: OAuth
      • Typ: OAuth
      • Aktiviert: Wählen Sie aus, um diesen Sicherheitsanbieter zu aktivieren.

    • Unter Authentifizierung:

      • OAuth-Zugriffsberechtigung: Autorisierungscode
      • OAuth-Client-Authentifizierung: Basis
      • OAuth-Ressourcen-Authentifizierung: Träger

    • Unter Anmelden:

      • Umleitung bei Herausforderung: Wahr

  3. Klicken Sie auf Speichern.

Erstellen einer Microsoft Azure-App-Registrierung

Registrieren Sie eine App in Microsoft Azure, um die erforderlichen Anmeldeinformationen für die Einrichtung des OAuth-Sicherheitsanbieters zu erhalten. Für einen Überblick über den Registrierungsprozess siehe die Microsoft Schnellstart: Registrieren einer Anwendung Anleitung.

  1. Gehen Sie zum Azure-Portal und melden Sie sich an.

  2. Klicken Sie auf Microsoft Entra ID.

  3. Navigieren Sie zu App-Registrierungen und klicken Sie auf Neue Registrierung.

  4. Geben Sie einen App-Namen ein. Beispiel: OAuth

  5. Unter Umleitungs-URI (optional):

    • Wählen Sie Web aus der Plattformliste.
    • Geben Sie die URI für den Sicherheitsanbieter ein: https://<App-Builder-Instance>/signin-<Security-Provider-Name>

  6. Klicken Sie auf Registrieren.

  7. Klicken Sie auf API-Berechtigungen, und klicken Sie dann auf Berechtigung hinzufügen.

  8. Klicken Sie auf die SharePoint-Kachel und wählen Sie Delegierte Berechtigungen.

  9. Erweitern Sie AllSites und aktivieren Sie die folgenden Berechtigungen:

    • AllSites Verwalten
    • AllSites Lesen
    • AllSites Schreiben

  10. Erweitern Sie Projekt und aktivieren Sie ProjectRead und ProjectWrite.

  11. Klicken Sie auf Berechtigungen hinzufügen.

  12. Klicken Sie auf Übersicht. Notieren Sie sich die folgenden Werte — Sie benötigen sie bei der Konfiguration des App Builders:

    • Verzeichnis (Mandanten) ID: Wird in den Autorisierungs- und Token-Endpunkt-URLs verwendet.
    • Anwendungs (Client) ID: Wird als Benutzername für die Anmeldeinformationen verwendet.

    Für Hilfe beim Auffinden dieser Werte, siehe So finden Sie Ihre Microsoft Entra-Mandanten-ID.

  13. Unter Client-Anmeldeinformationen klicken Sie auf Zertifikat oder Geheimnis hinzufügen.

  14. Klicken Sie auf + Neues Client-Geheimnis, geben Sie eine Beschreibung ein, wählen Sie ein Ablaufdatum aus und klicken Sie auf Hinzufügen.

  15. Kopieren Sie den Client-Geheimnis Wert sofort — er wird nur einmal angezeigt und wird als Passwort für die Anmeldeinformationen im App Builder benötigt.

  16. Kehren Sie zum App Builder zurück und öffnen Sie den zuvor erstellten Sicherheitsanbieter.

  17. Klicken Sie im Panel Endpunkte auf + Endpunkte und konfigurieren Sie Folgendes, wobei Sie Ihre Verzeichnis (Mandanten) ID ersetzen:

    • Autorisierungsendpunkt: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/authorize/
    • Token-Endpunkt: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/token/

  18. Klicken Sie auf + Anmeldeinformationen und geben Sie Folgendes an:

    • Typ: Client
    • Benutzername: Anwendungs (Client) ID aus Azure
    • Passwort: Wert des Client-Geheimnisses aus Azure

  19. Klicken Sie auf Speichern.

  20. Klicken Sie im Panel Eigenschaften auf + Eigenschaft und geben Sie Folgendes im Feld Wert ein:

    https://<companyname>.sharepoint.com/.default offline_access

  21. Klicken Sie auf Speichern.

Erstellen einer Microsoft SharePoint-Datenquelle

  1. Gehen Sie zu IDE > Datenserver.

  2. Klicken Sie im Panel Datenserver auf + Server. Der Dialog Server öffnet sich. Geben Sie die folgenden Informationen ein:

    • Servername: Geben Sie einen Namen ein. Beispiel: SharePoint
    • Typ: Microsoft SharePoint
    • Url: Vollständiger Pfad zum Unternehmens-SharePoint-Verzeichnis. Beispiel: https://<companyname>.sharepoint.com/sites/<directory>

  3. Erweitern Sie Sicherheitseinstellungen und wählen Sie den OAuth-Sicherheitsanbieter aus der Liste Sicherheitsanbieter aus.

  4. Klicken Sie auf Speichern.

  5. Wählen Sie im Panel Datenserver den Server aus, den Sie gerade erstellt haben. Eine Kachel erscheint im rechten Panel. Doppelklicken Sie auf die Kachel oder klicken Sie auf das -Symbol, um erweiterte Optionen anzuzeigen.

  6. Klicken Sie unter Datenablageschicht auf Importieren und schließen Sie den OAuth-Flow ab, wenn Sie dazu aufgefordert werden. Der Dialog Schema importieren öffnet sich.

  7. Klicken Sie auf die Registerkarte Ansichten, suchen Sie das zu importierende Schema (zum Beispiel Listen), und klicken Sie dann auf Schema importieren.

  8. Schließen Sie den Dialog Schema importieren.

  9. Klicken Sie unter Geschäftslogikschicht auf Logik. Die Seite Regeln nach Tabelle öffnet sich.

  10. Suchen Sie im Panel Tabellen das Schema, das Sie importiert haben. Klicken Sie auf das Ergebnisse-Symbol, um die Daten zu bestätigen.