> 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 la API de Graph (HTTP 429, 500, 503, 504, o `Error desconocido`), 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. **¿Está en ejecución el servicio de KONNEKT?**
   * Compruebe: `Get-Service -Name "Konnekt*"`
   * No está en ejecución → reinicie el servicio o reinstale.
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 ocurre nada?**
   * → [Al hacer clic en un recurso compartido no ocurre nada](https://docs.konnekt.io/troubleshooting/clicking-a-share-does-nothing)

### Faltan sitios o bibliotecas

1. **¿Usa asignación automática?**
   * Compruebe que `O365SharepointUsage = 1` en el registro.
   * Verifique que el usuario tenga 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? La detección de KONNEKT solo encuentra los 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 de la directiva sea correcta y accesible.
3. **¿Intenta agregar un recurso compartido manualmente y 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 mediante la interfaz web de SharePoint.
   * El tipo de sitio puede no coincidir con la consulta KQL (por ejemplo, los sitios personales de OneDrive no se detectan con la consulta predeterminada).

→ [Sitios faltantes 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 de 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 sobre el contenido de la biblioteca. Compruebe los permisos de SharePoint.
   * La biblioteca puede estar 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 faltantes o carpetas vacías](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty)

### Errores de autenticación

1. **"Error al 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 equivocada**
   * Haga clic con el botón derecho en el icono de la bandeja → **Cuentas** → elimine la cuenta incorrecta → añada 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. **Falló la carga**
   * 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 el/los error(es)](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)
2. **Archivo bloqueado / 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. → [Límites de tamaño de apertura de archivos](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 en el nombre de archivo**
   * Compruebe la longitud de la ruta y del nombre de archivo 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 el/los error(es)](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)

### No se pueden abrir archivos de Office

1. **Office muestra una advertencia al abrirlo ("could harm your computer")**
   * Se aplica Mark of the Web (MOTW) a 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. → [Agregar 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 con macros de Excel no se abren**
   * Las rutas de KONNEKT deben estar en la zona de sitios de confianza. → [Agregar 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**
   * Las reglas de Attack Surface Reduction (ASR) pueden estar 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 las carpetas**
   * Compruebe el número de elementos en la carpeta (>1.000 elementos ralentizan 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 la API de Graph en el registro de depuración, [reprodúzcalo con Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) para confirmar limitación o problemas 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                                                                                                                                                                                                                                                                    |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Vista previa de PDF dañada (Windows 11)        | → [Vista previa de PDF dañada después de la actualización de Windows 11](https://docs.konnekt.io/troubleshooting/pdf-preview-broken-after-windows-11-update)                                                                                                                  |
| Una 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) - aislar 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 dynamically by asking a question.

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

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.