Configurar registro de conexão do Microsoft SharePoint Online

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

    • Integre sua instância [ ServiceNow ao Microsoft SharePoint Online configurando o Microsoft SharePoint Online e um registro de conexão.

    Antes de Iniciar

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

    Gerar certificado para Windows

    Gere um arquivo de certificado digital no formato .cer para carregá-lo no Microsoft Azure.

    Antes de Iniciar

    Função necessária: admin

    Procedimento

    1. Navegue até https://learn.microsoft.com/en-us/sharepoint/dev/solution-guidance/security-apponly-azuread#setting-up-an-azure-ad-app-for-app-only-access.
      1. Navegue até https://learn.microsoft.com/en-us/sharepoint/dev/solution-guidance/security-apponly-azuread#setting-up-an-azure-ad-app-for-app-only-access.
      2. Execute o script do PowerShell.
        O script gera dois arquivos com as extensões .PFX e .CER.
        Nota:
        Armazene ou lembre-se da senha usada para criptografar a chave privada para gerar o arquivo .PFX e os arquivos .CER.
      3. Use o arquivo .PFX para criar um arquivo Java Key Store (JKS).
        Nota:
        Armazene ou lembre-se da senha usada para gerar o arquivo .JKS a partir do arquivo .PFX.
    2. Execute o script do PowerShell.
      O script gera dois arquivos com as extensões .PFX e .CER.
      Nota:
      Armazene ou lembre-se da senha usada para criptografar a chave privada para gerar o arquivo .PFX e os arquivos .CER.
    3. Use o arquivo .PFX para criar um arquivo Java Key Store (JKS).
      Nota:
      Armazene ou lembre-se da senha usada para gerar o arquivo .JKS a partir do arquivo .PFX.

    Gerar certificado autoassinado para Mac

    Gere um arquivo de certificado digital no formato .cer para carregá-lo no Microsoft Azure.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Abra o terminal na sua máquina Mac.
    2. Executar o script keytool -genkey -keyalg RSA -alias selfsigned -keystore<filename> .jks -storepass<enter password for keystore> -validade 720 -keysize 2048 .
      Nota:
      A senha para o armazenamento de chaves deve conter pelo menos seis caracteres.
      O armazenamento de chaves solicita que você insira determinadas informações.
    3. Insira suas informações personalizadas, conforme fornecido na imagem para ilustração.Informações personalizadas de armazenamento de chaves.
    4. Pressione Retornar.
      É recomendável migrar para o formato PKCS12.
    5. Executar o script keytool -importkeystore -srckeystore<filename> .jks - destkeystore .jks - deststoretype pkcs12 .
    6. Insira a senha do armazenamento de chaves de origem.
      A migração para o PKCS12 foi bem-sucedida.
    7. Executar o script keytool -exportcert -keyalg RSA -alias selfsigned -keystore<filename> .jks -storepass<password to the keystore> -rfc -arquivo .cer .
      O script gera o arquivo .cer.
    8. Para localizar o arquivo .cer, navegue até o local no disco local.
      Local do arquivo .cer.

    Configurar uma aplicação no Microsoft Azure

    Crie um app personalizado usando o portal do Azure para autenticar solicitações.

    Antes de Iniciar

    • Acesso ao portal do Microsoft Azure
    • Função necessária: administrador

    Procedimento

    1. Carregue o certificado para o portal Microsoft Azure.
      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. No painel esquerdo, no título Gerenciar, selecione Certificados e segredos.
        Certificados e segredos.
      6. Em Certificados e segredos, selecione Certificados.
        Seção Certificado.
      7. Selecione Carregar certificado.
      8. Na janela Carregar certificado, selecione o ícone de pasta (ícone de pasta) para navegar até o arquivo .cer que você gerou.
      9. No campo Descrição, insira uma descrição do certificado.
      10. Selecione Adicionar.
        O certificado foi carregado.
      11. Na coluna Impressão digital, copie o valor da impressão digital e armazene-o em um local seguro.
        Valor de impressão digital.
        Nota:
        Certifique-se de copiar o valor inteiro de Thumbprint.

        Como alternativa, você pode copiar a impressão digital clicando em Manifesto.

        Copie o valor de Manifesto.

      12. Codifique o valor de impressão digital para um valor Base64 e registre o valor para uso posterior.
      Nota:
      Você pode usar uma ferramenta de conversão de hexadecimal para Base64 (Hex para Base64) para codificar o valor de impressão digital para um valor de Base64.
    2. Obtenha permissões para acessar as REST APIs de que o spoke precisa para automatizar ações.
      1. No painel esquerdo, no título Gerenciar, selecione Permissões de API.
        Link de permissões de API.
      2. No título Permissões configuradas, selecione + Adicionar uma permissão.
      3. Na janela Solicitar permissões de API, selecione SharePoint.
        Botão da API do SharePoint.
      4. Selecione Permissões da aplicação.
        Botão Permissões da aplicação.
      5. Expanda a lista de sites.
      6. Selecione Locais.ControleTotal.Todos.
        Sua instância da ServiceNow agora tem controle total de todos os sites no Microsoft SharePoint Online.
      7. Selecione Adicionar permissões.
        As permissões são adicionadas.

        Permissões online do SharePoint concedidas.

      8. Para conceder o consentimento do administrador, selecione Conceder consentimento do administrador para a ServiceNow.
      9. Na janela de confirmação Conceder consentimento ao administrador, selecione Sim.
        O consentimento do administrador foi concedido.

        Consentimento do administrador com status concedido.

    Anexação de um certificado Java Key Store

    Habilite a autenticação de token de Concessão de Portador JWT anexando um certificado Java Key Store (JKS) válido.

    Antes de Iniciar

    • Certificado Java Key Store válido
    • Função necessária: administrador

    Procedimento

    1. Navegar até Definição do Sistema > Certificados.
    2. Abra o registro Certificado do Microsoft SharePoint Online.
      Nota:
      Certifique-se de usar somente o registro padrão do Certificado do Microsoft SharePoint Online.
    3. Insira a senha associada ao arquivo JKS em Senha do armazenamento de chaves.
    4. Clique no ícone de anexos (ícone de anexos) e anexe o certificado JKS que você gerou.
      Para obter mais informações, consulte Configurar a aplicação OAuth no Microsoft Azure.
    5. Clique em Validar armazenamentos/certificados.
    6. Clique em Atualizar.

    Configurar a chave de assinatura JWT

    Crie uma chave de assinatura JWT (JSON Web Token) para atribuir ao seu certificado Java Key Store.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até OAuth de Sistema > Chaves de JWT.
    2. Abra o registro Chaves JWT do Microsoft SharePoint Online.
    3. Insira a senha usada para criptografar a chave privada para gerar os arquivos .PFX e .CER em Senha da chave de assinatura.
    4. Clique em Atualizar.

    Configurar o provedor JWT

    Adicione um provedor JSON Web Token (JWT) à sua instância da ServiceNow.

    Antes de Iniciar

    • Copie e registre o valor da ID da aplicação (cliente) e da IDdo diretório (locatário) da aplicação que você registrou no portal do Azure.
      Copie os valores de ID do cliente e ID do locatário.
    • Função necessária: administrador

    Procedimento

    1. Navegar até OAuth de Sistema > Provedores JWT.
    2. Abra o registro do Provedor JWT do Microsoft SharePoint Online.
    3. Insira valores para iss, sube aud na lista relacionada Declarações padrão.
      Campo Valor
      aud URL do Microsoft Online neste formato: https://login.microsoftonline.com/<tenant-id> /oauth2/token . Substituir<tenant-id> com o valor de ID de diretório (locatário) da sua aplicação registrado no portal do Azure.
      iss ID da aplicação (cliente) da aplicação que você registrou no portal do Azure.
      sub ID da aplicação (cliente) da aplicação que você registrou no portal do Azure.
    4. Clique em Atualizar.

    Registrar o Microsoft SharePoint Online como provedor OAuth

    Use as informações geradas durante a configuração da conta Microsoft SharePoint Online para registrar o Microsoft SharePoint Online como um provedor do OAuth e permitir que a instância solicite tokens do OAuth 2.0.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até OAuth de Sistema > Registro de aplicações.
    2. Clique em Nova.
      O sistema exibe a mensagem Que tipo de aplicação OAuth?
    3. Selecione Conectar-se a um provedor OAuth de terceiros.
      O sistema exibe um formulário de Registros de aplicações em branco.
    4. Insira estes valores.
      Campo Valor necessário
      Nome Nome para identificar exclusivamente o registro. Por exemplo, insira o perfil OAuth do SharePoint.
      ID de cliente ID do cliente neste formato:<ClientID> .
      Segredo do cliente Segredo do cliente que você criou durante a configuração da conta Microsoft SharePoint Online.
      Script do API da OAuth Selecione OAuthUtilSPJWTOnline.
      Tipo de concessão padrão Selecione Credenciais do Cliente.
      URL de Token URL do token neste formato: https://login.microsoftonline.com/<tenant-id> /oauth2/token . Substituir<tenant-id> com o valor de ID de diretório (locatário) da sua aplicação registrado no portal do Azure.
    5. Na lista relacionada Escopos de entidade OAuth, insira um registro com esses valores.
      Nome Escopo de OAuth
      scope https://<MS-SharePoint-tenant-name>.sharepoint.com/.default
      Insira o registro de escopo da entidade OAuth.
    6. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
      O sistema valida as credenciais do OAuth e cria a lista relacionada de perfis de entidade OAuth.

    Resultado

    A instância pode solicitar tokens OAuth 2.0 para o spoke.

    Criar registros de credenciais para o spoke do Microsoft SharePoint Online

    Crie registros de credencial para a aplicação OAuth personalizada Microsoft SharePoint Online que você criou durante a configuração da conta Microsoft SharePoint Online. Os aliases de conexão e credencial Spoke do Microsoft SharePoint Online usam essas credenciais para autorizar ações.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Conexões e Credenciais > Credenciais.
    2. Clique em Nova.
      O sistema exibe a mensagem Que tipo de credenciais você deseja criar?.
    3. Selecione Credenciais OAuth 2.0.
      A janela pop-up exibe um formulário em branco de Credenciais OAuth 2.0.
    4. Insira estes valores.
      Campo Valor necessário
      Nome Insira qualquer nome para identificar exclusivamente o registro. Por exemplo, insira Credenciais do SharePoint.
      Ativo Habilitar
      Perfil de Entidade OAuth Selecione o perfil OAuth que você criou ao registrar a aplicação personalizada Microsoft SharePoint Online como um provedor OAuth. Por exemplo, selecione o perfil OAuth do SharePoint.
      Aplica-se a Selecione os MID Servers que podem usar esta credencial. Por exemplo: selecione Todos os MID Servers.
      Ordem Selecione a ordem para aplicar esta credencial. Por exemplo: insira 100.
    5. Salve o registro.

    Criar registros de conexão para o spoke do Microsoft SharePoint Online

    Crie registros de conexão para sua conta Microsoft SharePoint Online. O alias de conexão e credencial Spoke do Microsoft SharePoint Online usa essas conexões para executar ações em Microsoft SharePoint Online.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Conexões e Credenciais > Aliases de conexão e credencial.
    2. Abra o registro de alias de conexão e credencial do MicrosoftSharePointOnline.
    3. Na guia Conexões, clique em Novo.
      O sistema exibe um formulário de conexão HTTP(s) em branco.
    4. No formulário, preencha os campos.
      Campo Valor necessário
      Nome Insira qualquer nome para identificar exclusivamente o registro de conexão. Por exemplo, insira Conexão do SharePoint.
      Credenciais Selecione o registro de credencial que você criou para Microsoft SharePoint Online. Por exemplo, selecione Credenciais do SharePoint.
      Alias de conexão Selecione o registro de alias de conexão que você criou para Microsoft SharePoint Online.
      Ativo Habilitar
      URL de Conexão Insira a URL raiz do SharePoint. Por exemplo, https://<SiteName> .sharepoint.com .
    5. Na guia Atributos, insira o valor codificado em Base64 de impressão digital.
      Nota:
      O valor de impressão digital é um valor hexadecimal. Você pode usar uma ferramenta de conversão de hexadecimal para Base64 (Hex para Base64) para codificar o valor de impressão digital para um valor de Base64.
    6. Clique em Enviar.
      A conta Microsoft SharePoint Online está integrada à sua instância ServiceNow e o spoke está pronto para ser usado.
      Nota:
      Se o single sign-on estiver configurado, configure seus fluxos para recuperar os detalhes do usuário de Microsoft SharePoint Online usando a ação spoke, Pesquisar informações de usuário por nome de login, para verificar se o usuário está autorizado a executar as ações necessárias.

    O que Fazer Depois

    1. Navegar até Conexões e Credenciais > Credenciais.
    2. Abra o registro de credencial que você criou. Por exemplo, Credenciais do SharePoint.
    3. Em Links relacionados, clique em Obter token OAuth.
      O sistema exibe uma mensagem de confirmação de que o fluxo de token OAuth foi concluído com sucesso. Revise os detalhes se o fluxo não tiver sido concluído com sucesso.
      Nota:
      Certifique-se de permitir janelas pop-up no navegador.
      A configuração do spoke está concluída e você pode usar os fluxos de acordo com seus requisitos.
      Nota:
      Se o token gerado não funcionar após a configuração do spoke, abra a aplicação OAuth no portal do Azure e marque as duas caixas de seleção em Concessão implícita e fluxos híbridos.Selecione os tokens no portal do Azure.