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 para a funcionalidade neste artigo.

Você deve ter o seguinte acesso para usar a 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
Licença do Adobe Workfront

Novo: Padrão

Ou

Atual: trabalho ou superior

Licença do Adobe Workfront Fusion**

Atual: nenhum requisito de licença do Workfront Fusion

Ou

Herdados: Automação e integração do Workfront Fusion for Work

Produto

Novo menu:

  • Selecionar ou pacote do Prime Workfront: sua organização deve comprar o Adobe Workfront Fusion.
  • Pacote do Ultimate Workfront: o Workfront Fusion está incluído.

Ou

Atual: sua organização deve comprar o Adobe Workfront Fusion.

Para obter mais detalhes sobre as informações 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
    Tipo de conexão 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.
    Nome da Conexão Insira um nome para esta conexão.
    ID do Cliente Insira sua ID de cliente do Adobe. Isso pode ser encontrado na seção Credentials details do Adobe Developer Console.
    Segredo do Cliente Insira seu Segredo do Cliente do Adobe. Isso pode ser encontrado na seção Credentials details do Adobe Developer Console.
    Escopos 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. Isso pode ser encontrado 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. Isso pode ser encontrado na seção Credentials details do Adobe Developer Console.
    Metaescopos Se você selecionou uma conexão JWT, insira os metaescopos necessários para essa conexão.
    Chave privada

    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 sua chave privada ou 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. Digite a senha do arquivo.

    5. Clique em Salvar 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.

    URL de Autenticação 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).

Conexão
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.
Método
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.
Cabeçalhos

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.

Cadeia de Consulta
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.

Conexão
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.
Método
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.
Cabeçalhos

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.

Cadeia de Consulta
Insira a string de consulta da solicitação.
Corpo

Adicione o conteúdo do corpo para a chamada à 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.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3