Módulo HTTP > Make an OAuth 2.0 request
Para fazer uma solicitação HTTP(S) Adobe Workfront Fusion para servidores que exigem uma autorização OAuth 2.0, primeiro é necessário criar uma conexão OAuth. Adobe Workfront Fusion garante que todas as chamadas feitas com esta conexão tenham os cabeçalhos de autorização apropriados e atualizem automaticamente os tokens associados quando necessário.
Workfront Fusion oferece suporte aos seguintes fluxos de autenticação do OAuth 2.0:
- Fluxo de código de autorização
- Fluxo implícito
Outros fluxos, como Fluxo de Credenciais de Senha do Proprietário do Recurso e Fluxo de Credenciais do Cliente, não são automaticamente compatíveis por meio desse módulo.
Para obter mais informações sobre a autenticação OAuth 2.0, consulte A Estrutura de Autorização OAuth 2.0.
Requisitos de acesso
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:
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 Adobe Workfront Fusion licenças, consulte Adobe Workfront Fusion licenças.
Criar uma conexão para uma solicitação OAuth
- Instruções gerais para criar uma conexão no HTTP > Criar um módulo de solicitação OAuth 2.0
- Instruções para criar uma conexão com o Google no HTTP >Make um módulo de solicitação OAuth 2.0
- Instruções para conexão com a API Graph do Microsoft por meio do HTTP > Criar um módulo de solicitação OAuth 2.0
Instruções gerais para criar uma conexão no módulo HTTP > Make an OAuth 2.0 request
-
Crie um cliente OAuth no serviço target com o qual você deseja que Adobe Workfront Fusion se comunique. Esta opção provavelmente foi encontrada na seção Developer do serviço fornecido.
-
Ao criar um cliente, insira a URL apropriada no campo
Redirect URL
ouCallback URL
:table 0-row-2 1-row-2 Américas / APAC https://app.workfrontfusion.com/oauth/cb/oauth2
EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2
-
Após a criação do cliente, o serviço fornecido exibe duas chaves:
Client ID
eClient Secret
. Alguns serviços chamam estesApp Key
eApp Secret
. Salve a chave e o segredo em um local seguro, para que você possa fornecê-los ao criar a conexão no Workfront Fusion.
-
-
Localize o
Authorize URI
eToken URI
na documentação de API do serviço especificado. Esses são endereços de URL através dos quais Workfront Fusion se comunica com o serviço target. Os endereços são usados para autorização OAuth.note note NOTE Se o serviço usar o Fluxo implícito, você precisará somente do Authorize URI
. -
(Condicional) Se o serviço de destino usa escopos (direitos de acesso), verifique como o serviço separa escopos individuais e certifique-se de definir o separador nas configurações avançadas adequadamente. Se o separador não estiver definido corretamente, Workfront Fusion falhará ao criar a conexão e você receberá um erro de escopo inválido.
-
Após concluir as etapas acima, você pode começar a criar a conexão OAuth em Workfront Fusion. Adicione o HTTP > Criar um módulo de solicitação OAuth 2 ao seu cenário.
-
No campo Conexão do módulo, clique em Add.
-
Preencha os seguintes campos para criar uma conexão:
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 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 18-row-2 layout-auto html-authored no-header Connection name Insira o nome da conexão. Environment Selecione se você está usando um ambiente de produção ou não. Type Selecione se você está usando uma conta de serviço ou uma conta pessoal. Flow type Selecione o fluxo para obter tokens.
- Authorization Code: insira o
Authorize URI
eToken URI
da documentação da API do serviço. - Implicit: insira o
Authorize URI
na documentação da API do serviço.
Scope Adicionar escopos individuais. Você pode encontrar essas informações na documentação do desenvolvedor (API) do serviço específico. Scope separator Selecione os escopos inseridos acima que devem ser separados por. Você pode encontrar essas informações na documentação do desenvolvedor (API) do serviço específico.
Aviso: se o separador não estiver definido corretamente, Workfront Fusion falhará ao criar a conexão e você receberá um erro de escopo inválido.
Client ID Insira a ID do cliente. Você obteve a ID do cliente ao criar um cliente OAuth no serviço que deseja conectar. Client Secret Digite o segredo do cliente. Você obteve o Segredo do cliente ao criar um cliente OAuth no serviço que deseja conectar. Authorize parameters Adicione os parâmetros que deseja incluir na chamada de autorização. Os seguintes parâmetros padrão são sempre incluídos automaticamente e não precisam ser adicionados.
Parâmetros padrão:
-
response_type
code
para Authorization Code flow etoken
para Implicit flow -
redirect_uri
table 0-row-2 1-row-2 layout-auto html-authored no-header Américas / APAC https://app.workfrontfusion.com/oauth/cb/oauth2 EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2 -
client_id
A ID do cliente recebida ao criar a conta
Access token parameters Adicione os parâmetros que deseja incluir na chamada de token. Os seguintes parâmetros padrão são sempre incluídos automaticamente e não precisam ser adicionados.
Parâmetros padrão:
-
grant_type:
authorization_code
-
redirect_uri:
table 0-row-2 1-row-2 layout-auto html-authored no-header Américas / APAC https://app.workfrontfusion.com/oauth/cb/oauth2 EMEA https://app-eu.workfrontfusion.com/oauth/cb/oauth2 -
client_id: a ID do cliente recebida ao criar a conta é incluída automaticamente no corpo da solicitação
-
client_secret: o Segredo do Cliente recebido ao criar a conta é automaticamente incluído no corpo da solicitação
-
código: o código retornado pela solicitação de autorização
Nota:
O padrão OAuth 2.0 oferece suporte a pelo menos dois métodos de autenticação de cliente durante esta etapa (
client_secret_basic
eclient_secret_post
). Workfront Fusion envia automaticamente a ID de cliente e a senha especificadas pelo métodoclient_secret_post
. Portanto, esses parâmetros são incluídos automaticamente como parte do corpo da solicitação de token.Para obter mais informações sobre a autenticação OAuth 2.0, consulte A Estrutura de Autorização OAuth 2.0.
Refresh token parameters Adicione os parâmetros que deseja incluir na chamada de token. Os seguintes parâmetros padrão são sempre incluídos automaticamente e não precisam ser adicionados.
Parâmetros padrão:
-
grant_type:
refresh_token
-
refresh_token: o token de atualização mais recente obtido pelo serviço ao qual você está se conectando
-
client_id: a ID do cliente recebida ao criar a conta é incluída automaticamente no corpo da solicitação
-
client_secret: o segredo do cliente recebido ao criar a conta é incluído automaticamente no corpo da solicitação
Nota:
O padrão OAuth 2.0 oferece suporte a pelo menos dois métodos de autenticação de cliente durante esta etapa (
client_secret_basic
eclient_secret_post
). Workfront Fusion envia automaticamente a ID de cliente e a senha especificadas pelo métodoclient_secret_post
. Portanto, esses parâmetros são incluídos automaticamente como parte do corpo da solicitação de token.Para obter mais informações sobre a autenticação OAuth 2.0, consulte A Estrutura de Autorização OAuth 2.0.
Custom Headers Especifique quaisquer chaves e valores adicionais para incluir no cabeçalho das etapas Token e Refresh Token.
Nota:
O padrão OAuth 2.0 oferece suporte a pelo menos dois métodos de autenticação de cliente durante esta etapa (
client_secret_basic
eclient_secret_post
). Workfront Fusion não dá suporte automático ao métodoclient_secret_basic
. Se o serviço ao qual você está se conectando espera que a ID do cliente e o Segredo do cliente sejam combinados em uma única cadeia de caracteres e, em seguida, codificada em base64 no cabeçalho de Autorização, adicione esse cabeçalho e o valor da chave aqui.Para obter mais informações sobre a autenticação OAuth 2.0, consulte A Estrutura de Autorização OAuth 2.0.
Token placement Selecione se deseja enviar o token no header, query string ou em ambos ao conectar-se à URL especificada.
Os tokens são enviados com mais frequência no cabeçalho da solicitação.
Header token name Insira o nome do token de autorização no cabeçalho. Padrão: Bearer
.Query string parameter name Insira o nome do token de autorização na cadeia de caracteres de consulta. Padrão: access_token
. - Authorization Code: insira o
-
Clique em Continue para salvar a conexão e retornar ao módulo.
-
Continue em Configurar o módulo Criar uma solicitação OAuth 2.0.
Instruções para criar uma conexão com Google em HTTP >Make an OAuth 2.0 request module
O exemplo a seguir mostra como usar o módulo de solicitação HTTP > Make an OAuth 2.0 para se conectar a Google.
-
Verifique se você criou um projeto, definiu as configurações de OAuth e gerou suas credenciais conforme descrito no artigoConectar Adobe Workfront Fusion a Google Services usando um cliente OAuth personalizado.
-
Abra o módulo HTTP > Make an OAuth 2.0 request.
-
Clique em Add ao lado da caixa de conexão.
-
Insira os seguintes valores:
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 name Insira um nome para a conexão. Environment Selecione se você está usando um ambiente de produção ou não. Type Selecione se você está usando uma conta de serviço ou uma conta pessoal. Flow type Authorization Code Authorize URI https://accounts.google.com/o/oauth2/v2/auth
Token URI https://www.googleapis.com/oauth2/v4/token
Scope Adicionar escopos individuais. Para obter mais informações sobre escopos, consulte Escopos do OAuth 2.O para Google APIs na documentação do Google. Scope separator SPACE Client ID Insira sua ID de cliente do Google.
Para criar uma ID de cliente, consulte Criar credenciais OAuth no artigo Connect Adobe Workfront Fusion para Google Services usando um cliente OAuth personalizado.
Client Secret Insira seu Segredo do Cliente do Google.
Para criar um segredo de cliente, consulte Criar credenciais OAuth no artigo Connect Adobe Workfront Fusion para Google Serviços usando um cliente OAuth personalizado.
Authorize parameters Adicionar
access_type
-offline
par de valor-chave.Observação: se você tiver problemas de autenticação, por exemplo, com a atualização de token, tente adicionar o par de valores-chave
prompt
-consent
. -
Clique em Continue para salvar as configurações de conexão.
-
Continue em Configurar o módulo Criar uma solicitação OAuth 2.0.
Configurar o módulo Criar uma solicitação do OAuth 2.0
Depois de estabelecer uma conexão OAuth 2.0, continue configurando o módulo conforme desejado. Todos os tokens de autorização são incluídos automaticamente nessa solicitação e em qualquer outra solicitação que use a mesma conexão.
Ao configurar o módulo HTTP > Make an OAuth 2.0 request, o Workfront Fusion exibe os campos listados abaixo. Um título em negrito em um módulo indica um campo obrigatório.
Se você vir o botão de mapa acima de um campo ou função, poderá usá-lo para definir variáveis e funções para esse campo. Para obter mais informações, consulte Mapear informações de um módulo para outro em Adobe Workfront Fusion.