

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á.

# Solucionar problemas de uma fonte SharePoint de dados
<a name="kb-managed-ds-sharepoint-troubleshooting"></a>

Use esta página para diagnosticar problemas comuns com SharePoint autenticação, criação de fontes de dados e sincronização. Para problemas específicos do controle de acesso em nível de documento, consulte a tabela de solução de problemas em. [Document-level controles de acesso](kb-managed-ds-sharepoint-acl.md)

## Erros de criação e conexão da fonte de dados
<a name="kb-managed-ds-sharepoint-troubleshooting-create"></a>


**Erros de criação e conexão**  

| Sintomas | Causa provável | Correção | 
| --- | --- | --- | 
| A fonte de dados falha imediatamente com um erro que não connectionConfiguration.certificateS3Path deve ser nulo. | O caminho do certificado authType é, ENTRA\_ID\_APP\_ONLY mas nenhum foi fornecido. Esse tipo de autenticação sempre exige um certificado, mesmo quando as ACLs estão desativadas. | Adicione certificateS3PathconnectionConfiguration, apontando para seu .p12 certificado no Amazon S3. Consulte [Configurar a App-Only autenticação Microsoft Entra ID para SharePoint](kb-managed-sharepoint-entra-setup.md). | 
| ID de inquilino inválida. | O ID do inquilino está incorreto ou não corresponde ao seu inquilino do Microsoft Entra. | Copie a ID do diretório (inquilino) da página Visão geral do aplicativo no centro de administração do Microsoft Entra. | 
| ID de cliente inválida ou o aplicativo não pode ser encontrado. | O clientId segredo está incorreto ou o registro do aplicativo não existe. | Copie o ID do aplicativo (cliente) da página de visão geral do aplicativo e atualize o segredo. | 
| Não foi possível conectar-se ao SharePoint. | Uma ou mais credenciais estão incorretas ou o aplicativo não tem as permissões necessárias ou o consentimento do administrador. | Verifique os valores secretos, confirme as permissões do aplicativo e conceda o consentimento do administrador. Consulte [Configurar a App-Only autenticação Microsoft Entra ID para SharePoint](kb-managed-sharepoint-entra-setup.md). | 
| A função de serviço da base de conhecimento não consegue ler o certificado. | A função de serviço está ausente s3:GetObject no objeto certificado ou o objeto está criptografado com uma chave gerenciada pelo cliente que a função não pode usar. | s3:GetObjectConceda o certificado e, se o objeto usar uma chave KMS gerenciada pelo cliente, kms:Decrypt conceda essa chave. Consulte [Etapa 8: Conceder à função de serviço acesso ao certificado](kb-managed-sharepoint-entra-setup.md#kb-managed-sharepoint-entra-step8). | 

## Erros de certificado (Microsoft Entra ID App-Only)
<a name="kb-managed-ds-sharepoint-troubleshooting-cert"></a>


**Erros de certificado**  

| Sintomas | Causa provável | Correção | 
| --- | --- | --- | 
| Senha do certificado ou erros de criação de tokens durante a sincronização. | A .p12 senha não corresponde à certificatePassword do segredo. | certificatePasswordDefina a senha usada para criar o .p12 arquivo ou recrie o pacote com uma senha conhecida. | 
| A autenticação funcionava antes e agora todas as sincronizações falham. | O certificado expirou ou o consentimento do administrador foi revogado. | Gere um novo certificado, faça o upload do certificado público para o registro do aplicativo Entra, substitua-o .p12 no Amazon S3 e conceda novamente o consentimento do administrador. | 
| A sincronização falha com um erro de que o certificado não pôde ser carregado como X.509 PKCS \#12 (por exemplo, “Formato de certificado inválido — falha ao carregar como X.509 ou PKCS12"). | O Amazon Bedrock não conseguiu ler o certificado no Amazon S3 com as credenciais fornecidas. Os motivos comuns incluem uma falta ou um espaço certificatePassword em branco no segredo, um certificateS3Path que aponta para o objeto errado (por exemplo, um arquivo .cer /PEM ou um objeto restante) ou um certificado que não corresponde mais ao segredo. Isso é mais provável depois de reconfigurar uma fonte de dados ou alternar os métodos de autenticação. | Confirme se o segredo referenciado pela fonte de dados inclui um certificatePassword que corresponda ao seu .p12 pacote e que certificateS3Path aponte para isso. .p12 Se você reconfigurou a fonte de dados, verifique se o certificado e o segredo ainda correspondem e sincronize novamente. | 

## Gire o certificado
<a name="kb-managed-ds-sharepoint-rotate-cert"></a>

Gire o certificado antes que ele expire. Um certificado expirado faz com que todas as sincronizações falhem. Para alternar sem interromper o acesso, faça o upload do novo certificado como um objeto separado e alterne a fonte de dados para ele, para que o certificado existente continue funcionando até você cortá-lo.

1. Gere um novo certificado e pacote PKCS \#12 (`.p12`), conforme descrito em. [Configurar a App-Only autenticação Microsoft Entra ID para SharePoint](kb-managed-sharepoint-entra-setup.md)

1. No registro do aplicativo Entra, em **Certificados e segredos**, faça o upload do novo certificado público. Mantenha o certificado existente em vigor — o registro de um aplicativo pode conter vários certificados.

1. Faça o upload do novo `.p12` pacote para o Amazon S3 com **uma nova chave de objeto** (não substitua o objeto certificado existente). Confirme se sua função de serviço da base de conhecimento pode ler o novo objeto.

1. Atualize a fonte de dados para que ela `certificateS3Path` aponte para o novo objeto e atualize-a `certificatePassword` em seu AWS Secrets Manager segredo para corresponder ao novo pacote. Use a [UpdateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateDataSource.html)operação ou Console de gerenciamento da AWS o.

1. Inicie uma sincronização e confirme se ela foi concluída com êxito com o novo certificado.

1. Depois que a sincronização for bem-sucedida, remova o certificado antigo do registro do aplicativo Entra e exclua o `.p12` objeto antigo do Amazon S3.

## Erros de autenticação do OAuth 2.0
<a name="kb-managed-ds-sharepoint-troubleshooting-oauth2"></a>


**Erros do OAuth 2.0**  

| Sintomas | Causa provável | Correção | 
| --- | --- | --- | 
| A sincronização falha com uma mensagem de que a solicitação do token da API REST falhou com o status 400. | A conta exige MFA ou acesso condicional, que o fluxo de credenciais de senha do proprietário do recurso não pode satisfazer; ou o segredo não tem o campo or. userName password | Confirme se o segredo inclui clientId clientSecretuserName,, password e. Se a conta impuser MFA ou acesso condicional, mude para. [Configurar a App-Only autenticação Microsoft Entra ID para SharePoint](kb-managed-sharepoint-entra-setup.md) | 
| A sincronização falha após a alteração da senha da conta. | A senha armazenada não é mais válida. | Atualize o password campo no segredo. | 

## Erros de sincronização
<a name="kb-managed-ds-sharepoint-troubleshooting-sync"></a>


**Erros de sincronização**  

| Sintomas | Causa provável | Correção | 
| --- | --- | --- | 
| A sincronização é concluída, mas nenhum documento é indexado. | O aplicativo não pode acessar os sites configurados. ComSites.Selected, as permissões por site podem não ser concedidas. | Verifique as permissões do aplicativo e o consentimento do administrador. Se você usaSites.Selected, confirme uma concessão por site para cada site. Consulte [Etapa 5 (Sites.Selected somente): conceder acesso por site](kb-managed-sharepoint-entra-setup.md#kb-managed-sharepoint-entra-step5). | 
| Um site recém-adicionado não é rastreado ()Sites.Selected. | Per-site os subsídios não são retroativos, portanto, o novo site não tem subsídio. | Conceda ao aplicativo conector acesso ao novo site e sincronize novamente. | 
| Caminhos específicos não retornam resultados. | O caminho foi inserido como uma URL do navegador ou o item foi movido ou renomeado SharePoint. | Use o SharePoint caminho (não o URL do navegador) e verifique se o item ainda existe nesse caminho. | 

## Document-level problemas de controle de acesso
<a name="kb-managed-ds-sharepoint-troubleshooting-acl"></a>

As configurações incorretas da ACL não produzem erros explícitos durante a recuperação. Em vez disso, as consultas retornam menos ou zero resultados. Para ACL-specific sintomas, etapas de verificação e correções, consulte[Document-level controles de acesso](kb-managed-ds-sharepoint-acl.md).