Módulos do Adobe Authenticator

O módulo Adobe Authenticator permite se conectar a qualquer API do Adobe, usando uma única conexão. Isso permite que você se conecte mais facilmente a produtos da Adobe que ainda não têm um conector Fusion dedicado.

A vantagem sobre os módulos HTTP é que você pode criar uma conexão, como em um aplicativo dedicado.

Para ver uma lista de APIs do Adobe disponíveis, consulte APIs do Adobe. Você pode usar somente as APIs às quais está atribuído.

Requisitos de acesso

Expanda para visualizar os requisitos de acesso da funcionalidade neste artigo.
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacote do Adobe Workfront

Qualquer pacote de fluxo de trabalho do Adobe Workfront e qualquer pacote do Adobe Workfront Automation and Integration

Workfront Ultimate

Os pacotes Workfront Prime e Select, com uma compra adicional do Workfront Fusion.

Licenças do Adobe Workfront

Padrão

Trabalho ou maior

Licença do Adobe Workfront Fusion

Baseado em operação: nenhum requisito de licença do Workfront Fusion

Baseado em conector (legado): Workfront Fusion for Work Automation and Integration

Produto Se sua organização tiver um pacote Workfront Select ou Prime, ele não inclui o Workfront Automation and Integration. É necessário comprar o Adobe Workfront Fusion.

Para obter mais detalhes sobre as informações contidas nesta tabela, consulte Requisitos de acesso na documentação.

Para obter informações sobre licenças do Adobe Workfront Fusion, consulte Licenças do Adobe Workfront Fusion.

Pré-requisitos

  • Você deve ter acesso ao produto Adobe ao qual deseja que o módulo se conecte.

  • Você deve ter acesso à Adobe Developer Console.

  • Você deve ter um projeto no Adobe Developer Console que inclua a API à qual deseja que o módulo se conecte. É possível:

    • Crie um novo projeto com a API.

      Ou

    • Adicionar a API a um projeto existente.

    Para obter informações sobre como criar ou adicionar uma API a um projeto no Adobe Developer Console, consulte Criar um projeto na documentação do Adobe.

Informações da API do Adobe Authenticator

O conector do Adobe Authenticator usa o seguinte:

Tag da API
v1.1.4

Criar uma conexão

Uma conexão do Adobe Authenticator se conecta a um único projeto na Adobe Developer Console. Para usar a mesma conexão para mais de uma API do Adobe, adicione as APIs ao mesmo projeto e crie uma conexão com esse projeto.

Você pode criar conexões separadas para projetos separados, mas não pode usar uma conexão para acessar uma API que não esteja no projeto especificado nessa conexão.

IMPORTANT
Com o conector do Adobe Authenticator, você tem a opção de fazer uma conexão servidor a servidor do OAuth ou uma conexão de conta de serviço (JWT). O Adobe substituiu as credenciais do JWT, que deixarão de funcionar após 1º de janeiro de 2025. Portanto, é altamente recomendável criar conexões OAuth.
Para obter mais informações sobre esses tipos de conexões, consulte Autenticação de Servidor para Servidor na documentação do Adobe

Para criar uma conexão:

  1. Em qualquer módulo do Adobe Authenticator, clique em Adicionar ao lado do campo Conexão.

  2. Preencha os seguintes campos:

    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
    Connection type Selecione se deseja criar uma conexão de servidor para servidor OAuth ou uma conexão de conta de serviço (JWT). Recomendamos criar conexões OAuth.
    Connection name Insira um nome para essa conexão.
    Client ID Insira sua ID de cliente do Adobe. Essa informação pode ser encontrada na seção Credentials details do Adobe Developer Console.
    Client Secret Insira seu Segredo do Cliente do Adobe. Essa informação pode ser encontrada na seção Credentials details do Adobe Developer Console.
    Scopes Se você selecionou uma conexão OAuth, insira os escopos necessários para essa conexão.
    ID da conta técnica Se você selecionou uma conexão JWT, digite sua ID de conta técnica do Adobe. Essa informação pode ser encontrada na seção Credentials details do Adobe Developer Console.
    ID da Organização Se você selecionou uma conexão JWT, insira sua ID da organização Adobe. Essa informação pode ser encontrada na seção Credentials details do Adobe Developer Console.
    Escopos do Meta Se você selecionou uma conexão JWT, insira os metaescopos necessários para essa conexão.
    Private key

    Se você selecionou uma conexão JWT, insira a chave privada que foi gerada quando suas credenciais foram criadas no Adobe Developer Console.

    Para extrair a chave privada ou o certificado:

    1. Clique em Extract.

    2. Selecione o tipo de arquivo que você está extraindo.

    3. Selecione o arquivo que contém a chave privada ou o certificado.

    4. Insira a senha do arquivo.

    5. Clique em Save para extrair o arquivo e retornar à configuração de conexão.

    URLs Base

    Você deve adicionar os URLs de base que este autenticador deve permitir. Ao usar o módulo Fazer uma chamada de API personalizada posteriormente no cenário, você adicionará um caminho relativo ao URL escolhido. Ao inserir URLs aqui, você pode controlar a que o módulo Fazer uma chamada de API personalizada pode se conectar, o que aumenta a segurança.

    Para cada URL base que você deseja adicionar ao autenticador, clique em Adicionar item e insira a URL base.

    Authentication URL Deixe em branco para usar a URL de autenticação padrão do Adobe IMS de https://ims-na1.adobelogin.com. Se você não usar o Adobe IMS para autenticação, insira o URL a ser usado para autenticação.
  3. Clique em Continuar para salvar a conexão e retornar ao módulo.

