Adobe Authenticator-Module

Mit dem Adobe Authenticator-Modul können Sie über eine einzige Verbindung eine Verbindung zu jeder Adobe-API herstellen. Dadurch können Sie einfacher eine Verbindung zu Adobe-Produkten herstellen, die noch keinen dedizierten Fusion-Connector haben.

Der Vorteil gegenüber den HTTP-Modulen besteht darin, dass Sie wie in einer dedizierten App eine Verbindung erstellen können.

Eine Liste der verfügbaren Adobe-APIs finden Sie unter Adobe-APIs. Sie können möglicherweise nur die APIs verwenden, denen Sie zugewiesen sind.

Zugriffsanforderungen

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: keine Workfront Fusion-Lizenz erforderlich

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.

Voraussetzungen

  • Sie müssen Zugriff auf das Adobe-Produkt haben, mit dem sich das Modul verbinden soll.

  • Sie müssen Zugriff auf die Adobe Developer Console haben.

  • Sie müssen über ein Projekt in der Adobe Developer Console verfügen, das die API enthält, mit der sich das Modul verbinden soll. Sie haben folgende Möglichkeiten:

    • Erstellen Sie ein neues Projekt mit der -API.

      ODER

    • Fügen Sie die API zu einem vorhandenen Projekt hinzu.

    Informationen zum Erstellen oder Hinzufügen einer API zu einem Projekt in der Adobe Developer Console finden Sie unter Erstellen eines Projekts in der Dokumentation zu Adobe.

Adobe Authenticator-API-Informationen

Der Adobe Authenticator-Connector verwendet Folgendes:

API-Tag
v1.1.4

Verbindung erstellen

Eine Adobe Authenticator-Verbindung stellt eine Verbindung zu einem einzelnen Projekt in Adobe Developer Console her. Um dieselbe Verbindung für mehr als eine Adobe-API zu verwenden, fügen Sie die APIs zum selben Projekt hinzu und erstellen Sie eine Verbindung zu diesem Projekt.

Sie können separate Verbindungen zu separaten Projekten erstellen, aber Sie können keine Verbindung verwenden, um auf eine API zuzugreifen, die nicht zu dem in dieser Verbindung angegebenen Projekt gehört.

IMPORTANT
Mit dem Adobe Authenticator-Connector haben Sie die Wahl zwischen einer OAuth-Server-zu-Server-Verbindung oder einer JWT-Verbindung (Service Account). Adobe hat veraltete JWT-Anmeldeinformationen, die nach dem 1. Januar 2025 nicht mehr funktionieren. Daher empfehlen wir dringend, OAuth-Verbindungen zu erstellen.
Weitere Informationen zu diesen Verbindungstypen finden Sie unter Server-zu-Server in der Dokumentation zu Adobe

