# Solución de problemas

Empiece aquí cuando algo no funcione. Siga estos pasos para identificar su problema e ir 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: [Reproducir 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á KONNEKT instalado?**
   * Compruebe: `Get-WmiObject -Class Win32_Product | Where-Object { $_.Name -like "*Konnekt*" }`
   * No instalado → [Instalar 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á. → [No se pudo 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 compruébelo de nuevo.
3. **¿Está en ejecución el servicio de KONNEKT?**
   * Compruebe: `Get-Service -Name "Konnekt*"`
   * No se está ejecutando → reinicie el servicio o reinstale.
4. **¿Ha iniciado sesión el usuario?**
   * Haga clic con el botón derecho en el icono de KONNEKT en la bandeja → **Cuentas**. Si no aparece ninguna cuenta, inicie sesión.
   * "Se requiere aprobación del administrador" → [Conceder consentimiento de administrador en 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?**
   * → [Hacer clic en un recurso compartido no hace nada](https://docs.konnekt.io/troubleshooting/clicking-a-share-does-nothing)

### Faltan sitios o bibliotecas

1. **¿Está usando mapeo automático?**
   * 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 [Mapeo automático](https://docs.konnekt.io/configuration/mappings/auto-mapping).
   * Verifique la pertenencia del usuario al grupo de Microsoft Entra ID si los sitios se filtran por grupo.
   * ¿Es propietario del sitio pero no miembro? La detección de KONNEKT solo encuentra los sitios de los que el usuario es **miembro** . → [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. **¿Está usando asignaciones administradas?**
   * Compruebe que la directiva `SharepointSites` esté aplicada: `gpresult /r` o compruebe el registro.
   * Verifique que la URL de SharePoint en la directiva sea correcta y accesible.
3. **¿Está intentando agregar un recurso compartido manualmente y obtiene "No se pudo abrir el sitio: No se encontró la clave"?**
   * → [Agregar recurso compartido: "No se encontró la clave"](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 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 del administrador o que los permisos de la API estén incompletos.
   * → [Conceder consentimiento de administrador en 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. **¿Una biblioteca específica 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?**
   * Es posible que la URL del sitio en la directiva sea 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. **"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 solicitud de MFA (solicitudes MFA repetidas)**
   * Conflicto de directiva de Conditional Access o problema con el intermediario WAM.
   * → [Conditional Access](https://docs.konnekt.io/installation/security/conditional-access)
3. **Cuenta incorrecta iniciada sesión**
   * 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"**
   * → [Conceder consentimiento de administrador en 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 en operaciones de archivo

1. **La carga falló**
   * 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 / de solo lectura inesperadamente**
   * Es posible que otro usuario tenga el archivo abierto sin coautoría habilitada.
   * El archivo puede superar el umbral de tamaño de solo lectura. → [Límites 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 según 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 abrir ("podría dañar su equipo")**
   * Mark of the 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 sitios de confianza. → [Agregar 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. → [Agregar 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 Reducción de la Superficie de Ataque (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 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 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 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 antivirus](https://docs.konnekt.io/troubleshooting/slow-performance-or-errors-caused-by-antivirus-scanning)

### Otros problemas

| Problema                                       | Solució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)                                                                                                                  |
| 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 KONNEKT en la bandeja        | 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

* [Reproducir 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 ponerse en contacto con el soporte de 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/es/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.