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

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: Qualquer um

Produto

Novo:

  • Selecione ou Prime Workfront Plan: sua organização deve comprar o Adobe Workfront Fusion.
  • Plano 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.

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.

  1. 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
  2. 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.
  3. 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.
  4. 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.

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

  1. Adicione um HTTP > Faça um módulo de chamada OAuth 2.0 ao seu cenário.

  2. Clique em Adicionar ao lado do campo de conexão.

  3. 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
    1. Clique em Adicionar item.

    2. No campo Chave, digite scope.

    3. 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
  4. Clique em Continuar.

  5. Na janela exibida, clique em Aceitar para concluir a conexão e retornar ao módulo.

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