Zum Inhalt springen

Verwandeln Sie Ihre Kontakte in Urlaubsgeld mit unserem neuen Kundenempfehlungsprogramm! Erfahren Sie mehr

Diese Dokumentation gilt für Version 4 und höher von App Builder, dem neuen Namen für Vinyl. Hier gelangen Sie zur Vinyl-Dokumentation.

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 im 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 - Einfach
    • 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 im App Builder weiter.

  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. Vergeben Sie einen App-Namen. 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 in der App Builder Instanz ein. Das Format der Weiterleitungs URL sollte sein 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 AlleSites
  13. Aktivieren Sie die folgenden Berechtigungen, indem Sie sie aktivieren:

    • AllSites verwalten
    • Alle Sites gelesen
    • AllSites Write
  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 Endpoints des Sicherheitsanbieters im App Builder benötigt werden

    endpointconfig_copy.png

  19. Klicken Sie unter Client-Anmeldeinformationen auf Zertifikat oder Geheimnis hinzufügen

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

    • Der Client-Geheimnis Wert wird für die Anmeldeinformationskonfiguration im App Builder benötigt
  24. Navigieren Sie zurück zu den Anbieterdetails im App Builder

  25. Klicken Sie im Bereich „Endpunkte“ 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 - Clientgeheimniswert von 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_access30. Klicken Sie auf Speichern. 31. Schließen Sie das Popup.

App Builderconfig.png

Erstellen einer Microsoft SharePoint-Datenquelle

Zuletzt erstellen Sie im App Builder eine Microsoft SharePoint-Datenquelle und importieren 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 Ihres Unternehmens ein. 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 für das 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