Configurar conexão do Microsoft SharePoint Graph

  • Versão de lançamento: Yokohama
  • Atualizado 1 de fev. de 2024
  • 3 min. de leitura
  • Configure uma conexão Microsoft do SharePoint Graph e um registro de conexão que permite que sua instância ServiceNow se integre ao Microsoft SharePoint usando o Microsoft Graph.

    Antes de Iniciar

    • Solicitar uma assinatura de Integration Hub.
    • Ative o Spoke do Microsoft SharePoint Online.
    • Acesso ao portal do Microsoft Azure.
    • Crie uma aplicação OAuth no portal do Azure Microsoft.
    • Função necessária: administrador

    Procedimento

    1. Configure uma conexão do SharePoint Graph adicionando permissões.
      1. Faça login no https://portal.azure.com/.
      2. Selecione Registros de app.
        Botão de registro do app.
      3. Selecione Todas as aplicações ou Aplicações próprias.
        Opções de seleção da aplicação OAuth.
      4. No campo de pesquisa, insira o nome da aplicação OAuth que você criou.
        Para saber como configurar uma aplicação OAuth, consulte Configurar a aplicação OAuth no Microsoft Azure.
      5. Nos resultados da pesquisa, selecione o nome da aplicação OAuth que você configurou.
      6. No painel esquerdo, no título Gerenciar, selecione Permissões de API.
        Link de permissões de API.
      7. No título Permissões configuradas, selecione + Adicionar uma permissão.
      8. Na janela Solicitar permissões de API, selecione Microsoft Graph.
        Botão do Microsoft Graph.
      9. Selecione Permissões delegadas.
      10. No título Selecionar permissões, insira site no campo de pesquisa.
      11. Expanda a lista de sites.
        Lista de locais.
      12. Selecione Sites.FullControl.all, Sites.Read.All e Sites.ReadWrite.All.
        Permissões do site do Graph Spoke do Microsoft SharePoint Online.
      13. No título Selecionar permissões, insira User.read no campo de pesquisa.
        Permissões do usuário do gráfico do Spoke do Microsoft SharePoint Online.
      14. Selecione Adicionar permissões.
        A permissão foi adicionada.

        Permissões adicionadas.

      15. Opcional: Para conceder o consentimento do administrador, no título Permissões configuradas, selecione Conceder consentimento do administrador.
      16. Opcional: Selecione Sim.
        O consentimento do administrador será obrigatório se o valor na coluna Consentimento do administrador necessário para a permissão Sites.Read.All for Sim.
    2. Configure o registro de conexão do Microsoft SharePoint Graph.
      1. Faça login na sua instância ServiceNow.
        Nota:
        O URL da instância e o da instância que você forneceu como o URL de redirecionamento devem ser os mesmos.
      2. Navegar até Tudo > Automação de Processo > Workflow Studio.
      3. Selecione a guia Integrações.
      4. No campo Pesquisar todas as conexões, insira Microsoft SharePoint.
        Nota:
        A guia Saída é selecionada por padrão. Confirme se a guia Saída já está selecionada.
      5. No campo Pesquisar todas as conexões, insira Microsoft SharePoint.
      6. No bloco MicrosoftSharePointGraph, clique em Exibir detalhes.
        Botão Exibir detalhes no alias do Microsoft SharePoint Graph.
      7. Clique em Configurar.
        Botão Configurar.
      8. No formulário, preencha estes detalhes.
        Campo Descrição
        Nome da Conexão O nome do registro de conexão. O nome padrão e somente leitura do primeiro registro de conexão é MicrosoftSharePointGraph. Para fornecer um nome personalizado, você deve criar um registro de conexão clicando em Adicionar conexão.
        URL de conexão O URL para se conectar às APIs do Microsoft Graph. O URL é https://graph.microsoft.com/v1.0.
        Nome da entidade OAuth Nome da aplicação OAuth que você criou. Para saber como criar um aplicativo OAuth, consulte Configurar a aplicação OAuth no Microsoft Azure.
        ID do cliente do OAuth ID de cliente que foi gerado quando você criou o aplicativo OAuth. Para saber onde encontrar o ID do cliente, consulte Configurar a aplicação OAuth no Microsoft Azure.
        Segredo do cliente do OAuth Segredo do cliente que foi gerado quando você criou o aplicativo OAuth. Para saber onde encontrar o ID do cliente, consulte Configurar a aplicação OAuth no Microsoft Azure.
        URL de autorização do OAuth A URL deve estar no formato: https://login.microsoftonline.com/<tenant-id> /oauth2/v2.0/authorize?response_mode=query .
        Dica:
        Para encontrar o ID do locatário, siga as etapas.
        1. Faça login no https://portal.azure.com/.
        2. No título Gerenciar Azure Active Directory, selecione Exibir.

          A ID do locatário está disponível no título Informações básicas.

          ID do locatário.

        URL do token OAuth A URL deve estar no formato: https://login.microsoftonline.com/<tenant-id> /oauth2/v2.0/token .
        Dica:
        Para encontrar o ID do locatário, siga as etapas.
        1. Faça login no https://portal.azure.com/.
        2. No título Gerenciar Azure Active Directory, selecione Exibir.

          A ID do locatário está disponível no título Informações básicas.

          ID do locatário.

        URL de revogação do token A URL deve estar no formato: https://login.microsoftonline.com/<tenant-id> /oauth2/v2.0/token .
        Dica:
        Para encontrar o ID do locatário, siga as etapas.
        1. Faça login no https://portal.azure.com/.
        2. No título Gerenciar Azure Active Directory, selecione Exibir.

          A ID do locatário está disponível no título Informações básicas.

          ID do locatário.

        URL de redirecionamento do OAuth O URL deve estar no formato: https://<instance-name> .service-now.com/oauth_redirect.do .
        Formulário de conexão do Microsoft SharePoint Graph.
      9. Selecione Configurar e obter token do OAuth.
    3. Clique em Configurar e obter token do OAuth.
      O registro de conexão foi criado.

      Conexão criada.

    4. Para usar a ação Microsoft Graph, crie um registro na tabela de locatário (sn_sp_spoke_tenant) em sua instância ServiceNow.
      Nota:
      Depois de configurar e obter o token OAuth, um registro da aplicação será criado com os detalhes fornecidos. Neste registro de aplicação, não selecione nenhum script de API OAuth.