Módulos

Fazer uma chamada de API personalizada

Esse módulo de ação permite fazer uma chamada para qualquer API do Adobe. Ele suporta arquivos grandes, em vez de corpos somente texto.

Esse módulo foi disponibilizado em 14 de novembro de 2024. Qualquer chamada de Adobe Authenticator > Fazer uma API personalizada configurada antes dessa data não lida com arquivos grandes e agora é considerada o módulo Fazer uma chamada de API personalizada (Herdado).

Connection
Para obter instruções sobre como criar uma conexão com o módulo Adobe Authenticator, consulte Criar uma conexão neste artigo.
URL Base
Insira o URL de base do ponto de API ao qual você deseja se conectar.
URL
Insira o caminho relativo ao URL de base.
Method
Selecione o método de solicitação HTTP necessário para configurar a chamada de API. Para obter mais informações, consulte Métodos de solicitação HTTP.
Headers

Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão.

Por exemplo, {"Content-type":"application/json"}

O Workfront Fusion adiciona cabeçalhos de autorização automaticamente.

Query String
Insira a string de consulta da solicitação.
Tipo de Corpo

Selecione o tipo de corpo para esta solicitação de API:

  • Brutos
  • application/x-www-form-urlencoded
  • multipart/form-data
Tipo de Saída
Selecione o tipo de dados que você deseja que o módulo produza. Se você não selecionar um tipo, o módulo selecionará um tipo automaticamente.

Fazer uma chamada de API personalizada (herdado)

Esse módulo de ação permite fazer uma chamada para qualquer API do Adobe.

Connection
Para obter instruções sobre como criar uma conexão com o módulo Adobe Authenticator, consulte Criar uma conexão neste artigo.
URL Base
Insira o URL de base do ponto de API ao qual você deseja se conectar.
URL
Insira o caminho relativo ao URL de base.
Method
Selecione o método de solicitação HTTP necessário para configurar a chamada de API. Para obter mais informações, consulte Métodos de solicitação HTTP.
Headers

Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão.

Por exemplo, {"Content-type":"application/json"}

O Workfront Fusion adiciona cabeçalhos de autorização automaticamente.

Query String
Insira a string de consulta da solicitação.
Body

Adicione o conteúdo do corpo para a chamada de API na forma de um objeto JSON padrão.

Observação:

Ao usar instruções condicionais, como if em seu JSON, coloque as aspas fora da instrução condicional.

Fazer uma chamada de API personalizada (Polling)

Esse módulo faz uma chamada personalizada e inclui a opção de executar a chamada repetidamente até que uma condição específica seja atendida ou um limite definido seja atingido.

Connection
Para obter instruções sobre como criar uma conexão com o módulo Adobe Authenticator, consulte Criar uma conexão neste artigo.
URL Base
Insira o URL de base do ponto de API ao qual você deseja se conectar.
URL
Insira o caminho relativo ao URL de base.
Method
Selecione o método de solicitação HTTP necessário para configurar a chamada de API. Para obter mais informações, consulte Métodos de solicitação HTTP.
Headers

Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão.

Por exemplo, {"Content-type":"application/json"}

O Workfront Fusion adiciona cabeçalhos de autorização automaticamente.

Query String
Insira a string de consulta da solicitação.
Tipo de Corpo

Selecione o tipo de corpo para esta solicitação de API:

  • Brutos
  • application/x-www-form-urlencoded
  • multipart/form-data
Repetir Até

Configure um filtro condicional que determine quando a pesquisa deve ser interrompida. Você pode referenciar dados de resposta usando a notação de pontos (como body.status, body.data.state ou headers.status). A condição é avaliada após cada execução e a sondagem continua até que a condição seja avaliada como true. Os operadores suportados incluem: Equal to, Not equal to, Exists, Does not exist

Por exemplo, você pode configurar body.status not equal completed para manter a sondagem até que a resposta da API indique que o processo foi concluído.

Repetir Atraso
Insira ou mapeie o atraso entre as execuções, em segundos.
Limite de Repetição
Insira ou mapeie o número máximo de vezes que deseja que a chamada de API seja executada.
Tipo de Saída
Selecione o tipo de dados que você deseja que o módulo produza. Se você não selecionar um tipo, o módulo selecionará um tipo automaticamente.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3