# Resolução de problemas

Comece aqui quando algo não estiver funcionando. Siga estas etapas para identificar o seu problema e ir para a página de resolução relevante.

## Antes de começar

Se **vários usuários relatarem o mesmo problema ao mesmo tempo**, ou se os logs de depuração do KONNEKT mostrarem erros da Graph API (HTTP 429, 500, 503, 504, ou `UnknownError`), a causa raiz pode estar no backend do Microsoft 365 em vez de no KONNEKT. Confirme isso primeiro: [Reproduza problemas de arquivo com o Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer).

## Qual é o problema?

### As unidades ou compartilhamentos do KONNEKT não estão visíveis

1. **O KONNEKT está instalado?**
   * Verifique: `Get-WmiObject -Class Win32_Product | Where-Object { $_.Name -like "*Konnekt*" }`
   * Não instalado → [Instalar o KONNEKT](https://docs.konnekt.io/installation/setup)
   * Em dispositivos ARM64, certifique-se de ter instalado a versão ARM64. Uma instalação x64 em ARM64 parecerá bem-sucedida, mas o driver não será carregado. → [Falha ao abrir o dispositivo](https://docs.konnekt.io/troubleshooting/failed-to-open-device)
2. **O dispositivo foi reiniciado após a instalação?**
   * O KONNEKT requer uma reinicialização para carregar seu driver em modo kernel. Reinicie e verifique novamente.
3. **O serviço do KONNEKT está em execução?**
   * Verifique: `Get-Service -Name "Konnekt*"`
   * Não em execução → reinicie o serviço ou reinstale.
4. **O usuário está conectado?**
   * Clique com o botão direito no ícone da bandeja do KONNEKT → **Contas**. Se nenhuma conta estiver listada, entre.
   * "Aprovação do administrador necessária" → [Conceder consentimento de administrador em todo o tenant](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)
5. **A unidade ou compartilhamento está visível, mas clicar não faz nada?**
   * → [Clicar em um compartilhamento não faz nada](https://docs.konnekt.io/troubleshooting/clicking-a-share-does-nothing)

### Sites ou bibliotecas estão ausentes

1. **Usando mapeamento automático?**
   * Verifique se `O365SharepointUsage = 1` no registro.
   * Verifique se o usuário tem acesso ao site na interface web do SharePoint.
   * Verifique a consulta KQL do site - uma consulta restritiva pode excluir o site. Veja [Mapeamento automático](https://docs.konnekt.io/configuration/mappings/auto-mapping).
   * Verifique a associação do usuário ao grupo no Microsoft Entra ID se os sites forem filtrados por grupo.
   * Proprietário do site, mas não membro? A descoberta do KONNEKT encontra apenas os sites dos quais o usuário é **membro** de. → [Alguns sites ou bibliotecas não aparecem no KONNEKT](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/some-sites-or-libraries-do-not-appear-in-konnekt)
2. **Usando mapeamentos gerenciados?**
   * Verifique se a política `SharepointSites` está aplicada: `gpresult /r` ou verifique o registro.
   * Verifique se a URL do SharePoint na política está correta e acessível.
3. **Tentando adicionar um compartilhamento manualmente e recebendo "Falha ao abrir o site: Chave não encontrada"?**
   * → [Adicionar compartilhamento: "Chave não encontrada"](https://docs.konnekt.io/troubleshooting/add-share-key-not-found)
4. **O site existe no SharePoint, mas não no KONNEKT?**
   * O usuário pode não ter permissão para o site. Teste o acesso pela interface web do SharePoint.
   * O tipo de site pode não corresponder à consulta KQL (por exemplo, sites pessoais do OneDrive não são descobertos pela consulta padrão).

→ [Sites ausentes ou pastas vazias](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty) | [Alguns sites ou bibliotecas não aparecem](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/some-sites-or-libraries-do-not-appear-in-konnekt)

### As pastas estão vazias

1. **Todas as bibliotecas vazias?**
   * O consentimento do administrador pode não ter sido concedido, ou as permissões da API podem estar incompletas.
   * → [Conceder consentimento de administrador em todo o tenant](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)
   * → [Bibliotecas vazias](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/empty-libraries)
2. **Biblioteca específica vazia?**
   * O usuário pode não ter permissão para o conteúdo da biblioteca. Verifique as permissões do SharePoint.
   * A biblioteca pode realmente estar vazia.
3. **O mapeamento gerenciado mostra uma pasta vazia?**
   * A URL do site na política pode estar incorreta. Verifique-a abrindo a URL em um navegador.

→ [Bibliotecas vazias](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/empty-libraries) | [Sites ausentes ou pastas vazias](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty)

### Erros de autenticação

1. **"Falha ao obter token de acesso"**
   * → [Problemas com token de acesso](https://docs.konnekt.io/troubleshooting/access-token-issues)
2. **Loop de prompt de MFA (prompts de MFA repetidos)**
   * Conflito de política de Conditional Access ou problema no broker WAM.
   * → [Conditional Access](https://docs.konnekt.io/installation/security/conditional-access)
3. **Conta errada conectada**
   * Clique com o botão direito no ícone da bandeja → **Contas** → remova a conta errada → adicione a correta.
4. **"Aprovação do administrador necessária"**
   * → [Conceder consentimento de administrador em todo o tenant](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)

→ [Problemas com token de acesso](https://docs.konnekt.io/troubleshooting/access-token-issues)

### Erros de operação de arquivo

1. **Falha no envio**
   * Verifique os detalhes do erro pelo ícone da bandeja → **Erros**.
   * Verifique a conectividade de rede.
   * Verifique se há limitação de taxa do SharePoint (procure HTTP 429 nos logs de depuração). Se você vir limitação ou erros de backend, [reproduza com o Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) para confirmar problemas do lado da Microsoft.
   * → [Como lidar com o(s) erro(s)](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)
2. **Arquivo bloqueado / somente leitura inesperadamente**
   * Outro usuário pode ter o arquivo aberto sem coautoria habilitada.
   * O arquivo pode exceder o limite de tamanho para somente leitura. → [Limitações de tamanho ao abrir arquivos](https://docs.konnekt.io/configuration/system-settings/open-file-size-limitations)
3. **Permissão negada**
   * O usuário não tem permissão de gravação no SharePoint. Verifique pela interface web.
4. **"Caminho muito longo" ou erros de nome de arquivo**
   * Verifique o comprimento do caminho e do nome do arquivo em relação aos limites. → [Qual é o comprimento máximo do caminho e do nome do arquivo?](https://docs.konnekt.io/troubleshooting/what-is-the-maximum-path-and-file-name-length)

→ [Como lidar com o(s) erro(s)](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)

### A abertura de arquivos do Office falha

1. **O Office mostra um aviso ao abrir ("pode danificar seu computador")**
   * A Marca da Web (MOTW) é aplicada a arquivos de locais de rede. → [Abrir documentos do MS Office exibe uma mensagem de aviso](https://docs.konnekt.io/troubleshooting/opening-ms-office-documents-displays-a-warning-message)
   * Geralmente resolvido adicionando os caminhos do KONNEKT aos sites confiáveis. → [Adicionar caminhos do KONNEKT como sites confiáveis](https://docs.konnekt.io/troubleshooting/add-konnekt-paths-as-trusted-sites)
2. **Clicar duas vezes em um arquivo do Office não faz nada ou arquivos macro do Excel não abrem**
   * Os caminhos do KONNEKT precisam estar na zona de Sites Confiáveis. → [Adicionar caminhos do KONNEKT como sites confiáveis](https://docs.konnekt.io/troubleshooting/add-konnekt-paths-as-trusted-sites)
3. **O KONNEKT trava ao abrir ou visualizar arquivos do Office**
   * As regras de Redução da Superfície de Ataque (ASR) podem estar bloqueando o KONNEKT. Exclua `Konnekt.exe` e `KonnektStarter.exe` da regra ASR "Office Child Process". → [Ação arriscada bloqueada](https://docs.konnekt.io/troubleshooting/risky-action-blocked)
4. **O Office mostra uma versão desatualizada de um arquivo**
   * → [O Office mostra versões desatualizadas](https://docs.konnekt.io/troubleshooting/office-shows-outdated-versions)

### Problemas de desempenho

1. **Navegação lenta em pastas**
   * Verifique a contagem de itens na pasta (>1.000 itens tornam a navegação mais lenta).
   * Verifique as configurações de cache - um TTL muito baixo causa mais chamadas de API.
   * Se a lentidão estiver correlacionada com erros 429 ou 5xx da Graph API no log de depuração, [reproduza com o Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) para confirmar limitação ou problemas de backend.
2. **Abertura lenta de arquivos**
   * Verifique o tamanho do arquivo e a largura de banda da rede.
   * Verifique se há limitação de taxa (HTTP 429 nos logs). Se houver, [reproduza com o Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer).
3. **Lentidão intermitente (especialmente de manhã)**
   * Provavelmente o antivírus está examinando as unidades do KONNEKT.
   * → [Desempenho lento ou erros causados pela verificação do antivírus](https://docs.konnekt.io/troubleshooting/slow-performance-or-errors-caused-by-antivirus-scanning)

### Outros problemas

| Problema                                      | Resolução                                                                                                                                                                                                                                                                    |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Pré-visualização de PDF quebrada (Windows 11) | → [Pré-visualização de PDF quebrada após atualização do Windows 11](https://docs.konnekt.io/troubleshooting/pdf-preview-broken-after-windows-11-update)                                                                                                                      |
| X cinza nos arquivos                          | Comportamento esperado - o KONNEKT marca os arquivos como `FILE_ATTRIBUTE_OFFLINE` para economizar largura de banda. Não é um erro. Veja [Por que há um X cinza ou uma pasta marrom](https://docs.konnekt.io/troubleshooting/why-is-there-a-grey-x-on-my-files-and-folders). |
| Sobreposição de pasta marrom nos arquivos     | O arquivo está marcado para uso offline. Comportamento esperado.                                                                                                                                                                                                             |
| Ícone da bandeja do KONNEKT ausente           | Reinicie o dispositivo. Se ainda estiver ausente, reinstale o KONNEKT.                                                                                                                                                                                                       |
| Não consigo resolver o problema               | → [Preparar logs de depuração](https://docs.konnekt.io/troubleshooting/debug-log-preparation) e [entrar em contato com o suporte](https://docs.konnekt.io/support)                                                                                                           |

## Páginas relacionadas

* [Reproduza problemas de arquivo com o Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) - isolar problemas do KONNEKT de problemas do backend do Microsoft 365
* [Registro de alterações](https://docs.konnekt.io/changelog) - correções recentes e problemas resolvidos
* [Preparação dos logs de depuração](https://docs.konnekt.io/troubleshooting/debug-log-preparation) - como coletar logs para o suporte
* [Suporte](https://docs.konnekt.io/support) - como contatar o suporte do KONNEKT


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.konnekt.io/pt/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.