Chamar a API REST do MS Graph
Muitos serviços da Web do Microsoft são acessados por meio da API do Microsoft Graph. É possível criar uma conexão com a API do Graph do Microsoft, usando o módulo de solicitação Workfront Fusion HTTP > Make an 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: Qualquer um |
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 licenças do Adobe Workfront Fusion, consulte licenças do Adobe Workfront Fusion.
Registrar o Workfront Fusion no Portal de Registro de Aplicativos do Microsoft
Para criar uma conexão com a API REST do Microsoft Graph, primeiro registre o Adobe Workfront Fusion.
-
Comece a registrar um novo aplicativo conforme descrito em Registre um aplicativo com a Microsoft identity platform na documentação do Microsoft.
Como parte do registro, o Microsoft exige as seguintes informações:
table 0-row-2 1-row-2 layout-auto html-authored no-header Nome do aplicativo Insira um nome para o aplicativo, como "Meu aplicativo do Workfront Fusion". Redirecionar URL https://app.workfrontfusion.com/oauth/cb/oauth2
-
Após concluir o registro do aplicativo, anote a ID do aplicativo.
note important IMPORTANT Você precisará da ID do aplicativo para configurar sua conexão no Workfront Fusion. -
Gerar um Segredo do Cliente. Anote este segredo.
Para obter instruções, consulte Registrar um aplicativo com a Microsoft identity platform na documentação do Microsoft.
note important IMPORTANT Você precisará do Segredo do cliente para configurar sua conexão no Workfront Fusion. -
Configure as permissões para seu aplicativo.
Para obter informações específicas sobre como localizar e configurar esses campos, consulte a seção "Configurar permissões para o Gráfico do Microsoft" em Obter acesso sem um usuário na documentação do Microsoft.
table 0-row-2 1-row-2 layout-auto html-authored no-header Que tipo de permissões seu aplicativo requer? Selecione Delegated permissions
.Selecionar permissões Selecione as seguintes permissões:
-
offline_access
-
openid
-
Quaisquer outras permissões necessárias às suas integrações (Exemplo:
User.Read
)
Importante: você precisará das permissões selecionadas para configurar sua conexão no Workfront Fusion.
-
-
Continue em Configurar sua conexão com a API do MS Graph no Workfront Fusion.
Configurar sua conexão da API do MS Graph no Workfront Fusion
Depois de registrar o Workfront Fusion como discutido em Registrar o Workfront Fusion no Portal de Registro de Aplicativos do Microsoft, você pode configurar sua conexão no módulo de solicitação HTTP > Criar um Oauth 2.0.
-
Adicione um HTTP > Faça um módulo de chamada OAuth 2.0 ao seu cenário.
-
Clique em Adicionar ao lado do campo de conexão.
-
Configure os campos de conexão da seguinte maneira:
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 layout-auto html-authored no-header Nome da conexão Insira um nome para a conexão. Ambiente Selecione se você está se conectando a uma conta 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. Tipo de fluxo Selecione Authorization Code
.Autorizar URI Digite https://login.microsoftonline.com/common/oauth2/v2.0/authorize
.URI do token Digite https://login.microsoftonline.com/common/oauth2/v2.0/token
.Escopo Insira as permissões que você selecionou ao se registrar, conforme discutido em Registrar o Workfront Fusion no Portal de Registro de Aplicativos do Microsoft.
Para cada escopo, clique em Adicionar e digite a permissão.
Exemplo:
offline_access
.Separador de escopo Selecione SPACE
.ID do cliente Insira a ID do Aplicativo da etapa 2 em Registrar o Workfront Fusion no Portal de Registro de Aplicativos do Microsoft. Segredo do cliente Insira o Segredo do Cliente gerado na etapa 3 em Registrar o Workfront Fusion no Portal de Registro de Aplicativos do Microsoft. Autorizar parâmetros Adicione os seguintes parâmetros Authorize. Para cada parâmetro que você está adicionando, clique em Adicionar item e insira o seguinte:
-
Chave:
response_mode
Valor:query
-
Chave:
prompt
Valor:consent
Parâmetros de token de acesso Não é necessário inserir nada nesse campo. Atualizar parâmetros de token -
Clique em Adicionar item.
-
No campo Chave, digite
scope
. -
No campo Valor, insira todos os escopos inseridos no campo de escopo, separados por espaços.
Exemplo:
offline_access openid User.Read
Cabeçalhos personalizados Não é necessário inserir nada nesse campo. Posicionamento do token In the header
-
-
Clique em Continuar.
-
Na janela exibida, clique em Aceitar para concluir a conexão e retornar ao módulo.