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.

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

   • 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

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

5. A unidade ou compartilhamento está visível, mas clicar não faz nada?

   • → Clicar em um compartilhamento não faz nada

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.

   • 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

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"

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 | Alguns sites ou bibliotecas não aparecem

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

   • → Bibliotecas vazias

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 | Sites ausentes ou pastas vazias

Erros de autenticação

1. "Falha ao obter token de acesso"

   • → Problemas com token de acesso

2. Loop de prompt de MFA (prompts de MFA repetidos)

   • Conflito de política de Conditional Access ou problema no broker WAM.

   • → 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

→ Problemas com token de acesso

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 para confirmar problemas do lado da Microsoft.

   • → Como lidar com o(s) erro(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

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?

→ Como lidar com o(s) erro(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

   • Geralmente resolvido adicionando os caminhos do KONNEKT aos sites confiáveis. → Adicionar caminhos do KONNEKT como sites confiáveis

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

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

4. O Office mostra uma versão desatualizada de um arquivo

   • → O Office mostra versões desatualizadas

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

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

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
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.
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 e entrar em contato com o suporte

Páginas relacionadas

• Reproduza problemas de arquivo com o Graph Explorer - isolar problemas do KONNEKT de problemas do backend do Microsoft 365

• Registro de alterações - correções recentes e problemas resolvidos

• Preparação dos logs de depuração - como coletar logs para o suporte

• Suporte - como contatar o suporte do KONNEKT