Definir configurações de OAuth para resultados do Genius de perguntas e respostas de conteúdo externo

  • Versão de lançamento: Yokohama
  • Atualizado 6 de fev. de 2025
  • 5 min. de leitura

    • Defina as configurações de que os resultados do Genius das perguntas e respostas de conteúdo externo precisam para interagir com sua instância Microsoft SharePoint Online.

    Antes de Iniciar

    O Now Assist na aplicação Pesquisa com IA ServiceNow® Store deve ser instalado na sua instância. Para detalhes sobre a instalação dessa aplicação, consulte Instalar Now Assist no Pesquisa com IA.

    Você já deve ter concluído as seguintes tarefas:
    • Solicitar a instalação do plug-in ServiceNow IntegrationHub Enterprise Pack Installer [com.glide.hub.integrations.enterprise]
    Você precisará de acesso de leitura às seguintes definições de configuração do Portal Microsoft Azure para sua instância Microsoft SharePoint Online :
    • URL do site raiz
    • ID de cliente
    • Segredo do cliente
    • ID de locatário
    • URL de Autorização
    • URL de Token
    • URL de revogação do token
    • Redirecional URL

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Os administradores precisam executar este procedimento único para habilitar os resultados do Genius de perguntas e respostas sobre conteúdo externo.

    Procedimento

    1. Crie um registro de aplicação executando as seguintes etapas:
      1. Navegar até Tudo > OAuth de Sistema > Registro de aplicações.
      2. Selecione Novo.
      3. Selecione Conectar-se a um provedor OAuth de terceiros.
      4. No formulário Registros de aplicações, preencha os campos:
        Campo Valor
        Nome Insira um nome de sua escolha para o registro do Registro de aplicações.
        ID de cliente Insira o valor de ID do cliente da sua configuração Microsoft SharePoint Online no Portal Microsoft Azure.
        Segredo do cliente Insira o valor de segredo do cliente da sua configuração Microsoft SharePoint Online no Portal Microsoft Azure.
        Tipo de concessão padrão Selecione Authorization Code.
        URL de Autorização Insira a URL de autorização totalmente qualificada para o seu sistema de origem Microsoft SharePoint Online neste formato: https://login.microsoftonline.com/<tenant-id> /oauth2/v2.0/authorize . Substituir<tenant-id> com seu ID de locatário Microsoft SharePoint Online , conforme encontrado nas configurações do Portal Microsoft Azure .
        URL de Token Insira a URL do token totalmente qualificado para o seu sistema de origem Microsoft SharePoint Online neste formato: https://login.microsoftonline.com/<tenant-id> /oauth2/v2.0/token . Substituir<tenant-id> com seu ID de locatário Microsoft SharePoint Online , conforme encontrado nas configurações do Portal Microsoft Azure .
        URL de revogação do token Insira o URL de revogação do token totalmente qualificado para o seu sistema de origem Microsoft SharePoint Online neste formato: https://login.microsoftonline.com/<tenant-id> /oauth2/v2.0/token . Substituir<tenant-id> com seu ID de locatário Microsoft SharePoint Online , conforme encontrado nas configurações do Portal Microsoft Azure .
        Redirecional URL Insira a URL de redirecionamento totalmente qualificada para o subfluxo Integration Hub neste formato: https://<instance-name> .service-now.com/oauth_redirect.do . Substituir<instance-name> com o nome da instância Now Platform® , conforme especificado nas configurações do Portal Microsoft Azure .
      5. Selecione Enviar.
        O novo registro de Registro de aplicações aparece na exibição de lista da tabela.
    2. Defina um escopo de entidade OAuth para o novo registro de registro de aplicações executando as seguintes etapas:
      1. Abra seu novo registro de registro de aplicações na exibição de formulário selecionando-o.
      2. Na lista relacionada Perfis de entidade OAuth, verifique se um registro de perfil de entidade OAuth aparece com o Padrão definido como true e o Tipo de concessão definido como Authorization Code.
        Lista relacionada Perfis de entidade OAuth mostrando o registro de perfil de entidade com os valores de campo corretos.
      3. Abra o novo registro de perfil de entidade OAuth na exibição de formulário selecionando seu nome.
      4. No formulário Perfil de Entidade OAuth, na lista relacionada Escopos de Perfil de Entidade OAuth, clique duas vezes em Inserir uma nova linhae selecione o ícone Pesquisar usando lista ( Pesquisar usando ícone de lista.).
        Formulário de Perfil de Entidade OAuth com o link Inserir uma nova linha... da lista relacionada de Escopos de Perfil de Entidade OAuth realçado.
        Formulário de Perfil de Entidade OAuth com a lista relacionada de Escopos de Perfil de Entidade OAuth relacionada Pesquisar usando o ícone de lista realçado.
      5. No formulário Escopos de Entidade OAuth, selecione Novo.
        Exibição de lista de Escopos de Entidade OAuth com o botão Novo realçado.
      6. No formulário Escopo da entidade OAuth, preencha os campos:
        Campo Valor
        Nome Insira um nome de sua escolha para o alias de conexão e credencial.
        Provedor OAuth Selecione ou insira o nome do registro de aplicações que você criou na etapa 1.e.
        Escopo do OAuth Insira offline_access https://<root-site> .sharepoint.com/.default , substituindo com o nome do site raiz da sua instância Microsoft SharePoint Online .
        Importante:
        Certifique-se de incluir o ponto antes do padrão.
      7. Selecione Enviar.
      8. Na lista relacionada Escopos de Perfil de Entidade OAuth, selecione o ícone Salvar (Enter) ( ícone Salvar (Enter).
        Formulário Perfil de entidade OAuth com o ícone Salvar (Enter) da lista relacionada Escopos de Perfil de Entidade OAuth realçado.
        O novo registro de escopo da entidade OAuth aparece na lista relacionada Escopos de Perfil de Entidade OAuth.
      9. Selecione Atualizar.
    3. Defina um registro de alias de conexão e credencial para Microsoft SharePoint Online executando as seguintes etapas:
      1. Navegar até Tudo > Conexões e Credenciais > Aliases de conexão e credenciais.
      2. Abra o registro de alias MicrosoftSharePointOnlineforAISearch na exibição de formulário selecionando-o.
      3. Na lista relacionada Conexões, selecione Novo.
      4. No formulário de conexão HTTP(s), preencha os campos:
        Campo Valor
        Nome Insira um nome de sua escolha para o alias de conexão e credencial.
        URL de conexão Insira o URL totalmente qualificado para sua instância Microsoft SharePoint Online : https://<root-site> .sharepoint.com .
      5. Para criar seu novo registro de conexão, selecione Enviar.
        O novo registro de conexão aparece na lista relacionada Conexões.
    4. Defina uma nova credencial do OAuth 2.0 associada ao registro de aplicações executando as seguintes etapas:
      1. Navegar até Tudo > Conexões e Credenciais > Credenciais.
      2. Selecione Novo.
      3. Selecione Credenciais OAuth 2.0.
      4. Se o campo Tipo de integração não estiver visível no formulário Credenciais do OAuth 2.0, configure o layout do formulário para tornar o campo visível.
        Para obter detalhes sobre como configurar um layout de formulário, consulte Configuração do layout do formulário.
      5. No formulário Credenciais do OAuth 2.0, preencha os campos:
        Campo Valor
        Nome Insira um nome de sua escolha para o registro de credencial do OAuth 2.0.
        Perfil de Entidade OAuth Selecione o novo registro de perfil de entidade OAuth associado ao registro de registro de aplicações que você criou na etapa 1.e.
        Tipo de Integração Selecione Personal.
      6. Selecione Enviar.
        O novo registro de credenciais do OAuth 2.0 aparece na exibição de lista da tabela Credenciais [discovery_credentials].
    5. Especifique sua nova credencial OAuth 2.0 como aquela a ser usada ao se conectar a Microsoft SharePoint Online, executando as seguintes etapas:
      1. Navegar até Tudo > Conexões e Credenciais > Aliases de conexão e credenciais.
      2. Abra o registro de alias MicrosoftSharePointOnlineforAISearch na exibição de formulário selecionando-o.
      3. Na lista relacionada Conexões, selecione o registro de conexão que você criou na etapa 3.e.
      4. No formulário Conexão HTTP(s), selecione o ícone Pesquisar usando a lista do campo Credencial ( Pesquisar usando o ícone de lista.) e selecione a credencial que você definiu na etapa 4.
      5. Selecione Atualizar.

    O que Fazer Depois

    Opcionalmente, você pode configurar uma consulta Microsoft de Linguagem de consulta de palavra-chave (KQL) para restringir o conjunto de Microsoft SharePoint Online sites em que os resultados do Genius de perguntas e respostas de conteúdo externo pesquisam documentos relevantes. Para obter detalhes sobre como definir essa consulta KQL, consulte Restringir os Microsoft SharePoint Online sites que os resultados do Genius das perguntas e respostas de conteúdo externo podem pesquisar.