Configurar a conexão do Graph para MS SharePoint

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura

    • Configure a conexão Graph na instância Now Platform para se comunicar com Microsoft SharePoint.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Para configurar o alias de conexão e credencial do gráfico usando o segredo do cliente, consulte Configure Microsoft SharePoint Online connection record.
      Siga as etapas abaixo para configurar a conexão do gráfico e o alias de credencial usando o certificado do cliente.
      Nota:
      Por padrão, o Provedor JWT, a Chave JWT e o Certificado, que estão configurados na conexão REST anterior, serão usados aqui neste procedimento. Para obter mais informações, consulte Configurar conexão REST para MS SharePoint.
      1. Navegar até Todos > Conexões e Credenciais > Aliases de conexões e credenciais.
      2. Abra o registro MicrosoftSharePointGraph.
      3. Clique no link relacionado Criar nova conexão e credencial.
      4. No formulário, preencha estes detalhes.
        Campo Descrição
        Nome da entidade OAuth Nome para identificar o registro da aplicação OAuth.
        ID do cliente OAuth ID de cliente
        Segredo do cliente OAuth Você pode inserir qualquer valor.
        Nota:
        Isso não é importante, pois você usará a autenticação baseada em certificados.
        URL de autorização do OAuth URL de autorização neste formato: https://login.microsoftonline.com/<tenant-id> /oauth2/v2.0/authorize?response_mode=query
        URL do token Oauth URL do token neste formato: https://login.microsoftonline.com/<tenant-id> /oauth2/v2.0/token
        URL de revogação do token URL de revogação do token neste formato: https://login.microsoftonline.com/<tenant-id> /oauth2/v2.0/token .
        URL de redirecionamento do OAuth ServiceNow URL de redirecionamento neste formato: https://empipaas.service-now.com/oauth_redirect.do
        Nota:
        Você pode alterar os valores padrão de acordo com seus requisitos.
      5. Clique em Criar e obter token do OAuth.
        Uma mensagem de erro é exibida solicitando 401- não autorizado.
      6. Recarregue o formulário e abra o registro na lista relacionada Conexões.
      7. Insira o valor de impressão digital codificado em Base64 no atributo Valor de impressão digital codificado na seção Atributos.
        Nota:
        O valor de impressão digital é um valor hexadecimal. Você pode usar uma ferramenta de conversão de hexadecimal para base64 (de hexadecimal para base64) para codificar o valor de impressão digital para um valor de base64.
      8. Navegar até Sistema OAuth > Registro de aplicações.
      9. Abra o registro que tem o mesmo nome de Nome da Entidade OAuth, que é a etapa d neste mesmo procedimento.
      10. Modifique o script da API OAuth para: OAuthUtilJWTFESPGraph
      11. Navegar até Conexões e Credenciais > Credenciais.
      12. Abra o registro: Credencial do Microsoft SharePoint Graph.
      13. Clique em Obter token OAuth na seção Links relacionados.
    2. Atualize o escopo da entidade OAuth.
      1. Navegar até Sistema OAuth > Registro de aplicações.
      2. Abra o registro da aplicação OAuth gerado na Etapa 1.
      3. Selecione a lista relacionada Escopos de Entidade OAuth.
      4. Substitua o campo de escopo do OAuth pelo seguinte valor offline_access : 
        https://graph.microsoft.com/Sites.ReadWrite.All
        Nota:
        Você pode ignorar a etapa 2 e passar para a próxima, se estiver adicionando um certificado de cliente.
    3. Configure um novo registro de locatário e selecione o registro de alias conforme criado na Etapa 1.
      Para obter mais informações, consulte Definir locatários do Microsoft SharePoint.
    4. Selecione o registro de locatário criado na etapa 3 como: Conexão do Graph ao preencher o formulário Configuração do repositório de arquivos.