Quais documentos são rastreados

• Durante o rastreamento inicial do conteúdo, os documentos de todos os objetos que podem ser acessados a partir do caminho da coleção de sites que você especificar são rastreados e adicionados à sua coleção. Os metadados personalizados que estão associados ao conteúdo do SharePoint também são rastreados.
• Você pode rastrear um caminho de coleção de sites por coleção.
• Somente os documentos compatíveis com o site Discovery são rastreados; todos os outros são ignorados. Para obter mais informações, consulte Tipos de arquivos suportados.
• Há suporte para segurança em nível de documento. Quando essa opção está ativada, seus usuários podem rastrear e consultar o mesmo conteúdo que eles podem acessar quando estão conectados ao SharePoint. Para obter mais informações, consulte Suporte à segurança em nível de documento.
• Quando uma fonte é rastreada novamente, novos documentos são adicionados, documentos atualizados são modificados para a versão atual e documentos excluídos são excluídos do índice da coleção.
• Todos os Discovery conectores de fonte de dados são somente leitura. Independentemente das permissões concedidas à conta de rastreamento, Discovery nunca grava, atualiza ou exclui qualquer conteúdo na fonte de dados original.

Discovery pode rastrear os seguintes objetos:

• Coleções de sites
• Sites
• SubSites
• Listas
• Itens da lista
• Bibliotecas de documentos
• Anexos de itens de lista

Requisitos da origem de dados

Além dos requisitos da fonte de dados para todas as implantações instaladas, sua fonte de dados do SharePoint Online deve atender aos seguintes requisitos:

• A Site Collection à qual você se conecta deve ser uma que tenha sido criada com um plano Enterprise. Não pode ser uma coleção criada com um plano de trabalhadores da linha de frente.

• O suporte à autenticação difere com base no tipo de principal que você especifica ao configurar o método de autenticação. Determine o tipo de principal que deseja usar antes de criar a coleção; não é possível alterar o tipo de principal posteriormente. As opções a seguir estão disponíveis:

  • Usuário: os seguintes requisitos devem ser atendidos pela conta de usuário crawl:

    • A conta deve ter um Azure Active Directory ID de usuário com permissão para acessar todos os objetos que você deseja rastrear. Por exemplo, admin_user@company.onmicrosoft.com. O ID do usuário deve ter a permissão Site Collection Administrator.

    • A conta deve ter a autenticação herdada ativada. Para ativar a autenticação herdada, acesse o portal Azure ou entre em contato com o administrador do Azure Active Directory.

      O conector é compatível com o método Password hash synchronization (PHS) para habilitar somente a identidade híbrida. Use qualquer outro tipo (como autenticação de passagem ou federação) por sua própria conta e risco. A menos que você tenha criado sua conta SharePoint Online antes de janeiro de 2020, a autenticação de dois fatores está ativada para a conta por padrão. Você deve desativar a autenticação de dois fatores.

      Para visualizar e alterar o status da autenticação multifator, consulte Visualizar o status de um usuário ou Alterar o status de um usuário.

  • Serviço: Quando você se conecta aos seus dados como um Azure Active Directory service principal, pode usar a autenticação multifator.

Para obter mais informações sobre o SharePoint Online, consulte a documentação do desenvolvedor do Microsoft SharePoint.

curl -s -XPOST -H "Authorization: ${access_token}" -H "Content-Type: application/json" \
  https://graph.microsoft.com/v1.0/sites/{site}/permissions -d '{
  "roles": ["read"],
  "grantedToIdentities": [{
    "application": {
      "id": "{azure_ad_app_id}",
      "displayName": "{display_name}"
    }
  }]
}'

Conectando-se a uma fonte de dados do SharePoint Online

Em seu projeto Discovery, conclua as seguintes etapas:

1. No painel de navegação, escolha Gerenciar coleções.

2. Clique em New collection (Nova coleção ).

3. Clique em SharePoint Online e, em seguida, clique em Next.

4. Dê um nome à coleção.

5. Se o idioma dos documentos no SharePoint não for o inglês, selecione o idioma apropriado.

   Para obter uma lista de idiomas suportados, consulte Suporte ao idioma.

6. Opcional: Alterar o cronograma de sincronização.

   Para obter mais informações, consulte Opções de agendamento de rastreamento.

