> For the complete documentation index, see [llms.txt](https://docs.konnekt.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.konnekt.io/es/troubleshooting.md).

# Solución de problemas

Empiece aquí cuando algo no funcione. Siga estos pasos para identificar su problema y vaya a la página de resolución correspondiente.

## Antes de empezar

Si **varios usuarios informan del mismo problema al mismo tiempo**, o si los registros de depuración de KONNEKT muestran errores de Graph API (HTTP 429, 500, 503, 504 o `UnknownError`), la causa raíz puede estar en el backend de Microsoft 365 y no en KONNEKT. Confírmelo primero: [Reproduzca los problemas de archivos con Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer).

## ¿Cuál es el problema?

### Las unidades o recursos compartidos de KONNEKT no son visibles

1. **¿Está instalado KONNEKT?**
   * Compruebe: `Get-WmiObject -Class Win32_Product | Where-Object { $_.Name -like "*Konnekt*" }`
   * No instalado → [Instale KONNEKT](https://docs.konnekt.io/installation/setup)
   * En dispositivos ARM64, asegúrese de haber instalado la versión ARM64. Una instalación x64 en ARM64 parecerá correcta, pero el controlador no se cargará. → [Error al abrir el dispositivo](https://docs.konnekt.io/troubleshooting/failed-to-open-device)
2. **¿Se ha reiniciado el dispositivo después de la instalación?**
   * KONNEKT requiere un reinicio para cargar su controlador en modo kernel. Reinicie y compruebe de nuevo.
3. **¿Se está ejecutando el servicio de KONNEKT?**
   * Compruebe: `Get-Service -Name "Konnekt*"`
   * No se está ejecutando → reinicie el servicio o vuelva a instalar.
4. **¿Ha iniciado sesión el usuario?**
   * Haga clic con el botón derecho en el icono de la bandeja de KONNEKT → **Cuentas**. Si no aparece ninguna cuenta, inicie sesión.
   * "Se requiere aprobación del administrador" → [Conceda el consentimiento de administrador para todo el tenant](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)
5. **¿La unidad o el recurso compartido es visible pero al hacer clic no sucede nada?**
   * → [Al hacer clic en un recurso compartido no sucede nada](https://docs.konnekt.io/troubleshooting/clicking-a-share-does-nothing)

### Faltan sitios o bibliotecas

1. **¿Usa el mapeo automático?**
   * Compruebe que `O365SharepointUsage = 1` en el registro.
   * Verifique que el usuario tiene acceso al sitio en la interfaz web de SharePoint.
   * Compruebe la consulta KQL del sitio: una consulta restrictiva puede excluir el sitio. Consulte [Asignación automática](https://docs.konnekt.io/configuration/mappings/auto-mapping).
   * Verifique la pertenencia del usuario a grupos de Microsoft Entra ID si los sitios se filtran por grupo.
   * ¿Propietario del sitio pero no miembro? El descubrimiento de KONNEKT solo encuentra sitios de los que el usuario es **miembro** de. → [Algunos sitios o bibliotecas no aparecen en KONNEKT](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/some-sites-or-libraries-do-not-appear-in-konnekt)
2. **¿Usa asignaciones administradas?**
   * Compruebe que la `SharepointSites` directiva está aplicada: `gpresult /r` o compruebe el registro.
   * Verifique que la URL de SharePoint en la directiva sea correcta y accesible.
3. **¿Al intentar agregar un recurso compartido manualmente obtiene "Failed to open site: Key not found"?**
   * → [Agregar recurso compartido: "Key not found"](https://docs.konnekt.io/troubleshooting/add-share-key-not-found)
4. **¿El sitio existe en SharePoint pero no en KONNEKT?**
   * Es posible que el usuario no tenga permiso para el sitio. Pruebe el acceso a través de la interfaz web de SharePoint.
   * Es posible que el tipo de sitio no coincida con la consulta KQL (por ejemplo, los sitios personales de OneDrive no son detectados por la consulta predeterminada).

→ [Sitios que faltan o carpetas vacías](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty) | [Algunos sitios o bibliotecas no aparecen](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/some-sites-or-libraries-do-not-appear-in-konnekt)

### Las carpetas están vacías

1. **¿Todas las bibliotecas están vacías?**
   * Es posible que no se haya concedido el consentimiento del administrador o que los permisos de la API estén incompletos.
   * → [Conceda el consentimiento de administrador para todo el tenant](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)
   * → [Bibliotecas vacías](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/empty-libraries)
2. **¿Alguna biblioteca concreta está vacía?**
   * Es posible que el usuario no tenga permiso para el contenido de la biblioteca. Compruebe los permisos de SharePoint.
   * Es posible que la biblioteca esté realmente vacía.
3. **¿La asignación administrada muestra una carpeta vacía?**
   * La URL del sitio en la directiva puede ser incorrecta. Verifíquela abriendo la URL en un navegador.

→ [Bibliotecas vacías](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/empty-libraries) | [Sitios que faltan o carpetas vacías](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty)

### Errores de autenticación

1. **"No se pudo obtener el token de acceso"**
   * → [Problemas con el token de acceso](https://docs.konnekt.io/troubleshooting/access-token-issues)
2. **Bucle de solicitudes de MFA (solicitudes de MFA repetidas)**
   * Conflicto de directiva de Conditional Access o problema del intermediario WAM.
   * → [Conditional Access](https://docs.konnekt.io/installation/security/conditional-access)
3. **Se ha iniciado sesión con la cuenta incorrecta**
   * Haga clic con el botón derecho en el icono de la bandeja → **Cuentas** → elimine la cuenta incorrecta → agregue la correcta.
4. **"Se requiere aprobación del administrador"**
   * → [Conceda el consentimiento de administrador para todo el tenant](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)

→ [Problemas con el token de acceso](https://docs.konnekt.io/troubleshooting/access-token-issues)

### Errores de operación de archivos

1. **La carga ha fallado**
   * Compruebe los detalles del error mediante el icono de la bandeja → **Errores**.
   * Verifique la conectividad de red.
   * Compruebe si se está produciendo limitación de SharePoint (busque HTTP 429 en los registros de depuración). Si ve limitación o errores del backend, [reprodúzcalo con Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) para confirmar problemas del lado de Microsoft.
   * → [Cómo tratar los errores](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)
2. **Archivo bloqueado / de solo lectura inesperadamente**
   * Es posible que otro usuario tenga el archivo abierto sin la coautoría habilitada.
   * El archivo puede superar el umbral de tamaño de solo lectura. → [Limitaciones de tamaño de archivo al abrir](https://docs.konnekt.io/configuration/system-settings/open-file-size-limitations)
3. **Permiso denegado**
   * El usuario no tiene permiso de escritura en SharePoint. Verifíquelo mediante la interfaz web.
4. **"Ruta demasiado larga" o errores de nombre de archivo**
   * Compruebe la longitud de la ruta y del nombre de archivo con respecto a los límites. → [¿Cuál es la longitud máxima de la ruta y del nombre de archivo?](https://docs.konnekt.io/troubleshooting/what-is-the-maximum-path-and-file-name-length)

→ [Cómo tratar los errores](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)

### No se pueden abrir archivos de Office

1. **Office muestra una advertencia al abrirse ("podría dañar su equipo")**
   * La marca de la web (MOTW) se aplica a los archivos de ubicaciones de red. → [Al abrir documentos de MS Office se muestra un mensaje de advertencia](https://docs.konnekt.io/troubleshooting/opening-ms-office-documents-displays-a-warning-message)
   * A menudo se resuelve agregando las rutas de KONNEKT a los sitios de confianza. → [Agregue las rutas de KONNEKT como sitios de confianza](https://docs.konnekt.io/troubleshooting/add-konnekt-paths-as-trusted-sites)
2. **Hacer doble clic en un archivo de Office no hace nada o los archivos de macros de Excel no se abren**
   * Las rutas de KONNEKT deben estar en la zona de sitios de confianza. → [Agregue las rutas de KONNEKT como sitios de confianza](https://docs.konnekt.io/troubleshooting/add-konnekt-paths-as-trusted-sites)
3. **KONNEKT se bloquea al abrir o previsualizar archivos de Office**
   * Es posible que las reglas de Attack Surface Reduction (ASR) estén bloqueando KONNEKT. Excluya `Konnekt.exe` y `KonnektStarter.exe` de la regla ASR "Office Child Process". → [Acción de riesgo bloqueada](https://docs.konnekt.io/troubleshooting/risky-action-blocked)
4. **Office muestra una versión desactualizada de un archivo**
   * → [Office muestra versiones desactualizadas](https://docs.konnekt.io/troubleshooting/office-shows-outdated-versions)

### Problemas de rendimiento

1. **Navegación lenta por carpetas**
   * Compruebe el número de elementos en la carpeta (>1.000 elementos ralentiza la navegación).
   * Compruebe la configuración de la caché: un TTL muy bajo provoca más llamadas a la API.
   * Si la lentitud se correlaciona con errores 429 o 5xx de Graph API en el registro de depuración, [reprodúzcalo con Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) para confirmar problemas de limitación o del backend.
2. **Apertura lenta de archivos**
   * Compruebe el tamaño del archivo y el ancho de banda de la red.
   * Compruebe si hay limitación (HTTP 429 en los registros). Si está presente, [reprodúzcalo con Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer).
3. **Lentitud intermitente (especialmente por las mañanas)**
   * Probablemente el antivirus está analizando las unidades de KONNEKT.
   * → [Rendimiento lento o errores causados por el análisis del antivirus](https://docs.konnekt.io/troubleshooting/slow-performance-or-errors-caused-by-antivirus-scanning)

### Otros problemas

| Problema                                        | Resolución                                                                                                                                                                                                                                                                    |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| La vista previa de PDF no funciona (Windows 11) | → [La vista previa de PDF no funciona después de la actualización de Windows 11](https://docs.konnekt.io/troubleshooting/pdf-preview-broken-after-windows-11-update)                                                                                                          |
| X gris en los archivos                          | Comportamiento esperado: KONNEKT marca los archivos como `FILE_ATTRIBUTE_OFFLINE` para ahorrar ancho de banda. No es un error. Consulte [¿Por qué hay una X gris o una maleta marrón](https://docs.konnekt.io/troubleshooting/why-is-there-a-grey-x-on-my-files-and-folders). |
| Superposición de maleta marrón en los archivos  | El archivo está marcado para uso sin conexión. Comportamiento esperado.                                                                                                                                                                                                       |
| Falta el icono de la bandeja de KONNEKT         | Reinicie el dispositivo. Si sigue faltando, reinstale KONNEKT.                                                                                                                                                                                                                |
| No se puede resolver el problema                | → [Prepare los registros de depuración](https://docs.konnekt.io/troubleshooting/debug-log-preparation) y [contacte con soporte](https://docs.konnekt.io/support)                                                                                                              |

## Páginas relacionadas

* [Reproduzca los problemas de archivos con Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) - aísle los problemas de KONNEKT de los problemas del backend de Microsoft 365
* [Registro de cambios](https://docs.konnekt.io/changelog) - correcciones recientes y problemas resueltos
* [Preparación de registros de depuración](https://docs.konnekt.io/troubleshooting/debug-log-preparation) - cómo recopilar registros para soporte
* [Soporte](https://docs.konnekt.io/support) - cómo contactar con el soporte de KONNEKT


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.konnekt.io/es/troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.