As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Microsoft OneDrive
A Microsoft OneDrive é um serviço de armazenamento em nuvem que permite armazenar, compartilhar e colaborar em arquivos. Você pode conectar sua instância OneDrive for Business como uma fonte de dados para sua base de conhecimento gerenciada para rastrear os drives pessoais dos usuários em seu locatário do Microsoft 365.
Recursos compatíveis
-
Rastreie os drives pessoais dos usuários. O conjunto de unidades rastreadas depende do método de autenticação — consulte. Métodos de autenticação
-
Detecção automática de campos comuns do documento (como título, autor e datas de criação ou modificação)
-
Filtros de conteúdo de inclusão e exclusão usando endereços de e-mail de usuários, caminhos de itens de drive, tipos de MIME e intervalos de datas
-
Sincronizações incrementais de conteúdo para conteúdo adicionado, atualizado e excluído
-
Microsoft Entra App ID e autenticação OAuth 2.0
-
Document-level controle de acesso (ACLs), com autenticação Microsoft Entra App ID
nota
OneNote notebooks não são suportados atualmente.
Métodos de autenticação
Uma fonte OneDrive de dados oferece suporte a dois métodos de autenticação. Escolha uma antes de começar, pois ela determina as credenciais que você cria e se você pode usar o controle de acesso em nível de documento. Recomendamos a autenticação Microsoft Entra App ID para novas fontes de dados.
| Método | Como ele se autentica | Quando usar | Configuração |
|---|---|---|---|
Microsoft Entra App ID (ENTRA_APP_ID) — recomendado |
Um aplicativo Microsoft Entra é autenticado com um ID e um segredo do cliente do aplicativo, usando o fluxo de credenciais do cliente (somente do aplicativo) do OAuth 2.0. Nenhum login de usuário. Quando o controle de acesso em nível de documento está ativado, o aplicativo também se autentica SharePoint com um certificado. | A maioria das fontes de dados e qualquer fonte de dados que use controle de acesso em nível de documento. | Configurar a autenticação do Entra App ID |
OAuth 2.0 () OAUTH2 |
Um ID e um segredo do cliente do aplicativo, juntamente com um token de atualização delegado que você obtém por meio do login de um usuário. O conector usa o token de atualização para obter tokens de acesso para rastreamento. | Use quando um único usuário do Microsoft 365 tiver acesso a todo o OneDrive conteúdo que você deseja rastrear: seu próprio drive, além de quaisquer drives compartilhados com ele ou onde ele tenha acesso de SharePoint administrador. A autenticação do Microsoft Entra App ID é necessária para rastrear uniformemente todos os usuários OneDrive em seu locatário. | Configurar a autenticação OAuth 2.0 |
Importante
O OAUTH2 método requer um token de atualização. Os tokens de atualização têm uma Microsoft-side vida útil finita e devem ser cunhados novamente antes de expirarem. OAUTH2também não oferece suporte ao controle de acesso em nível de documento. Use a autenticação Microsoft Entra App ID se precisar de controle de acesso em nível de documento ou se precisar rastrear todos os usuários em seu OneDrive locatário.
Pré-requisitos
No Microsoft 365, certifique-se de:
-
Copie o ID de locatário do Microsoft 365. Encontre o ID de locatário em “Properties” no portal do Microsoft Entra. Para obter detalhes, consulte Encontre sua ID de locatário do Microsoft 365
no site do Microsoft Learn.
Em sua AWS conta, certifique-se de:
-
Armazenar as credenciais de autenticação em um segredo do AWS Secrets Manager e anotar o nome do recurso da Amazon (ARN) do segredo.
-
Para ver os pares exatos de valores-chave a serem armazenados no segredo, consulte a página de configuração do seu método de autenticação: Configurar a autenticação Microsoft Entra App ID para OneDrive ou. Configure a autenticação OAuth 2.0 para OneDrive
-
Inclua as permissões necessárias para se conectar à sua fonte de dados na role/permissions política AWS Identity and Access Management (IAM) da sua base de conhecimento. Para obter informações sobre as permissões necessárias, consultePermissões para acessar as fontes de dados.
Como configurar uma fonte OneDrive de dados
A configuração de uma fonte de OneDrive dados envolve as seguintes etapas:
-
Configure a autenticação. Siga a página do método escolhido para registrar um aplicativo Microsoft Entra, configurar permissões e armazenar suas credenciais em AWS: Configurar a autenticação Microsoft Entra App ID para OneDrive ouConfigure a autenticação OAuth 2.0 para OneDrive.
-
Conecte a fonte de dados. Crie a fonte de OneDrive dados na base de conhecimento usando a Console de gerenciamento da AWS ou a API. Consulte Conectar uma fonte OneDrive de dados.
-
(Opcional) Ative o controle de acesso em nível de documento. Filtre os resultados da consulta de acordo com OneDrive as permissões de cada usuário. Consulte Document-level controles de acesso.
Se você tiver problemas durante a configuração ou a sincronização, consulteSolucionar problemas de uma fonte OneDrive de dados.