7. Na seção Método de autenticação, especifique o tipo de principal que deseja usar ao se autenticar com o SharePoint entre as seguintes opções:

   • Usuário: Um usuário em sua Active Directory.

     Na seção Enter suas credenciais, preencha os seguintes campos:

     Nome do usuário

     O nome de usuário do usuário SharePoint com acesso a todos os sites e listas que precisam ser rastreados e indexados, por exemplo, crawl_username@company.onmicrosoft.com.

     Senha

     A senha do usuário SharePoint.

     Esse valor nunca é retornado e é usado somente quando você cria ou modifica credenciais.

   • Serviço: Uma identidade de segurança usada por aplicativos, serviços e ferramentas de automação criados pelo usuário para acessar recursos específicos do Azure. É como uma identidade de usuário (verificada com um certificado) que tem uma função específica e permissões rigidamente controladas.

     O suporte ao uso de uma entidade de serviço foi adicionado à versão 4.0.3.

     Na seção Enter suas credenciais, preencha os seguintes campos:

     Nome do locatário

     O locatário onde os dados residem. Por exemplo, ibm.onmicrosoft.com.

     ID do Aplicativo

     O ID do seu aplicativo. Por exemplo, 19ce9f74-cd14-4b68-8dfc-4bcc75ed2fe9. Faça upload dos seguintes arquivos:

     Arquivo de certificação

     O arquivo de certificação que você criou em SharePoint. Por exemplo, myinfo.crt.

     Arquivo de chave privado

     O arquivo de chave privada que você criou no SharePoint. Por exemplo, private.app.key.

     Se for necessária uma senha de chave privada, especifique a senha. Se esse rastreador tiver permissões para acessar somente a coleção de sites especificada, defina a chave Azure Access Control Service como On e, em seguida, forneça os seguintes valores:

     • ID do cliente
     • Segredo do cliente

8. Na seção Especifique o que você deseja rastrear, adicione valores aos seguintes campos:

   URL da coleção de sites

   O serviço da Web SharePoint URL. Por exemplo, https://organization_name.com.

   Somente usuário principal

   No campo Nome da coleção de sites, especifique o nome que a coleção de sites usa. Obtenha o nome nas configurações da coleção de sites.

9. Opcional: se estiver usando um servidor proxy para acessar o servidor da fonte de dados, na seção Configurações de proxy, defina a chave Habilitar configurações de proxy como On. Adicione valores aos seguintes campos:

   Nome do usuário

   Opcional. O nome de usuário do servidor proxy a ser autenticado, se o servidor proxy exigir autenticação. Se você não souber o nome do usuário, será possível obtê-lo junto ao administrador do servidor proxy.

   Senha

   Opcional. A senha do servidor proxy para autenticação, se o servidor proxy exigir autenticação. Se você não souber a senha, será possível obtê-la junto ao administrador do servidor proxy.

   Nome do host ou endereço IP do servidor proxy

   O nome do host ou o endereço IP do servidor proxy.

   Número da porta do servidor proxy

   A porta de rede à qual você deseja se conectar no servidor proxy.

10. Opcional: se quiser ativar a segurança no nível do documento, na seção Segurança, defina a chave Ativar segurança no nível do documento como On.

    Quando essa opção está ativada, seus usuários podem rastrear e consultar o mesmo conteúdo que eles podem acessar quando estão conectados ao SharePoint. Para obter mais informações, consulte Suporte à segurança em nível de documento.

    Somente usuário principal: Ao ativar essa opção, você deve adicionar a Azure que foi atribuída ao aplicativo no momento do registro ao campo ID do aplicativo.

    Para habilitar a segurança no nível do documento, você deve registrar seu aplicativo no SharePoint. Para obter mais informações, consulte as etapas de pré-requisito para o tipo de principal que você está usando.

11. Se quiser que o rastreador extraia texto de imagens no site, expanda Mais configurações de processamento e defina Aplicar reconhecimento óptico de caracteres (OCR) como On.

    Quando o OCR está ativado e seus documentos contêm imagens, o processamento demora mais. Para obter mais informações, consulte Reconhecimento óptico de caracteres.

12. Clique em Finish.

A coleção é criada rapidamente. Leva mais tempo para os dados serem processados à medida que são adicionados à coleção.

Se quiser verificar o progresso, vá para a página Activity (Atividade). No painel de navegação, clique em Gerenciar coleções e, em seguida, clique para abrir a coleção.