Zum Inhalt springen

Microsoft SharePoint OAuth-Verbindungsleitfaden für Jitterbit App Builder

Voraussetzungen

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

OAuth-Sicherheitsanbieter erstellen

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

  1. Gehen Sie zu IDE > Security Providers.

  2. Klicken Sie auf + Security Provider. Die Seite Provider wird geöffnet. Geben Sie die folgenden Details an:

    • Unter Settings:

      • Name: Identifiziert den Sicherheitsanbieter und wird in der URL angezeigt. Beispiel: OAuth
      • Type: OAuth
      • Enabled: Wählen Sie diese Option aus, um diesen Sicherheitsanbieter zu aktivieren.

    • Unter Authentication:

      • OAuth Grant: Authorization Code
      • OAuth Client Authentication: Basic
      • OAuth Resource Authentication: Bearer

    • Unter Sign In:

      • Redirect on Challenge: True

  3. Klicken Sie auf Save.

Microsoft Azure-App-Registrierung erstellen

Registrieren Sie eine App in Microsoft Azure, um die erforderlichen Anmeldedaten für die Konfiguration des OAuth-Sicherheitsanbieters zu erhalten. Eine Übersicht des Registrierungsprozesses finden Sie im Microsoft-Leitfaden Quickstart: Register an application.

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

  2. Klicken Sie auf Microsoft Entra ID.

  3. Navigieren Sie zu App registrations und klicken Sie auf New registration.

  4. Geben Sie einen App Name ein. Beispiel: OAuth

  5. Unter Redirect URI (optional):

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

  6. Klicken Sie auf Register.

  7. Klicken Sie auf API permissions und dann auf Add a permission.

  8. Klicken Sie auf die Kachel SharePoint und wählen Sie Delegated permissions aus.

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

    • AllSites Manage
    • AllSites Read
    • AllSites Write

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

  11. Klicken Sie auf Add permissions.

  12. Klicken Sie auf Overview. Notieren Sie sich die folgenden Werte — Sie benötigen sie bei der Konfiguration von App Builder:

    • Directory (tenant) ID: Wird in den URLs des Autorisierungs- und Token-Endpunkts verwendet.
    • Application (client) ID: Wird als Anmeldebenutzername für die Anmeldedaten verwendet.

    Hilfe zum Auffinden dieser Werte finden Sie unter How to find your Microsoft Entra tenant ID.

  13. Klicken Sie unter Client credentials auf Add a certificate or secret.

  14. Klicken Sie auf + New client secret, geben Sie eine Description ein, wählen Sie ein Ablaufdatum aus und klicken Sie auf Add.

  15. Kopieren Sie den Value des Client-Secrets sofort — es wird nur einmal angezeigt und wird als Anmeldekennwort in App Builder benötigt.

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

  17. Klicken Sie im Panel Endpoints auf + Endpoints und konfigurieren Sie die folgenden Einstellungen, wobei Sie Ihre Directory (tenant) ID einsetzen:

    • Authorization Endpoint: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/authorize/
    • Token Endpoint: https://login.microsoft.com/<Directory ID>/oauth2/v2.0/token/

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

    • Type: Client
    • User Name: Application (client) ID aus Azure
    • Password: Client-Secret-Wert aus Azure

  19. Klicken Sie auf Save.

  20. Klicken Sie im Panel Properties auf + Property und geben Sie Folgendes im Feld Value ein:

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

  21. Klicken Sie auf Save.

Microsoft SharePoint-Datenquelle erstellen

  1. Gehen Sie zu IDE > Data Servers.

  2. Klicken Sie im Panel Data Servers auf + Server. Das Dialogfeld Server wird geöffnet. Geben Sie die folgenden Informationen ein:

    • Server Name: Geben Sie einen Namen ein. Beispiel: SharePoint
    • Type: Microsoft SharePoint
    • Url: Vollständiger Pfad zum SharePoint-Verzeichnis des Unternehmens. 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 gerade erstellten Server aus. Eine Kachel wird im rechten Panel angezeigt. Doppelklicken Sie auf die Kachel oder klicken Sie auf das Symbol , um erweiterte Optionen anzuzeigen.

  6. Klicken Sie unter Data Storage Layer auf Importieren und führen Sie den OAuth-Ablauf aus, wenn Sie dazu aufgefordert werden. Das Dialogfeld Schema importieren wird geöffnet.

  7. Klicken Sie auf die Registerkarte Views, suchen Sie das zu importierende Schema (z. B. Lists) und klicken Sie auf Schema importieren.

  8. Schließen Sie das Dialogfeld Schema importieren.

  9. Klicken Sie unter Business Logic Layer auf Logik. Die Seite Regeln nach Tabelle wird geöffnet.

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