DocumentationWorkfrontWorkfront Guide

Adobe Authenticator modules

Last update: Thu Nov 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User

The Adobe Authenticator module allows you to connect to any Adobe API, using a single connection. This allows you to more easily connect to Adobe products that do not yet have a dedicated Fusion connector.

The advantage over the HTTP modules is that you can create a connection, as in a dedicated app.

To see a list of available Adobe APIs, see Adobe APIs. You may be able to use only the APIs to which you are assigned.

Access requirements

Adobe Workfront plan

New: Any

Or

Current: Pro or higher

Adobe Workfront license

New: Standard

Or

Current: Plan, Work

Adobe Workfront Fusion license

Current Fusion license requirement: No Workfront Fusion license requirement.

Or

Legacy Fusion license requirement: Workfront Fusion for Work Automation and Integration

Product

New Workfront plan: If you have the Select or Prime Adobe Workfront Plan, your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described in this article. Workfront Fusion is included in the Ultimate Workfront plan.

Or

Current Workfront plan: Your organization must purchase Adobe Workfront Fusion as well as Adobe Workfront to use functionality described in this article.

Prerequisites

  • You must have access to the Adobe product that you want the module to connect to.

  • You must have access to the Adobe Developer Console.

  • You must have a project on the Adobe Developer Console that includes the API that you want the module to connect to. You can:

    • Create a new project with the API.

      Or

    • Add the API to an existing project.

    For information on creating or adding an API to a project on the Adobe Developer Console, see Create a project in the Adobe documentation.

Create a connection

An Adobe Authenticator connection connects to a single project on the Adobe Developer Console. To use the same connection for more than one Adobe API, add the APIs to the same project, and create a connection to that project.

You can create separate connections to separate projects, but you cannot use a connection to access an API that is not on the project specified in that connection.

IMPORTANT
With the Adobe Authenticator connector, you have the choice between making an OAuth Server-to-server connection, or a Service Account (JWT) connection. Adobe has deprecated JWT credentials, which will stop working after January 1, 2025. Therefore, we highly recommend creating OAuth connections.
For more information on these types of connections, see Server to Server authentication in the Adobe documentation

To create a connection:

  1. In any Adobe Authenticator module, click Add next to the Connection field.

  2. Fill in the following fields:

    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 11-row-2 12-row-2 layout-auto html-authored no-header
    Connection type Select whether you want to create an OAuth Server-to-Server connection, or a service account (JWT) connection.
    Connection name Enter a name for this connection.
    Client ID Enter your Adobe Client ID. This can be found in the Credentials details section of the Adobe Developer Console.
    Client Secret Enter your Adobe Client Secret. This can be found in the Credentials details section of the Adobe Developer Console.
    Scopes If you have selected an OAuth connection, enter the scopes needed for this connection.
    Technical account ID Enter your Adobe Technical account ID. This can be found in the Credentials details section of the Adobe Developer Console.
    Organization ID If you have selected a JWT connection, enter your Adobe Organization ID. This can be found in the Credentials details section of the Adobe Developer Console.
    Meta Scopes If you have selected a JWT connection, enter the meta scopes needed for this connection.
    Private key

    If you have selected a JWT connection, enter the private key that was generated when your credentials were created in the Adobe Developer Console.

    To extract your private key or certificate:

    1. Click Extract.

    2. Select the type of file you are extracting.

    3. Select the file that contains the private key or certificate.

    4. Enter the password for the file.

    5. Click Save to extract the file and return to the connection setup.
    Base URLs

    You must add the base URLs that you want this authenticator to allow. When using the Make a custom API call module later in the scenario, you will add a relative path to the chosen URL. By entering URLs here, you can control what the Make a custom API call module can connect to, which increases security.

    For each base URL that you want to add to the authenticator, click Add item and enter the base URL.
    Authentication URL Leave this blank to use the standard Adobe IMS authentication URL of https://ims-na1.adobelogin.com. If you do not use Adobe IMS for authentication, enter the URL to use for authentication.
    Environment Select whether you are connecting to a production or non-production environment.
    Type Select whether you are connecting to a service account or a personal account.

  3. Click Continue to save the connection and return to the module.

Modules

Make a custom API call

This action module allows you to make a call to any Adobe API. It supports large files, instead of text-only bodies.

This module was made available on November 14, 2024. Any Adobe Authenticator > Make a custom API call configured before this date does not handle large files, and is now considered the Make a custom API call (Legacy) module.

Connection
For instructions on creating a connection to the Adobe Authenticator module, see Create a connection in this article.
Base URL
Enter the base URL of the API point you want to connect to.
URL
Enter the path relative to the base URL.
Method
Select the HTTP request method you need to configure the API call. For more information, see HTTP request methods in Adobe Workfront Fusion.
Headers

Add the headers of the request in the form of a standard JSON object.

For example, {"Content-type":"application/json"}

Workfront Fusion adds authorization headers automatically.

Query String
Enter the request query string.
Body Type

Select the body type for this API request:

  • application/x-www-form-urlencoded
  • Raw
  • multipart/form-data
Fields
For each file that you want to add to the APU request, click Add item and enter the text of the file (for raw data), or enter the key uploadedFile and map the file's data.

Make a custom API call (Legacy)

This action module allows you to make a call to any Adobe API.

Connection
For instructions on creating a connection to the Adobe Authenticator module, see Create a connection in this article.
Base URL
Enter the base URL of the API point you want to connect to.
URL
Enter the path relative to the base URL.
Method
Select the HTTP request method you need to configure the API call. For more information, see HTTP request methods in Adobe Workfront Fusion.
Headers

Add the headers of the request in the form of a standard JSON object.

For example, {"Content-type":"application/json"}

Workfront Fusion adds authorization headers automatically.

Query String
Enter the request query string.
Body

Add the body content for the API call in the form of a standard JSON object.

Note:

When using conditional statements such as if in your JSON, put the quotation marks outside of the conditional statement.

Limit
Enter the maximum number of results that you want the module to return in one execution cycle.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43