Microsoft SharePoint Online-Module

Erweitern, um die Zugriffsanforderungen für die in diesem Artikel beschriebene Funktionalität anzuzeigen.

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront-Paket	Ein beliebiges Adobe Workfront Workflow- und Adobe Workfront Automation and Integration-Paket Workfront Ultimate Workfront Prime- und Select-Pakete bei zusätzlichem Kauf von Workfront Fusion.
Adobe Workfront-Lizenzen	Standard Work oder höher
Adobe Workfront Fusion-Lizenz	Betriebsbasiert: Verfügbar für Organisationen mit betriebsbasierten Lizenzen Connector-basiert (veraltet): Workfront Fusion for Work Automation and Integration
Produkt	Wenn Ihre Organisation über ein Workfront Select- oder Prime-Paket ohne Workfront Automation and Integration verfügt, muss Ihre Organisation Adobe Workfront Fusion erwerben.

Weitere Details zu den Informationen in dieser Tabelle finden Sie unter Zugriffsanforderungen in der Dokumentation.

Informationen zu Adobe Workfront Fusion-Lizenzen finden Sie unter Adobe Workfront Fusion-Lizenzen.

Erweitern Sie , um Anweisungen zum Verbinden von Microsoft SharePoint Online mit Workfront Fusion mithilfe eines Microsoft-Kontos anzuzeigen.

Sie können Ihr Microsoft-Konto verwenden, um eine Verbindung zu Microsoft SharePoint Online herzustellen. Anweisungen zum Verbinden Ihres Sharepoint-Kontos mit Workfront Fusion finden Sie unter Verbindung zu Adobe Workfront Fusion herstellen - Grundanweisungen.

Erweitern Sie , um Anweisungen zum Verbinden von Microsoft SharePoint Online mit Workfront Fusion mithilfe der erweiterten Einstellungen anzuzeigen.

Um Anmeldeinformationen in die Verbindung aufzunehmen, aktivieren Sie die Option Erweiterte Einstellungen anzeigen . Für diesen Verbindungstyp benötigen Sie eine Client-ID, ein Client-Geheimnis und eine Mandanten-ID.

1. Klicken Sie in einem beliebigen SharePoint Modul Hinzufügen) neben dem Feld Verbindung , um das Feld Verbindung erstellen zu öffnen.

2. Klicken Sie Erweiterte Einstellungen anzeigen.

3. Füllen Sie die folgenden Felder aus:

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
   Verbindungstyp	Um Client-Anmeldeinformationen zu verwenden, wählen Sie Microsoft 365 E-Mail aus.
   Verbindungsname	Geben Sie einen Namen für die Verbindung ein.
   Client-ID	Geben Sie die Client-ID für die SharePoint-App ein, mit der Sie eine Verbindung herstellen.
   Client-Geheimnis	Geben Sie das Client-Geheimnis für die SharePoint-App ein, mit der Sie eine Verbindung herstellen.
   Mandanten-ID	Geben Sie die Mandanten-ID der SharePoint-App ein, mit der Sie eine Verbindung herstellen.

4. Klicken Sie auf Weiter, um die Verbindung zu speichern und zum Modul zurückzukehren.

Erweitern Sie , um Anweisungen zum Verbinden von Microsoft SharePoint Online mit Workfront Fusion mithilfe der Zertifikatautorisierung anzuzeigen.

Sie können die Zertifikatsautorisierung verwenden, um eine Verbindung zu SharePoint herzustellen.

note important
IMPORTANT
Um die Zertifikatsautorisierung zu verwenden, müssen Sie zunächst eine App in Microsoft Entra erstellen und das Zertifikat dort hochladen.
Anweisungen finden Sie unter Konfigurieren von Zertifizierungsstellen für die zertifikatbasierte Authentifizierung von Microsoft Entra in der Dokumentation zu Microsoft.

1. Klicken Sie in einem beliebigen SharePoint Modul Hinzufügen) neben dem Feld Verbindung , um das Feld Verbindung erstellen zu öffnen.

