Configurar conexão do Microsoft SharePoint Graph

  • Versão de lançamento: Washingtondc
  • 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 permita que sua instância ServiceNow se integre ao Microsoft SharePoint usando o Microsoft Graph.

    Antes de Iniciar

    • Solicite a assinatura do IntegrationHub.
    • Ativar 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 do 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.Read.All e Sites.ReadWrite.All.
        Permissões do site do gráfico do Microsoft SharePoint Online spoke.
      13. No título Selecionar permissões, insira User.read no campo de pesquisa.
        Permissões de usuário do gráfico do Microsoft SharePoint Online spoke.
      14. Selecione Adicionar permissões.
        A permissão é 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é Todos > Automação de Processo > Flow Designer.
    3. Navegar até Todos > Automação de Processo > Flow Designer.
    4. Clique na guia Conexões.
    5. No campo Pesquisar todas as conexões, insira Microsoft SharePoint.
    6. No cartão MicrosoftSharePointGraph, clique em Exibir detalhes.
    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 da 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 uma aplicação OAuth, consulte Configurar a aplicação OAuth no Microsoft Azure.
      ID do cliente OAuth ID do cliente que foi gerado quando você criou a aplicação OAuth. Para saber onde encontrar o ID do cliente, consulte Configurar a aplicação OAuth no Microsoft Azure.
      Segredo do cliente 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 O 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 estas etapas.
      1. Faça login no https://portal.azure.com/.
      2. No título Gerenciar Azure Active Directory, selecione Exibir.

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

        ID do locatário.

      URL do token Oauth O 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 estas etapas.
      1. Faça login no https://portal.azure.com/.
      2. No título Gerenciar Azure Active Directory, selecione Exibir.

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

        ID do locatário.

      URL de revogação do token O 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 estas etapas.
      1. Faça login no https://portal.azure.com/.
      2. No título Gerenciar Azure Active Directory, selecione Exibir.

        O 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 .
    9. Clique em Configurar e obter token do OAuth.
      O registro de conexão é criado.

      Conexão criada.

    10. Para usar a ação Microsoft Graph, crie um registro na tabela de locatários (sn_sp_spoke_tenant) na 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 OAuth API.