Zum Inhalt springen

Microsoft SharePoint OAuth-Verbindungshandbuch für Jitterbit App Builder

Voraussetzungen

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

Erstellen eines OAuth-Sicherheitsanbieters

Hier erstellen Sie einen OAuth-Sicherheitsanbieter in App Builder.

  1. Navigieren Sie in der IDE zum Abschnitt Sicherheitsanbieter und erstellen Sie mit der Schaltfläche + Datenquellenauthentifizierung einen neuen Sicherheitsanbieter.
  2. Geben Sie die folgenden Details an:

    • Name - Identifiziert den Sicherheitsanbieter und erscheint in der URL. Beispiel: OAuth
    • Typ - OAuth
    • Aktiviert - Aktivieren Sie dieses Kontrollkästchen, um diesen Sicherheitsanbieter zu aktivieren.
    • OAuth Grant - Autorisierungscode
    • OAuth-Client-Authentifizierung - Grundlegend
    • OAuth-Ressourcenauthentifizierung - Träger
    • Weiterleitung bei Herausforderung - Wahr
  3. Klicken Sie auf Speichern

Erstellen einer Microsoft Azure-App-Registrierung

Als Nächstes registrieren Sie eine App in Microsoft Azure und konfigurieren den OAuth-Sicherheitsanbieter in App Builder.

  1. Navigieren Sie zu portal.azure.com und melden Sie sich an
  2. Klicken Sie auf Microsoft Entra ID

    entraid.png

  3. Navigieren Sie zu App-Registrierungen

  4. Klicken Sie auf Neue Registrierung
  5. Weisen Sie einen App-Namen zu. Beispiel: OAuth
  6. Im Abschnitt Umleitungs-URI (optional):

    • Wählen Sie Web aus der Liste „Plattform auswählen“
    • Geben Sie die URI für den Sicherheitsanbieter auf der App Builder Instanz. Das Format der Weiterleitungs URL sollte https://<App Builder-Instance>/signin-<Security-Provider-Name>.

    redirecturi.png

  7. Klicken Sie auf Registrieren

  8. Klicken Sie auf API Berechtigungen
  9. Klicken Sie auf Berechtigung hinzufügen
  10. Klicken Sie auf die Fliese SharePoint
  11. Wählen Sie die Option Delegierte Berechtigungen
  12. Erweitern Sie AllSites
  13. Aktivieren Sie die folgenden Berechtigungen:

    • AllSites verwalten
    • Alle Seiten lesen
    • AllSites schreiben
  14. Erweitern Sie Projekt unter Berechtigungen

  15. Aktivieren Sie ProjectRead und ProjectWrite
  16. Klicken Sie auf die Schaltfläche Berechtigungen hinzufügen
  17. Klicken Sie auf Übersicht
  18. Klicken Sie auf die Tab Endpoints

    • Der Bildschirm „Endpoints“ enthält Werte, die während der Konfiguration der Endpoints des Sicherheitsanbieters benötigt werden. App Builder

    endpointconfig_copy.png

  19. Klicken Sie unter Clientanmeldeinformationen auf Zertifikat oder Geheimnis hinzufügen

  20. Klicken Sie auf + Neues Clientgeheimnis
  21. Geben Sie eine Beschreibung ein
  22. Wählen Sie ein Ablaufdatum aus
  23. Klicken Sie auf die Schaltfläche Hinzufügen

    • Der Clientgeheimnis-Wert wird für die Anmeldeinformationskonfiguration in App Builder
  24. Navigieren Sie zurück zu den Anbieterdetails in App Builder

  25. Klicken Sie im Bereich „Endpoints“ auf + Endpoints und konfigurieren Sie die folgenden Endpoints:

    • Endpoint: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/authorize/
    • Token Endpoint: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/token/
  26. Klicken Sie auf + Anmeldeinformationen:

    • Typ - Kunde
    • Benutzername - Anwendungs-(Client-)ID von Microsoft Azure
    • Passwort - Clientgeheimer Wert aus Microsoft Azure
  27. Klicken Sie auf Speichern und schließen Sie das Popup

  28. Klicken Sie im Eigenschaftenfenster auf + Eigenschaft
  29. Geben Sie die URL in das Feld Wert ein. Der Wert für die URL sollte sein https://<companyname>.sharepoint.com/.default offline_access
  30. Klicken Sie auf Speichern
  31. Schließen Sie das Popup

App Builder config.png

Erstellen einer Microsoft SharePoint-Datenquelle

Zuletzt erstellen Sie eine Microsoft SharePoint-Datenquelle in App Builder und importieren Sie die SharePoint-Daten.

  1. Navigieren Sie zur IDE
  2. Klicken Sie auf Datenserver
  3. Klicken Sie auf die Schaltfläche + Server
  4. Geben Sie im Feld Servername einen Namen ein. Beispiel: SharePoint
  5. Wählen Sie Microsoft SharePoint aus der Liste Typ
  6. Geben Sie im Feld Url den vollständigen Pfad zum SharePoint-Verzeichnis des Unternehmens ein, auf das Sie zugreifen. Das Format der URL sollte sein https://<companyname>.sharepoint.com/sites/<directory>

    dataserver.png

  7. Erweitern Sie Sicherheitseinstellungen

  8. Wählen Sie den konfigurierten OAuth-Sicherheitsanbieter aus der Liste Sicherheitsanbieter
  9. Klicken Sie auf Speichern
  10. Schließen Sie das Popup
  11. Klicken Sie im rechten Bereich auf Details
  12. Klicken Sie auf die Schaltfläche Importieren
  13. Folgen Sie dem OAuth-Flow
  14. Klicken Sie auf die Tab Ansichten
  15. Klicken Sie auf die Schaltfläche Schema importieren neben dem Schema, das Sie importieren möchten. Beispiel: Listen
  16. Navigieren Sie zur IDE
  17. Klicken Sie auf Datenserver
  18. Klicken Sie im rechten Bereich auf Details
  19. Klicken Sie auf die Schaltfläche Logik
  20. Klicken Sie auf das Symbol Ergebnisse für den importierten Inhalt, um die Daten zu bestätigen