2. Klicken Sie Erweiterte Einstellungen anzeigen.

3. Füllen Sie die folgenden Felder aus:

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
   Verbindungstyp	Um die Zertifikatautorisierung zu verwenden, wählen Sie Microsoft SharePoint Online (CERT Auth).
   Verbindungsname	Geben Sie einen Namen für die Verbindung ein.
   Client-ID	Geben Sie die Client-ID für die SharePoint-App ein, mit der Sie eine Verbindung herstellen.
   Fingerabdruck	Geben Sie den Fingerabdruck für die SharePoint-App ein, mit der Sie eine Verbindung herstellen.
   Privater Schlüssel	Geben Sie das Zertifikat oder den privaten Schlüssel ein, das bzw. der generiert wurde, als Ihre Anmeldeinformationen in Microsoft erstellt wurden. So extrahieren Sie Ihren privaten Schlüssel oder Ihr Zertifikat: Klicken Sie auf Extrahieren. Wählen Sie aus, ob Sie ein Zertifikat oder einen privaten Schlüssel extrahieren. Wählen Sie den zu extrahierenden Dateityp aus. Wählen Sie die Datei aus, die den privaten Schlüssel oder das Zertifikat enthält. Geben Sie das Kennwort für die Datei ein. Klicken Sie auf Speichern, um die Datei zu extrahieren und zur Verbindungseinrichtung zurückzukehren.

4. Klicken Sie auf Continue, um die Verbindung zu speichern und zum Modul zurückzukehren.

Erweitern Sie , um Anweisungen zum Verbinden von Microsoft SharePoint Online mit Workfront Fusion mithilfe eines Service-Prinzipals anzuzeigen.

Sie können eine Verbindung erstellen, die einen Service-Prinzipal (eine Anwendungs-API-Verbindung) anstelle eines persönlichen Kontos verwendet. Dies ist nützlich, wenn Sie möchten, dass die Verbindung als Anwendung oder Service-Identität und nicht als eine bestimmte Person ausgeführt wird. Die Integration funktioniert beispielsweise nicht, wenn diese Person das Unternehmen verlässt oder ihr Passwort ändert.

note important
IMPORTANT
Dieser Verbindungstyp ist nur für das Modul Erstellen eines API-) verfügbar. Andere SharePoint-Module erfordern einen der anderen in diesem Artikel beschriebenen Verbindungstypen.

• Voraussetzungen für das Verbinden von Microsoft SharePoint Online mit Workfront Fusion mithilfe eines Service-Prinzipals
• Erstellen der App-Registrierung in der Microsoft Entra ID
• Erstellen von Client-Geheimnissen
• API-Berechtigungen erteilen
• Erfassen von Verbindungsdetails
• Erstellen der Verbindung

Voraussetzungen für das Verbinden von Microsoft SharePoint Online mit Workfront Fusion mithilfe eines Service-Prinzipals

Sie benötigen Globaler Administrator, Anwendungsadministrator oder Privilegierter Rollenadministrator Zugriff in der Microsoft Entra ID, um die Anwendung zu registrieren und Berechtigungen zu erteilen. Wenn Sie diesen Zugriff nicht haben, bitten Sie jemanden in Ihrem IT- oder Identitäts-Team, diese Schritte für Sie auszuführen.

Fahren Sie Erstellen der App-Registrierung in der Microsoft Entra ID fort.

Erstellen der App-Registrierung in der Microsoft Entra ID (Service-Prinzipal)

1. Melden Sie sich beim Microsoft Entra Admin Center an.
2. Navigieren Sie App-Registrierungen > Neue Registrierung.
3. Geben Sie der App einen klaren, erkennbaren Namen. Beispiel: Make - SharePoint Integration.
4. Lassen Sie Umleitungs-URI leer. Für diese Verbindung muss sich niemand über einen Browser anmelden.
5. Wählen Sie Registrieren aus.
6. Fahren Sie mit Erstellen eines Client-Geheimnisses fort.

Erstellen eines Client-Geheimnisses (Service-Prinzipal)