So erstellen Sie eine Verbindung:

  1. Klicken Sie in einem beliebigen Adobe Authenticator Modul Hinzufügen) neben dem Feld Verbindung .

  2. Füllen Sie die folgenden Felder aus:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 layout-auto html-authored no-header
    Verbindungstyp Wählen Sie aus, ob Sie eine OAuth-Server-zu-Server-Verbindung oder eine JWT-Verbindung (Service-Konto) erstellen möchten. Es wird dringend empfohlen, OAuth-Verbindungen zu erstellen.
    Verbindungsname Geben Sie einen Namen für die Verbindung ein.
    Client-ID Geben Sie Ihre Adobe-Client-ID ein. Diese finden Sie im Abschnitt mit den Anmeldeinformationen-Details der Adobe Developer Console.
    Client-Geheimnis Geben Sie Ihr Adobe-Client-Geheimnis ein. Diese finden Sie im Abschnitt mit den Anmeldeinformationen-Details der Adobe Developer Console.
    Bereiche Wenn Sie eine OAuth-Verbindung ausgewählt haben, geben Sie die für diese Verbindung erforderlichen Bereiche ein.
    ID des technischen Kontos Wenn Sie eine JWT-Verbindung ausgewählt haben, geben Sie Ihre Adobe ID des technischen Kontos ein. Diese finden Sie im Abschnitt mit den Anmeldeinformationen-Details der Adobe Developer Console.
    Organisations-ID Wenn Sie eine JWT-Verbindung ausgewählt haben, geben Sie Ihre Adobe Organisations-ID ein. Diese finden Sie im Abschnitt mit den Anmeldeinformationen-Details der Adobe Developer Console.
    Meta-Bereiche Wenn Sie eine JWT-Verbindung ausgewählt haben, geben Sie die für diese Verbindung erforderlichen Metabereiche ein.
    Privater Schlüssel

    Wenn Sie eine JWT-Verbindung ausgewählt haben, geben Sie den privaten Schlüssel ein, der beim Erstellen Ihrer Anmeldeinformationen in der Adobe Developer Console generiert wurde.

    So extrahieren Sie Ihren privaten Schlüssel oder Ihr Zertifikat:

    1. Klicken Sie auf Extrahieren.

    2. Wählen Sie den zu extrahierenden Dateityp aus.

    3. Wählen Sie die Datei aus, die den privaten Schlüssel oder das Zertifikat enthält.

    4. Geben Sie das Kennwort für die Datei ein.

    5. Klicken Sie auf Speichern, um die Datei zu extrahieren und zur Verbindungseinrichtung zurückzukehren.

    Basis-URLs

    Sie müssen die Basis-URLs hinzufügen, die dieser Authentifizierer zulassen soll. Wenn Sie das Modul Benutzerdefinierten API-Aufruf erstellen später im Szenario verwenden, fügen Sie der ausgewählten URL einen relativen Pfad hinzu. Durch die Eingabe von URLs hier können Sie steuern, mit was sich das Modul Benutzerdefinierte API-Aufrufe erstellen verbinden kann, was die Sicherheit erhöht.

    Klicken Sie für jede Basis-URL, die Sie der Authentifizierung hinzufügen möchten, auf Element hinzufügen und geben Sie die Basis-URL ein.

    Authentifizierungs-URL Lassen Sie dieses Feld leer, um die standardmäßige Adobe IMS-Authentifizierungs-URL von https://ims-na1.adobelogin.com zu verwenden. Wenn Sie Adobe IMS nicht für die Authentifizierung verwenden, geben Sie die URL ein, die für die Authentifizierung verwendet werden soll.
  3. Klicken Sie auf Weiter, um die Verbindung zu speichern und zum Modul zurückzukehren.

Module

Benutzerdefinierten API-Aufruf erstellen

Mit diesem Aktionsmodul können Sie eine beliebige Adobe-API aufrufen. Es werden große Dateien anstelle von reinen Textkörpern unterstützt.

Dieses Modul wurde am 14. November 2024 zur Verfügung gestellt. Jedes Adobe Authenticator-Modul > Erstellen eines benutzerdefinierten API-Aufrufs, der vor diesem Datum konfiguriert wurde, verarbeitet keine großen Dateien und wird jetzt als Modul Erstellen eines benutzerdefinierten API-Aufrufs (Legacy) betrachtet.

Verbindung
Anweisungen zum Erstellen einer Verbindung zum Adobe Authenticator-Modul finden Sie unter Erstellen einer Verbindung in diesem Artikel.
Basis-URL
Geben Sie die Basis-URL des API-Punkts ein, mit dem Sie eine Verbindung herstellen möchten.
URL
Geben Sie den Pfad relativ zur Basis-URL ein.
Methode
Wählen Sie die HTTP-Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP-Anfragemethoden.
Header

Fügen Sie die Header der Anfrage in Form eines standardmäßigen JSON-Objekts hinzu.

Beispiel: {"Content-type":"application/json"}

Workfront Fusion fügt automatisch Autorisierungs-Header hinzu.

Abfragezeichenfolge
Geben Sie die Abfragezeichenfolge der Anfrage ein.
Texttyp

Wählen Sie den Texttyp für diese API-Anfrage:

  • Raw
  • application/x-www-form-urlencoded
  • multipart/form-data
