---
sourceDocument: Yokohama Employee Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/employee-service-management

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Employee Service Management

ft:clusterId :

    - emplsm

bundleId :

    - emplsm

workflow :

    - Employee


---

# Configurando o. Conector de pesquisa do SharePoint Online

# Configurando o. Conector de pesquisa do SharePoint Online {#ariaid-title1}

Configure o. Conector de pesquisa do SharePoint Onlineconfigurando e conectando o. Microsoft SharePointlocatário com sua instância. Valide a conexão para evitar falhas de configuração antes de indexar os sites para pesquisa.

## Configure o. Microsoft SharePointlocatário {#ariaid-title2}

Configure seu Microsoft SharePointlocatário para começar a usar Conector de pesquisa do SharePoint Online.

### Antes de Iniciar

. Microsoft SharePointAdministrador, crie uma aplicação personalizada especificando o URL raiz ( \<sitename\>://.sharepoint.com ), domínio da aplicação, URL de redirecionamento e outras configurações.  
Importante:  
A partir do lançamento de Yokohama, Conector de pesquisa do SharePoint Onlineestá sendo preparado para descontinuação futura. Ele está oculto e não está mais ativado em novas instâncias, mas continua sendo compatível.

Para obter detalhes de descontinuação, consulte [Processo de descontinuação \[KB0867184\]](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB0867184)artigo na base de conhecimento do Now Support.
Certifique-se de concluir os seguintes pré-requisitos.

* Siga o procedimento até [Configure OAuth application in Microsoft Azure](https://www.servicenow.com/docs/access?context=configure-oauth-application-in-microsoft-azure&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US).
* Siga o procedimento até [Set up Microsoft Entra ID spoke](https://www.servicenow.com/docs/access?context=set-up-azure&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US). Microsoft O Spoke do Entra ID (anteriormente conhecido como Spoke do Active Directory do Microsoft Azure) é um plug-in dependente que precisa ser configurado antes de indexar os usuários.
* Entenda como [Configure Microsoft SharePoint Graph connection](https://www.servicenow.com/docs/access?context=configure-microsoft-sharepoint-graph-connection&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US).
* Faça login com suas credenciais de administrador para conceder permissões.

{#spoc-config__ul_v5x_wrp_m2c}

Função necessária: administrador

### Por Que e Quando Desempenhar Esta Tarefa

Conclua o procedimento a seguir no Microsoft SharePointconta. Para obter mais informações sobre como criar e configurar aplicações personalizadas, consulte [Desenvolvimento do SharePoint](https://docs.microsoft.com/en-us/sharepoint/dev/)  
Nota:  
Quando as permissões atribuídas nas aplicações do Azure têm problemas de privilégio, a seguinte mensagem de erro é exibida: Mensagem de erro: Falha no método: (/_api/web/XXXXXXX) com o código: 401 - combinação de nome de usuário/senha inválida . Resolva este problema com as instruções disponíveis em [KB1117977](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB1117977).  
Quando você quiser que os resultados da pesquisa exibam somente as versões publicadas dos documentos, certifique-se de selecionar Permissões da aplicação em vez de Permissões delegadas ao configurar as permissões explicadas em [Microsoft SharePoint Online Spoke](https://www.servicenow.com/docs/access?context=sharepoint-online-spoke&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US).  
Nota:  
Os administradores podem limitar a indexação somente às versões publicadas, garantindo que rascunhos ou trabalhos não concluídos não sejam exibidos nos resultados da pesquisa.

### Procedimento

1. Navegar até AzureActive DirectoryRegistros da aplicaçãoTodas as aplicaçõese selecione um app existente.  
   Use uma aplicação existente ou crie uma aplicação.

Permissões configuradas

2. Navegar até Registros da aplicaçãoPermissões de APIe clique em Adicione uma permissão .
3. Selecione uma das seguintes opções.
   1. Navegar até Microsoft GraphPermissões delegadas Para Gráfico.
   2. Navegar até Microsoft GraphPermissões da aplicação Para Gráfico.

   {#spoc-config__substeps_plr_vtm_h1c}  
   Adicione o. ReadWrite.All Permissão da lista de sites. A permissão Sites.readWrite.all ajuda na criação de assinaturas.

   Adicione o. Usuário.Leitura Permissão da lista de usuários.
   Essas permissões de usuário são usadas para rastrear o. Microsoft SharePointdados mais tarde.
4. Navegar até SharepointPermissões da aplicaçãoLocaise selecione FullControl.Todos , Sites.Ler.Todos , ou Sites.Selecionado Para REST.  
   Habilite o. Sites.Selecionado executando as etapas a seguir.
   1. Em Microsoft Azure, habilite o. Sites.Selecionado e o. Usuário.Ler.Tudo permissões.  
      Use qualquer cliente de API para fornecer acesso de leitura para os seguintes conjuntos de sites.
      * Aplicação X que está conectada a um ServiceNowa instância e tem Sites.Selecionado permissão.
      * Aplicação Y que é uma aplicação de administrador e tem o. Controle.Total.Sites Conexão do gráfico.
      {#spoc-config__ul_yz1_d4w_dcc}
   2. Obtenha um token de portador chamando o método de API https://login.microsoftonline.com/{Tenant ID)/oauth2/v2.0/token .  
      Carga:

          client_id={App Y client id}
          &scope=https%3A%2F%2Fgraph.microsoft.com%2F.default
          &client_secret={App Y client secret}
          &grant_type=client_credentials

   3. Passe o token recebido na etapa b como o token de autorização ao chamar o método de API https://graph.microsoft.com/v1.0/sites/{site id)/permissões .  
      Carga:

          {
          "roles": [
          "read"
          ],
          "grantedToIdentities": [
          {
          "application": {
          "id": "App X client id",
          "displayName": "App X"
          }
          }
          ]
          }

   {#spoc-config__substeps_og3_jjw_dcc}
5. Certifique-se de configurar as permissões de API necessárias conforme mostrado na imagem a seguir:  
   Figura 1. Lista de permissões configuradas Para obter mais informações, consulte [Configure Microsoft SharePoint Graph connection](https://www.servicenow.com/docs/access?context=configure-microsoft-sharepoint-graph-connection&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US).
6. Clique em Conceda consentimento do administrador , selecione Sim e clique em Salve e continue .
7. Navegar até AutenticaçãoWebURLs de redirecionamento E adicione o URL neste formato URL da instância ServiceNow\>/oauth_redirect.do https://\<your , por exemplo, <https://eesharepoint.example.com/oauth_redirect.do>e clique em Salvar .
8. Navegue até [Microsoft SharePoint Online Spoke](https://www.servicenow.com/docs/access?context=sharepoint-online-spoke&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US)e registre o certificado e o segredo da sua aplicação.
9. Clique em Adicionar usuário em [Portal do administrador da Microsoft](http://admin.microsoft.com/AdminPortal/Home#/users), especifique os detalhes do usuário e clique em Concluir .  
   Nota:  
   A pesquisa rastreia os sites que você pode acessar. Selecione o usuário com as permissões apropriadas somente para o conteúdo necessário. Para obter mais informações, consulte [permissões do usuário](https://docs.microsoft.com/en-us/sharepoint/customize-sharepoint-site-permissions). Selecionar um usuário de alto nível pode importar mais documentos do que você deseja importar.

   Para obter mais informações, consulte [Apenas concedendo acesso por meio da aplicação Azure AD](https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/security-apponly-azuread).

### O que Fazer Depois

Conclua a integração a partir de ServiceNow Pesquisa com IAconta. Para obter mais informações, consulte [Integre o. Microsoft SharePointfontes de pesquisa com Pesquisa com IAperfis](https://servicenow-prod.fluidtopics.net/gRrC9DQJDRoZTpqus04g~w#link-search-sources-spoc "Vincule fontes de pesquisa a um perfil de pesquisa para especificar o conteúdo que os usuários podem pesquisar por meio do perfil de pesquisa vinculado.").

## Integre o. Microsoft SharePointfontes de pesquisa com Pesquisa com IAperfis {#ariaid-title3}

Vincule fontes de pesquisa a um perfil de pesquisa para especificar o conteúdo que os usuários podem pesquisar por meio do perfil de pesquisa vinculado.

### Antes de Iniciar

Função necessária: administrador

### Procedimento

1. Navegar até Pesquisar aplicaçõesConfigurações da aplicação de pesquisa (sys_search_context_config).
2. Atualize os seguintes valores, para Aplicação de pesquisa padrão do Virtual Agent  
   * Mecanismo de pesquisa: Pesquisa com IA .
   * Perfil de pesquisa: Perfil de pesquisa padrão do portal ESC . Este valor de campo dinâmico fica visível depois que você muda o. Mecanismo de pesquisa valor.

   {#link-search-sources-spoc__ul_mfb_fft_p4b}Para obter mais informações, consulte [Create a search application configuration for AI Search](https://www.servicenow.com/docs/access?context=create-search-app-config-ais&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US).
{#link-search-sources-spoc__steps_el2_nds_vwb}

### O que Fazer Depois

Conecte o. ServiceNow®instância com Microsoft SharePointlocatário. Conclua as etapas do ServiceNow®conta. Para obter mais informações, consulte [Conecte seu ServiceNowinstância para a. Microsoft SharePointlocatário](https://servicenow-prod.fluidtopics.net/gRrC9DQJDRoZTpqus04g~w#sharepoint-configure-connections "Conecte seu ServiceNowinstância com um Microsoft SharePointlocatário. Criar personalizado ServiceNowConexões OAuth para Microsoft SharePointpara autenticar ServiceNowsolicitações.").

## Conecte seu ServiceNowinstância para a. Microsoft SharePointlocatário {#ariaid-title4}

Conecte seu ServiceNowinstância com um Microsoft SharePointlocatário. Criar personalizado ServiceNowConexões OAuth para Microsoft SharePointpara autenticar ServiceNowsolicitações.

### Antes de Iniciar

* Certifique-se de ter conhecimento prático do [Programa para desenvolvedores do SharePoint](https://developer.microsoft.com/en-us/microsoft-365/dev-program)ferramentas e outros recursos para configurar a aplicação.
* Certifique-se de estar ciente de ServiceNow®integrações.
{#sharepoint-configure-connections__ul_jq4_l3y_j4b}Função necessária: sn_sp_con.admin e admin.

### Procedimento

1. Navegar até Instância da ServiceNowOAuth de SistemaRegistro de aplicações.
2. Clique em Nova.  
   O sistema exibe a mensagem Que tipo de aplicação OAuth?
3. Selecione Conecte-se a um provedor de OAuth terceirizado .
4. Crie os seguintes registros:
   1. No formulário de conexão de gráfico, preencha os campos.  
      Para obter uma descrição do valor do campo, consulte [Formulário de conexão do gráfico](https://servicenow-prod.fluidtopics.net/T_6cDzDFzMfgMJJ7~LP6vQ "A seguir estão os campos disponíveis no formulário de conexão de gráfico para criar uma conexão de gráfico Microsoft SharePointconfiguração de conectividade.").
   2. No formulário de conexão REST, preencha os campos.  
      Para obter uma descrição do valor do campo, consulte [Formulário de conexão REST](https://servicenow-prod.fluidtopics.net/QvN_wFDsTVSQ6wcqeFEj7A "A seguir estão os campos disponíveis no formulário de conexão REST para criar uma conexão REST Microsoft SharePointconfiguração de conectividade.").
   3. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
   {#sharepoint-configure-connections__substeps_o55_xqj_s1c}

Perfil de Entidade OAuth

5. Navegue até Perfis de entidade OAuth \[oauth_entity_profile \] para encontrar as seguintes entradas:  
   * `Nome do registro da aplicação de gráfico>.default_profile`
   * `Nome do registro da aplicação REST>.default_profile`

   {#sharepoint-configure-connections__ul_pdp_35y_l4b}

   Dois perfis de entidade OAuth gerados pelo sistema (REST e Gráfico) são criados na tabela Perfis de entidade OAuth \[oauth_entity_profile\]. Para obter mais informações, consulte [Specify an OAuth profile](https://www.servicenow.com/docs/access?context=t_SpecifyAnOAuthProfile&version=yokohama&pubname=yokohama-api-reference&ft:locale=en-US).

Escopos de entidade OAuth  
Escopos de perfis de entidade OAuth

6. Insira uma linha com os seguintes valores na tabela Escopos de perfis de entidade OAuth \[oauth_entity_profile_scope\]:  
   {#sharepoint-configure-connections__table_qgb_pwz_s1c__entry__2}

   | Gráfico | REST |
   |-|-|
   | Perfil de entidade OAuth: Perfil de entidade de gráfico gerado na tabela Perfis de entidade OAuth \[oauth_entity_profile\]. | Perfil da entidade OAuth: Perfil da entidade REST gerado na tabela Perfis de entidade OAuth \[oauth_entity_profile\]. |
   | Escopo da entidade OAuth: Selecione a tabela de escopo da entidade OAuth do gráfico \[oauth_entity_profile_scope\]. | Escopo da entidade OAuth: Selecione a tabela Escopo da entidade REST OAuth \[oauth_entity_profile_scope\]. |
   | Aplicação: Global | Aplicação: Global |
   [Tabela 1. Escopos de perfis de entidade OAuth]

   {#sharepoint-configure-connections__table_qgb_pwz_s1c}

Credenciais

7. Navegar até Conexões e CredenciaisCredenciaisE crie as credenciais do OAuth 2,0:
   1. Nos formulários de credencial de gráfico ou REST, preencha os campos.  
      {#sharepoint-configure-connections__table_qyn_qtg_ywb__entry__2}

      | Campo | Descrição |
      |-|-|
      | Nome | Nome de sua escolha. |
      | Perfil de entidade OAuth | (Para gráfico) Perfil de entidade de gráfico identificado. (Para REST) Perfil de entidade REST identificado. |
      [Tabela 2. Formulário de credencial do OAuth 2,0]

      {#sharepoint-configure-connections__table_qyn_qtg_ywb}
   2. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.  
      Nota:  
      Para obter mais informações sobre aliases de entidades, conexão e credencial, consulte [Configure the SharePoint Graph Root Site Subscription connection and credential alias
      record](https://www.servicenow.com/docs/access?context=conf-graph-root&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US).
   {#sharepoint-configure-connections__substeps_hyx_llz_s1c}

Conexão

8. Navegar até Conexões e CredenciaisConexãoe clique em Novo Para criar conexões HTTP(s) para o seguinte Gráfico ou DESCANSO .
   1. No formulário, preencha os campos.  
      {#sharepoint-configure-connections__table_prf_1zz_s1c__entry__2}

      | Campo | Descrição |
      |-|-|
      | Nome: Qualquer nome de sua escolha para Gráfico | Nome: Qualquer nome de sua escolha para REST |
      | Credenciais: Selecione o gráfico Credenciais | Credenciais: Selecione o REST Credenciais |
      | Alias de conexão: <kbd class="ph userinput">sn_sp_spoke.MicrosoftSharePointGraph </kbd> | Alias de conexão: <kbd class="ph userinput">sn_sp_spoke.MicrosoftSharepointOnline </kbd> |
      | URL de conexão: <kbd class="ph userinput">https://graph.microsoft.com/v1.0/ </kbd> | URL de conexão: <kbd class="ph userinput">https://&lt;Host URL da sua instância do SharePoint&gt;/ </kbd> |
      | Domínio: Global | Domínio: Global |
      [Tabela 3. Formulário de conexão]

      {#sharepoint-configure-connections__table_prf_1zz_s1c}
   2. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.

   Para obter mais informações, consulte [Connections and Credentials](https://www.servicenow.com/docs/access?context=r-credentials&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US) e [Create an HTTP(s) connection](https://www.servicenow.com/docs/access?context=create-https-connection&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US).

Locatários

9. Navegar até Microsoft SharePoint OnlineLocatários.
   1. Clique em Novo para criar Gráfico ou DESCANSO conexões.
   2. No formulário, preencha os campos.  
      {#sharepoint-configure-connections__table_cpv_vvg_ywb__entry__2}

      | Campo | Descrição |
      |-|-|
      | Nome | Nome de sua escolha. |
      | Alias | Para Gráfico: <kbd class="ph userinput">sn_sp_spoke.MicrosoftSharePointGraph </kbd> Para REST: <kbd class="ph userinput">sn_sp_spoke.MicrosoftSharepointOnline </kbd> |
      | URL raiz do SharePoint | URL raiz como \<SiteName\>.sharepoint.com |
      | ID de locatário | ID do locatário necessário para a conexão do gráfico ou REST. |
      | Domínio | Global |
      [Tabela 4. Formulário de conexão do locatário]

      {#sharepoint-configure-connections__table_cpv_vvg_ywb}
   3. Clique com o botão direito do mouse no cabeçalho do tópico e clique em Salvar .

   {#sharepoint-configure-connections__substeps_n43_4tl_s1c}  
   Para obter mais informações, consulte [Define tenants](https://www.servicenow.com/docs/access?context=create-tenant&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US), [Configure the SharePoint Graph Root Site Subscription connection and credential alias
   record](https://www.servicenow.com/docs/access?context=conf-graph-root&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US)e. [Create aliases for multiple tenants](https://www.servicenow.com/docs/access?context=create-aliases-sharepoint&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US)

Certificados  
Chaves JWT

10. Navegar até OAuth de SistemaProvedores JWTProvedor de JWT do Microsoft SharePoint Online.
    1. Atualize o. aud sinistro com https://login.microsoftonline.com/\<Tenant-id\>/oauth2/token .
    2. Atualize o. iss e. sub Declaração com os respectivos ids de cliente nos registros do app de anúncio do Azure.
    3. Clique em Salvar.
    {#sharepoint-configure-connections__substeps_m4y_rt1_lsb}

Conexão

11. Navegar até Conexões e CredenciaisConexão.
    1. Abra o registro de conexão REST e no Atributos Especifique o certificado codificado Base64 Impressão digital .  
       Nota:  
       O valor da impressão digital do aplicativo do SharePoint é codificado em hexadecimal. Codifique o mesmo no formato Base64 no registro de conexão.
    2. Selecione o seguinte Credenciais opção:  
       * (Para Gráfico ): Navegue até a tabela \[Credenciais\] (oauth_2_0_credentials), abra Gráfico e clique em Obter token OAuth .

         Certifique-se de fazer login em Microsoft SharePointInstância com as credenciais do usuário que você criou para obter o token OAuth para a conexão do Graph. Armazene as credenciais na instância.
       * (Para DESCANSO ): Vá para a tabela \[Credenciais\] (oauth_2_0_credentials), abra DESCANSO e clique em Obter token OAuth .

         Certifique-se de fazer login em Microsoft SharePointInstância com as credenciais de administrador de locatário para obter o token OAuth para a conexão REST. Armazene as credenciais na instância. Valide a credencial para evitar qualquer falha de configuração.
       {#sharepoint-configure-connections__ul_jwz_dkf_t1c}
    3. Clique em Salvar.
    {#sharepoint-configure-connections__substeps_mvx_wlf_t1c}

Domínios confiáveis

12. Vá para Domínios confiáveis (sn_ais_spoke_trusted_domains) e clique em Novo para criar um registro de domínio.
    1. No formulário, preencha os campos.  
       {#sharepoint-configure-connections__table_ql3_xfh_ywb__entry__2}

       | Campo | Descrição |
       |-|-|
       | Nome | Nome de sua escolha. |
       | Domínio | URL do host do seu Microsoft SharePointlocatário\>. |
       [Tabela 5. Formulário de registro de domínio]

       {#sharepoint-configure-connections__table_ql3_xfh_ywb}
    2. Clique em Salvar.  
       Para obter mais informações, consulte [Set up the AI Search spoke](https://www.servicenow.com/docs/access?context=setup-ais-spoke&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US).  
       Nota:  
       Certifique-se de criar um registro de domínio confiável para cada locatário, quando houver vários locatários.
    {#sharepoint-configure-connections__substeps_xp3_wlz_s1c}

Usuário de ingestão do SharePoint

13. Navegar até Conexões e CredenciaisAliases de conexão e credencialUsuário de ingestão do SharePoint (sn_sp_con.SharePoint_ingest_User).
    1. Clique em Novo ativado Credenciais para criar um Credencial de autenticação básica Para ingerir conteúdo externo por AIS.
    2. Especifique o. Nome de usuário e. Senha do usuário (sys_user) que tem ais_external_content função.  
       Nota:  
       Na captura de tela de exemplo, o usuário <kbd class="ph userinput">tuter </kbd>é o sys_user que tem a função ais_external_content atribuída.
    3. Clique em Enviar.  
       Para obter mais informações, consulte [Create aliases for multiple tenants](https://www.servicenow.com/docs/access?context=create-aliases-sharepoint&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US).
    4. Configure o. [Conexão do servidor da Pesquisa com IA](https://www.servicenow.com/docs/access?context=setup-ais-spoke&version=yokohama&pubname=yokohama-integrate-applications&ft:locale=en-US)antes de prosseguir com as próximas etapas.

    {#sharepoint-configure-connections__substeps_yqv_mmz_s1c}  
    A configuração do mapeador de ação de exibição de entidade (EVAM) está disponível por padrão com Central do funcionário - Proversão 32,0.

    Para obter mais informações sobre a definição de EVAM, consulte [Create an EVAM action definition](https://www.servicenow.com/docs/access?context=define-evam-action&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US)e. [Create a multi-data source list display in Entity View Action Mapper](https://www.servicenow.com/docs/access?context=tutorial-create-evam&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).

### Resultado

Sua configuração está concluída.

### O que Fazer Depois

Indexe os sites para pesquisa. Para obter mais informações, consulte [Indexar sites para pesquisa](https://servicenow-prod.fluidtopics.net/3yywgbH_~Qx5pEc588n39w "Configure o. Conector de pesquisa do SharePoint Onlinepara rastrear o conteúdo dos sites, subsites, unidades qualificados e muito mais.").