1. Navigieren Sie in Ihrer neuen App-Registrierung zu Zertifikate und Geheimnisse.
2. Wählen Sie Neues Client-Geheimnis, fügen Sie eine Beschreibung hinzu und wählen Sie einen Ablaufzeitraum aus.
3. Bestätigen Sie die Angaben mithilfe der Schaltfläche Hinzufügen.
4. Kopieren Sie den (Wert der geheimen Daten. Er wird nur einmal angezeigt. Wenn Sie die Seite verlassen möchten, bevor Sie sie kopieren, müssen Sie eine neue erstellen.
5. Fahren Sie fort API-Berechtigungen erteilen.

API-Berechtigungen erteilen (Service-Prinzipal)

1. Navigieren Sie in Ihrer App-Registrierung zu API-Berechtigungen.
2. Wählen Sie Berechtigung hinzufügen und dann Microsoft-Diagramm aus.
3. Wählen Sie Anwendungsberechtigungen aus.
4. Wählen Sie die Berechtigungen aus, die Ihre API-Aufrufe benötigen, und wählen Sie dann Berechtigungen hinzufügen.
5. Wählen Sie Administratorzustimmung für Ihre Organisation erteilen und bestätigen Sie dann.
6. Fahren Sie Verbindungsdetails erfassen fort.

Erfassen der Verbindungsdetails (Service-Prinzipal)

Beachten Sie auf der Seite Übersicht der App-Registrierung die folgenden Werte. Diese werden beim Erstellen der Verbindung im Modul eingegeben.

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Mandanten-ID	Auf der Seite Überblick mit der Beschriftung Verzeichnis (Mandanten-ID.
Client-ID	Auf der Seite Überblick mit der Bezeichnung Anwendungs-(Client-)ID.
Client-Geheimnis	Der Wert, den Sie in " eines Client-Geheimnisses“ kopiert.

Fahren Sie Verbindung erstellen fort.

Erstellen der Verbindung (Service-Prinzipal)

1. Klicken Sie im Modul API-Aufruf ausführen auf Hinzufügen neben dem Feld Verbindung , um das Feld Verbindung erstellen zu öffnen.

2. Klicken Sie Erweiterte Einstellungen anzeigen.

3. Wählen Sie im Feld Verbindungstyp die Option Service-Prinzipal.

4. Geben Sie Folgendes ein:

   • Mandanten-ID
   • Client-ID
   • Client Secret (Client-Geheimnis)

5. Klicken Sie auf Continue, um die Verbindung zu speichern und zum Modul zurückzukehren.

   Wenn alles korrekt eingerichtet ist, wird die Verbindung erfolgreich validiert.

Erweitern Sie , um Anweisungen zum Verbinden von Microsoft SharePoint Online mit Adobe Workfront Fusion über eine Federated-Verbindung anzuzeigen.

Eine Federated-Verbindung funktioniert wie die Service-Prinzipalverbindung, mit dem Unterschied, dass sie kein Client-Geheimnis verwendet.
Anstatt geheime Daten zu speichern, weisen Sie die Microsoft Entra ID an, Token zu vertrauen, die Workfront Fusion für eine bestimmte Verbindung ausgibt. Wenn die Verbindung ausgeführt wird, stellt Fusion einen kurzlebigen Identitätsnachweis bereit und die Microsoft Entra ID gibt ein Zugriffstoken zurück. Da es kein Client-Geheimnis gibt, gibt es nichts, das abläuft, und keine Geheimnisse, die gedreht oder gespeichert werden können.

note
NOTE
Das Einrichten dieser Verbindung führt zu zwei Besuchen im Microsoft Entra Admin Center. Sie registrieren die App zuerst, erstellen dann die Verbindung in Workfront Fusion und kehren dann zur Microsoft Entra ID zurück, um die Federated Credential hinzuzufügen. Dies liegt daran, dass die Federated Credential eine bestimmte Verbindung identifiziert und diese Kennung erst vorhanden ist, wenn die Verbindung erstellt wurde.

• Voraussetzungen für das Verbinden von Microsoft SharePoint Online mit Workfront Fusion über eine Federated-Verbindung
• Erstellen der App-Registrierung in der Microsoft Entra ID (Federated Connection)
• API-Berechtigungen erteilen (Federated Connection)
• Erfassen der Verbindungsdetails (Federated Connection)
• Erstellen der Verbindung in Workfront Fusion (Federated-Verbindung)
• Fügen Sie die Federated Credential in der Microsoft Entra ID (Federated Connection) hinzu.
• Überprüfen der Verbindung (Federated-Verbindung)
• Fehlerbehebung

Voraussetzungen für das Verbinden von Microsoft SharePoint Online mit Workfront Fusion über eine Federated-Verbindung

Sie benötigen in der Microsoft Entra ID den Zugriff eines globalen Administrators, eines Anwendungsadministrators oder eines Privileged Role-Administrators, um die App zu registrieren, Berechtigungen zu erteilen und die Federated Credential hinzuzufügen. Wenn Sie diesen Zugriff nicht haben, bitten Sie jemanden in Ihrem IT- oder Identitäts-Team, diese Schritte für Sie auszuführen.

Erstellen der App-Registrierung in der Microsoft Entra ID (Federated Connection)

1. Melden Sie sich beim Microsoft Entra Admin Center an.
2. Gehen Sie zu App-Registrierungen > Neue Registrierung.
3. Geben Sie der App einen klaren, erkennbaren Namen. Beispiel: Workfront Fusion SharePoint Integration.
4. Lassen Sie den Umleitungs-URI leer. Für diese Verbindung muss sich niemand über einen Browser anmelden.
5. Wählen Sie Registrieren aus.
   Erstellen Sie kein Client-Geheimnis. Eine Federated-Verbindung verwendet keine.
6. Gewähren Sie weiterhin API-Berechtigungen.

API-Berechtigungen erteilen (Federated Connection)

1. Navigieren Sie in Ihrer App-Registrierung zu API-Berechtigungen.
2. Wählen Sie Berechtigung hinzufügen und dann Microsoft-Diagramm aus.
3. Wählen Sie Anwendungsberechtigungen aus.
4. Wählen Sie die Berechtigungen aus, die Ihre API-Aufrufe benötigen, und wählen Sie dann Berechtigungen hinzufügen.
5. Wählen Sie Administratorzustimmung erteilen für Ihre Organisation aus und bestätigen Sie dann.
6. Fahren Sie Verbindungsdetails erfassen fort.

Erfassen der Verbindungsdetails (Federated Connection)

1. Beachten Sie auf der Seite Übersicht der App-Registrierung die folgenden Werte. Diese werden beim Erstellen der Verbindung im Modul eingegeben.

   table 0-row-2 1-row-2 layout-auto html-authored no-header
   Mandanten-ID	Auf der Seite Überblick mit der Beschriftung Verzeichnis (Mandanten-ID.
   Client-ID	Auf der Seite Überblick mit der Bezeichnung Anwendungs-(Client-)ID.

2. Fahren Sie Verbindung in Workfront Fusion erstellen fort.

Erstellen der Verbindung in Workfront Fusion (Federated-Verbindung)

1. Klicken Sie im Modul API-Aufruf ausführen auf b neben dem Feld Verbindung , um das Feld Verbindung erstellen zu öffnen.

2. Klicken Sie auf (Federated Connection).

3. Wählen Sie im Feld Verbindungstyp den Verbundverbindungstyp aus.

4. Geben Sie Folgendes ein:

   • Mandantenkennung
   • Client-ID

5. Wählen Sie Erstellen aus.
   Workfront Fusion zeigt drei Werte an. Sie verwenden sie im nächsten Verfahren.

   table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
   Aussteller	Immer https://oidc.automations.adobe.com.
   Betreff	Identifiziert diese Verbindung. Es sieht wie fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964 aus. Es ist für jede Verbindung, die Sie erstellen, anders.
   Zielgruppe	Immer api://AzureADTokenExchange.

6. Lassen Sie dieses Bedienfeld geöffnet und kopieren Sie den Wert Betreff.

   note
   NOTE
   Schließen Sie das Bedienfeld nicht und klicken Sie nicht auf Abbrechen. Die Verbindung wird erst beendet, wenn Sie die verbleibenden Vorgänge abgeschlossen haben. Wenn Sie das Bedienfeld schließen, müssen Sie die Verbindung löschen und erneut beginnen, da eine neue Verbindung einen neuen Betreff erhält.

7. Fahren Sie fort mit Hinzufügen der Federated Credential in der Microsoft Entra ID.

Fügen Sie die Federated Credential in der Microsoft Entra ID (Federated Connection) hinzu.

Dieses Verfahren ersetzt das Client-Geheimnis. Dadurch wird Microsoft Entra ID angewiesen, Token zu akzeptieren, die Workfront Fusion für diese Verbindung ausgibt.

1. Kehren Sie in einer neuen Browser-Registerkarte zum Microsoft Entra-Admin-Center zurück und öffnen Sie Ihre App-Registrierung.

2. Navigieren Sie Zertifikate und Geheimnisse > Federated Credentials.

3. Wählen Sie Berechtigung hinzufügen aus.

4. Wählen Sie im Szenario „Federated Credential die Option „Anderer Aussteller aus.

5. Geben Sie Folgendes ein:

   table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
   Aussteller	https://oidc.automations.adobe.com.
   Betreffkennung	Der Betreff, den Sie aus Workfront Fusion kopiert haben. Fügen Sie es exakt ein, ohne zusätzliche Leerzeichen.
   Name	Ein Name, der diese Verbindung identifiziert, sodass Sie sie später finden können. Beispiel: workfront-fusion-connection-28964.
   Zielgruppe	api://AzureADTokenExchange. Dieses Feld ist normalerweise für Sie ausgefüllt. Behalten Sie den Standardwert bei.

6. Bestätigen Sie die Angaben mithilfe der Schaltfläche Hinzufügen.

7. Fahren Sie Verbindung überprüfen fort.

Überprüfen der Verbindung (Federated-Verbindung)

1. Kehren Sie zur Browser-Registerkarte von Workfront Fusion zurück, auf der das Bedienfeld Verbindung noch geöffnet ist.

2. Wählen Sie Speichern aus.

   • Wenn alles richtig eingerichtet ist, wird die Verbindung erfolgreich validiert, und Sie können mit dem Einrichten des Moduls fortfahren.
   • Wenn die Überprüfung fehlschlägt, bleibt das Bedienfeld geöffnet und zeigt den Fehler an. Korrigieren Sie das Problem mit der Microsoft Entra ID und klicken Sie erneut auf Speichern . Sie müssen die Verbindung nicht neu erstellen, und das Betreff ändert sich nicht.

Fehlerbehebung

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Die Verbindungsprüfung schlägt mit einem ungültigen Client oder einem ungültigen Anforderungsfehler fehl	Die Microsoft-Eintrags-ID konnte dem Token keine Federated Credential zuordnen. Vergewissern Sie sich, dass der Aussteller bzw. die Ausstellerin exakt https://oidc.automations.adobe.com ist und keinen Schrägstrich aufweist und dass die Betreffkennung zeichenweise mit dem in Workfront Fusion angezeigten Betreff identisch ist. Ein aus einer anderen Verbindung kopiertes Subjekt ist die häufigste Ursache.
Die Verbindung wird überprüft, aber API-Aufrufe geben 403 zurück	Die Identität ist vertrauenswürdig, aber die App verfügt nicht über die Microsoft-Diagrammberechtigungen, die Ihr Aufruf benötigt. Kehren Sie zu API-Berechtigungen erteilen zurück, fügen Sie die erforderliche Anwendungsberechtigung hinzu und erteilen Sie die Zustimmung des Administrators.
Es können keine weiteren Verbundberechtigungen hinzugefügt werden	Sie haben das Limit von 20 Federated Credentials für diese App-Registrierung erreicht. Registrieren Sie eine zusätzliche App und erstellen Sie weitere Verbindungen dafür.