DocumentaçãoWorkfrontGuia do Workfront

Módulos do Adobe Authenticator

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

Criado para:

  • Usuário

O módulo Adobe Authenticator permite conectar-se a qualquer API de Adobe, usando uma única conexão. Isso permite que você se conecte mais facilmente a produtos 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 Adobe disponíveis, consulte APIs Adobe. Você pode usar somente as APIs às quais está atribuído.

Requisitos de acesso

Adobe Workfront plano

Novo: Qualquer um

Ou

Atual: Pro ou superior

Adobe Workfront licença

Novo: Padrão

Ou

Atual: Plano, Trabalho

Adobe Workfront Fusion licença

Requisito de licença Fusion atual: nenhum requisito de licença Workfront Fusion.

Ou

Requisito de licença herdado do Fusion: Workfront Fusion para Automação e Integração do Trabalho

Produto

Novo plano do Workfront: se você tiver o plano Select ou Prime Adobe Workfront, sua organização deve comprar Adobe Workfront Fusion e Adobe Workfront para usar a funcionalidade descrita neste artigo. Workfront Fusion está incluído no plano Workfront do Ultimate.

Ou

Plano atual do Workfront: sua organização deve comprar o Adobe Workfront Fusion e o Adobe Workfront para usar a funcionalidade descrita neste artigo.

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. Você pode:

    • 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.

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 de 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 descontinuou 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 11-row-2 12-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).
    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 Insira 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.
    Ambiente Selecione se você está se conectando a um ambiente de produção ou não produção.
    Tipo Selecione se você está se conectando a uma conta de serviço ou a uma conta pessoal.

  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 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 em Adobe Workfront Fusion.
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:

  • application/x-www-form-urlencoded
  • Brutos
  • multipart/form-data
Campos
Para cada arquivo que você deseja adicionar à solicitação APU, clique em Adicionar item e insira o texto do arquivo (para dados brutos), ou insira a chave uploadedFile e mapeie os dados do arquivo.

Fazer uma chamada de API personalizada (herdado)

Esse módulo de ação permite fazer uma chamada para qualquer API 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 em Adobe Workfront Fusion.
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.

Nota:

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

Limite
Insira o número máximo de resultados que você deseja que o módulo retorne em um ciclo de execução.
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43