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á. # Conectar uma fonte SharePoint de dados Depois de configurar a autenticação e armazenar suas credenciais em AWS Secrets Manager segredo, crie a fonte de SharePoint dados em sua base de conhecimento. Esta página descreve como criar a fonte de dados com a Console de gerenciamento da AWS ou a API, seguida por uma referência para os parâmetros do conector que você pode configurar. **nota** Conclua primeiro a configuração da autenticação. Consulte [User-managed configuração (3LO)](kb-managed-sharepoint-3lo-setup.md) (mais simples), [Configurar a App-Only autenticação Microsoft Entra ID para SharePoint](kb-managed-sharepoint-entra-setup.md) (recomendado para controle de acesso em nível de documento) ou. [Configure a autenticação OAuth 2.0 para SharePoint](kb-managed-sharepoint-oauth2-setup.md) Para a configuração gerenciada pelo usuário (3LO), você faz login pelo console e o Amazon Bedrock cria o segredo para você (com um ARN gerado pelo sistema); você não fornece um segredo ou ID de locatário. Para os outros métodos, você precisa do ARN secreto, do seu ID de locatário e (para App-Only autenticação do Microsoft Entra ID) da localização do seu certificado no Amazon S3. ## Crie a fonte de dados ------ #### [ Console ] **Para se conectar SharePoint à sua base de conhecimento gerenciada** 1. Em Fonte ** de dados**, forneça um nome para sua fonte de dados. 1. Selecione ** SharePoint ** no menu suspenso da fonte de dados. 1. Em ** Fonte**, insira os URLs ** ** do seu site. Cada URL deve começar com `https://` e apontar para um site, site de equipe ou site pessoal (por exemplo,`https://contoso.sharepoint.com/sites/engineering`). Você pode adicionar até 100 URLs. 1. Em ** Autenticação**, selecione ** User-managed configuração (3LO)**, ** Microsoft Entra ID App-Only ** ou ** autenticação OAuth 2.0. ** Para configuração gerenciada pelo usuário (3LO), opcionalmente, insira um prefixo de nome ** secreto. ** Em seguida, escolha ** ** Entrar para entrar SharePoint e autorizar a conexão. Você não fornece um ID secreto ou de inquilino. O Amazon Bedrock cria um segredo com um ARN gerado pelo sistema para armazenar o token. Para obter detalhes, consulte [User-managed configuração (3LO)](kb-managed-sharepoint-3lo-setup.md). 1. Selecione ou crie um AWS Secrets Manager segredo para armazenar suas credenciais. 1. Insira seu ID de ** inquilino. ** 1. Se você selecionou a App-Only autenticação de ID Microsoft Entra, forneça o caminho do ** certificado ** — o caminho do Amazon S3 para seu arquivo de `.p12` certificado. 1. (Opcional) Para ativar o controle de acesso no nível do documento, selecione ** Controlar o acesso ao documento com ACLs. ** Essa opção está disponível somente com a App-Only autenticação do Microsoft Entra ID e não pode ser alterada após a criação. Para obter detalhes, consulte [Document-level controles de acesso](kb-managed-ds-sharepoint-acl.md). 1. (Opcional) Expanda ** o escopo da ** sincronização para configurar qual conteúdo rastrear (arquivos, páginas). 1. (Opcional) Expanda a sincronização de entidades com base em ** data ** para especificar filtros de data. 1. (Opcional) Expanda o padrão ** do caminho do item ** para adicionar caminhos específicos para filtrar os itens a serem rastreados. ------ #### [ API ] Para criar uma fonte de SharePoint dados, envie uma [ CreateDataSource ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) solicitação com um endpoint de tempo de construção do Agents for Amazon Bedrock. O AWS Command Line Interface exemplo a seguir cria uma fonte de dados que usa a App-Only autenticação Microsoft Entra ID. Para ativar o controle de acesso em nível de documento, defina como`aclEnabled`. `true` Para obter uma descrição de cada campo, consulte a referência de parâmetros do conector a seguir. ``` aws bedrock-agent create-data-source \ --name "{{SharePoint-connector}}" \ --knowledge-base-id "{{your-knowledge-base-id}}" \ --data-source-configuration file://sharepoint-managed-connector.json ``` O `sharepoint-managed-connector.json` arquivo contém o seguinte: ``` { "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR", "managedKnowledgeBaseConnectorConfiguration": { "connectorParameters": { "type": "SHAREPOINT", "version": "1", "aclEnabled": false, "connectionConfiguration": { "secretArn": "{{arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-sharepoint-creds}}", "tenantId": "{{12345678-1234-1234-1234-123456789012}}", "authType": "ENTRA_ID_APP_ONLY", "certificateS3Path": { "s3BucketName": "{{your-certificate-bucket}}", "s3KeyName": "{{certs/certificate.p12}}" } }, "dataEntityConfiguration": { "crawlFiles": true, "crawlPages": true, "siteUrls": [ "{{https://contoso.sharepoint.com/sites/engineering}}" ] } } } } ``` Para uma fonte `OAUTH2_APP` de dados, `authType` defina como `OAUTH2_APP` e omita. `certificateS3Path` Para configuração gerenciada pelo usuário (3LO), `authType` defina como `MANAGED_OAUTH2` e omita. `certificateS3Path` Você não pode criar um segredo 3LO por meio da API: primeiro faça login pelo console para criar o segredo e, em seguida, defina-o como `secretArn` o ARN desse segredo. Para obter detalhes, consulte [User-managed configuração (3LO)](kb-managed-sharepoint-3lo-setup.md). Para bases de conhecimento gerenciadas, `CreateDataSource` é assíncrono: o status da fonte de dados muda de `CREATING` para `AVAILABLE` quando a operação é concluída. ------ ## Parâmetros do conector A configuração da fonte de dados usa os seguintes parâmetros do conector. Para se conectar SharePoint, especifique `SHAREPOINT` como o conector digitado`connectorParameters`. Para os campos que envolvem `connectorParameters` (como `deletionProtectionConfiguration` e`mediaExtractionConfiguration`), consulte[Conectar uma fonte de dados](kb-managed-connect-ds.md). **connectionConfiguration** | Campo | Obrigatório | Descrição | | --- | --- | --- | | secretArn | Sim | O ARN do AWS Secrets Manager segredo contendo suas SharePoint credenciais. | | tenantId | Sim | O ID do locatário do Microsoft Entra (Azure AD). | | authType | Sim | O tipo de autenticação: MANAGED\_OAUTH2 (configuração gerenciada pelo usuário, 3LO), ENTRA\_ID\_APP\_ONLY (recomendado) ou. OAUTH2\_APP Consulte [Métodos de autenticação](kb-managed-ds-sharepoint.md#kb-managed-sharepoint-auth-methods). | | certificateS3Path | Condicional | Necessário para ENTRA\_ID\_APP\_ONLY autenticação, mesmo quando as ACLs estão desativadas. Contém s3BucketName e s3KeyName para o arquivo de certificado no Amazon S3. Não usado comOAUTH2\_APP. | **dados EntityConfiguration** | Campo | Obrigatório | Descrição | | --- | --- | --- | | siteUrls | Sim | Lista de URLs de SharePoint sites a serem rastreados. Cada URL é um ponto de entrada de rastreamento e deve começar com https:// e apontar para um site, site de equipe ou site pessoal — o caminho deve começar com /sites//teams/, ou ser /personal/ seguido pelo nome do site (por exemplo,https://contoso.sharepoint.com/sites/engineering). Tanto \*.sharepoint.com os domínios padrão quanto os domínios personalizados (personalizados) são suportados. Em cada site, o conector rastreia arquivos e páginas (consulte crawlFiles ecrawlPages); para segmentar itens específicos, use. inclusionItemPaths | | crawlFiles | Não | Se os arquivos devem ser rastreados. O padrão é true. | | crawlPages | Não | Se você deve rastrear páginas. O padrão é true. | **Configuração do filtro (opcional)** | Campo | Obrigatório | Description | | --- | --- | --- | | modifiedDateBefore | Não | Inclua somente conteúdo modificado antes dessa data (ISO 8601). | | modifiedDateAfter | Não | Inclua somente conteúdo modificado após essa data (ISO 8601). | | inclusionItemPaths | Não | Caminhos de itens específicos a serem incluídos. Quando você forneceinclusionItemPaths, o conector rastreia esses itens e não valida. siteUrls | **ACL ativado (opcional)** | Campo | Obrigatório | Description | | --- | --- | --- | | aclEnabled | Não | Defina como true para ativar o controle de acesso em nível de documento. Requer ENTRA\_ID\_APP\_ONLY autenticação. Você não pode alterar essa configuração depois de criar a fonte de dados. Para obter detalhes, consulte [Document-level controles de acesso](kb-managed-ds-sharepoint-acl.md). | ## Alterar o método de autenticação Você pode alterar o método de autenticação de uma fonte de dados (por exemplo, de OAuth 2.0 para Microsoft Entra ID App-Only) atualizando a fonte de dados com as credenciais nova `authType` e, usando a [ UpdateDataSource ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateDataSource.html) operação ou o. Console de gerenciamento da AWS A configuração de controle de acesso em nível de documento é fixa quando você cria uma fonte de dados, portanto, para adicionar ou remover ACLs, você deve criar uma nova fonte de dados. ## Próximas etapas Depois de criar a fonte de dados, sincronize-a para ingerir conteúdo em sua base de conhecimento. Para obter detalhes, consulte [Sincronizar uma fonte de dados](kb-managed-sync.md). Para filtrar os resultados da consulta por permissões de usuário, consulte[Document-level controles de acesso](kb-managed-ds-sharepoint-acl.md).