Ausgabetyp
Wählen Sie den Datentyp aus, den das Modul ausgeben soll. Wenn Sie keinen Typ auswählen, wählt das Modul automatisch einen Typ aus.

Erstellen eines benutzerdefinierten API-Aufrufs (veraltet)

Mit diesem Aktionsmodul können Sie eine beliebige Adobe-API aufrufen.

Verbindung
Anweisungen zum Erstellen einer Verbindung zum Adobe Authenticator-Modul finden Sie unter Erstellen einer Verbindung in diesem Artikel.
Basis-URL
Geben Sie die Basis-URL des API-Punkts ein, mit dem Sie eine Verbindung herstellen möchten.
URL
Geben Sie den Pfad relativ zur Basis-URL ein.
Methode
Wählen Sie die HTTP-Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP-Anfragemethoden.
Header

Fügen Sie die Header der Anfrage in Form eines standardmäßigen JSON-Objekts hinzu.

Beispiel: {"Content-type":"application/json"}

Workfront Fusion fügt automatisch Autorisierungs-Header hinzu.

Abfragezeichenfolge
Geben Sie die Abfragezeichenfolge der Anfrage ein.
Text

Fügen Sie den Textinhalt für den API-Aufruf in Form eines standardmäßigen JSON-Objekts hinzu.

Hinweis:

Wenn Sie bedingte Anweisungen wie if in Ihrem JSON-Objekt verwenden, setzen Sie die Anführungszeichen außerhalb der bedingten Anweisung.

Erstellen eines benutzerdefinierten API-Aufrufs (Abfrage)

Dieses Modul führt einen benutzerdefinierten Aufruf aus und enthält die Option, den Aufruf wiederholt auszuführen, bis eine bestimmte Bedingung erfüllt ist oder ein definiertes Limit erreicht wurde.

Verbindung
Anweisungen zum Erstellen einer Verbindung zum Adobe Authenticator-Modul finden Sie unter Erstellen einer Verbindung in diesem Artikel.
Basis-URL
Geben Sie die Basis-URL des API-Punkts ein, mit dem Sie eine Verbindung herstellen möchten.
URL
Geben Sie den Pfad relativ zur Basis-URL ein.
Methode
Wählen Sie die HTTP-Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP-Anfragemethoden.
Header

Fügen Sie die Header der Anfrage in Form eines standardmäßigen JSON-Objekts hinzu.

Beispiel: {"Content-type":"application/json"}

Workfront Fusion fügt automatisch Autorisierungs-Header hinzu.

Abfragezeichenfolge
Geben Sie die Abfragezeichenfolge der Anfrage ein.
Texttyp

Wählen Sie den Texttyp für diese API-Anfrage:

  • Raw
  • application/x-www-form-urlencoded
  • multipart/form-data
Wiederholen bis

Konfigurieren Sie einen bedingten Filter, der bestimmt, wann der Abruf beendet werden soll. Sie können Antwortdaten mit Punktnotation referenzieren (z. B. body.status, body.data.state oder headers.status). Die Bedingung wird nach jeder Ausführung ausgewertet, und der Abruf wird fortgesetzt, bis die Bedingung als true ausgewertet wird. Folgende Operatoren werden unterstützt: Equal to, Not equal to, Exists, Does not exist

Sie können beispielsweise body.status not equal completed so einstellen, dass der Abruf fortgesetzt wird, bis die API-Antwort anzeigt, dass der Prozess abgeschlossen ist.

Wiederholungsverzögerung
Geben Sie die Verzögerung zwischen den Ausführungen in Sekunden ein oder ordnen Sie sie zu.
Wiederholungsgrenze
Geben Sie die maximale Häufigkeit ein, mit der der API-Aufruf ausgeführt werden soll, oder mappen Sie sie.
Ausgabetyp
Wählen Sie den Datentyp aus, den das Modul ausgeben soll. Wenn Sie keinen Typ auswählen, wählt das Modul automatisch einen Typ aus.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3