# Dépannage

Commencez ici quand quelque chose ne fonctionne pas. Suivez ces étapes pour identifier votre problème et accéder à la page de résolution correspondante.

## Avant de commencer

Si **plusieurs utilisateurs signalent le même problème en même temps**, ou si les journaux de débogage KONNEKT montrent des erreurs Graph API (HTTP 429, 500, 503, 504, ou `UnknownError`), la cause racine peut se situer dans le backend Microsoft 365 plutôt que dans KONNEKT. Vérifiez d’abord cela : [Reproduire les problèmes de fichier avec Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer).

## Quel est le problème ?

### Les lecteurs ou partages KONNEKT ne sont pas visibles

1. **KONNEKT est-il installé ?**
   * Vérifiez : `Get-WmiObject -Class Win32_Product | Where-Object { $_.Name -like "*Konnekt*" }`
   * Non installé → [Installer KONNEKT](https://docs.konnekt.io/installation/setup)
   * Sur les appareils ARM64, assurez-vous d’avoir installé la version ARM64. Une installation x64 sur ARM64 semblera réussie, mais le pilote ne se chargera pas. → [Échec de l’ouverture du périphérique](https://docs.konnekt.io/troubleshooting/failed-to-open-device)
2. **L’appareil a-t-il été redémarré après l’installation ?**
   * KONNEKT nécessite un redémarrage pour charger son pilote en mode noyau. Redémarrez et vérifiez à nouveau.
3. **Le service KONNEKT est-il en cours d’exécution ?**
   * Vérifiez : `Get-Service -Name "Konnekt*"`
   * Non exécuté → redémarrez le service ou réinstallez.
4. **L’utilisateur est-il connecté ?**
   * Cliquez avec le bouton droit sur l’icône de la zone de notification KONNEKT → **Comptes**. Si aucun compte n’est सूचीé, connectez-vous.
   * « Approbation de l’administrateur requise » → [Accorder le consentement administrateur à l’échelle du tenant](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)
5. **Le lecteur ou le partage est visible, mais cliquer ne fait rien ?**
   * → [Cliquer sur un partage ne fait rien](https://docs.konnekt.io/troubleshooting/clicking-a-share-does-nothing)

### Les sites ou bibliothèques sont manquants

1. **Utilisez-vous le mappage automatique ?**
   * Vérifiez que `O365SharepointUsage = 1` dans le registre.
   * Vérifiez que l’utilisateur a accès au site dans l’interface web SharePoint.
   * Vérifiez la requête de site KQL - une requête restrictive peut exclure le site. Voir [Mappage automatique](https://docs.konnekt.io/configuration/mappings/auto-mapping).
   * Vérifiez l’appartenance du groupe Microsoft Entra ID de l’utilisateur si les sites sont filtrés par groupe.
   * Propriétaire du site mais pas membre ? La découverte KONNEKT ne trouve que les sites dont l’utilisateur est **membre** . → [Certains sites ou bibliothèques n’apparaissent pas dans KONNEKT](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/some-sites-or-libraries-do-not-appear-in-konnekt)
2. **Utilisez-vous des mappages gérés ?**
   * Vérifiez que la stratégie `SharepointSites` est appliquée : `gpresult /r` ou vérifiez le registre.
   * Vérifiez que l’URL SharePoint dans la stratégie est correcte et accessible.
3. **Vous essayez d’ajouter un partage manuellement et obtenez « Échec de l’ouverture du site : clé introuvable » ?**
   * → [Ajouter un partage : « Clé introuvable »](https://docs.konnekt.io/troubleshooting/add-share-key-not-found)
4. **Le site existe dans SharePoint mais pas dans KONNEKT ?**
   * L’utilisateur peut ne pas avoir l’autorisation d’accéder au site. Testez l’accès via l’interface web SharePoint.
   * Le type de site peut ne pas correspondre à la requête KQL (par exemple, les sites OneDrive personnels ne sont pas découverts par la requête par défaut).

→ [Sites manquants ou dossiers vides](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty) | [Certains sites ou bibliothèques n’apparaissent pas](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/some-sites-or-libraries-do-not-appear-in-konnekt)

### Les dossiers sont vides

1. **Toutes les bibliothèques sont vides ?**
   * Le consentement administrateur n’a peut-être pas été accordé, ou les autorisations de l’API sont incomplètes.
   * → [Accorder le consentement administrateur à l’échelle du tenant](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)
   * → [Bibliothèques vides](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/empty-libraries)
2. **Une bibliothèque spécifique est vide ?**
   * L’utilisateur peut ne pas avoir l’autorisation sur le contenu de la bibliothèque. Vérifiez les autorisations SharePoint.
   * La bibliothèque peut réellement être vide.
3. **Un mappage géré affiche un dossier vide ?**
   * L’URL du site dans la stratégie peut être incorrecte. Vérifiez-la en ouvrant l’URL dans un navigateur.

→ [Bibliothèques vides](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/empty-libraries) | [Sites manquants ou dossiers vides](https://docs.konnekt.io/troubleshooting/causes-of-missing-content/sites-missing-or-folders-empty)

### Erreurs d’authentification

1. **« Échec de l’obtention du jeton d’accès »**
   * → [Problèmes de jeton d’accès](https://docs.konnekt.io/troubleshooting/access-token-issues)
2. **Boucle de demande MFA (demandes MFA répétées)**
   * Conflit de stratégie Conditional Access ou problème de courtier WAM.
   * → [Conditional Access](https://docs.konnekt.io/installation/security/conditional-access)
3. **Mauvais compte connecté**
   * Cliquez avec le bouton droit sur l’icône de la zone de notification → **Comptes** → supprimez le mauvais compte → ajoutez le bon.
4. **« Approbation de l’administrateur requise »**
   * → [Accorder le consentement administrateur à l’échelle du tenant](https://docs.konnekt.io/installation/security/grant-admin-consent-in-enterprise-applications)

→ [Problèmes de jeton d’accès](https://docs.konnekt.io/troubleshooting/access-token-issues)

### Erreurs d’opération sur les fichiers

1. **Le téléversement a échoué**
   * Vérifiez les détails de l’erreur via l’icône de la zone de notification → **Erreurs**.
   * Vérifiez la connectivité réseau.
   * Vérifiez si une limitation SharePoint est en cours (recherchez HTTP 429 dans les journaux de débogage). Si vous voyez des limitations ou des erreurs du backend, [reproduisez avec Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) pour confirmer les problèmes côté Microsoft.
   * → [Comment gérer les erreurs](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)
2. **Fichier verrouillé / en lecture seule de manière inattendue**
   * Un autre utilisateur peut avoir le fichier ouvert sans coédition activée.
   * Le fichier peut dépasser le seuil de taille en lecture seule. → [Limites de taille des fichiers ouverts](https://docs.konnekt.io/configuration/system-settings/open-file-size-limitations)
3. **Autorisation refusée**
   * L’utilisateur n’a pas l’autorisation d’écriture dans SharePoint. Vérifiez via l’interface web.
4. **« Chemin trop long » ou erreurs de nom de fichier**
   * Vérifiez la longueur du chemin et du nom de fichier par rapport aux limites. → [Quelle est la longueur maximale du chemin et du nom de fichier ?](https://docs.konnekt.io/troubleshooting/what-is-the-maximum-path-and-file-name-length)

→ [Comment gérer les erreurs](https://docs.konnekt.io/troubleshooting/how-to-deal-with-error-s)

### L’ouverture des fichiers Office échoue

1. **Office affiche un avertissement à l’ouverture (« pourrait endommager votre ordinateur »)**
   * Le Mark of the Web (MOTW) est appliqué aux fichiers provenant d’emplacements réseau. → [L’ouverture de documents MS Office affiche un message d’avertissement](https://docs.konnekt.io/troubleshooting/opening-ms-office-documents-displays-a-warning-message)
   * Souvent résolu en ajoutant les chemins KONNEKT aux sites de confiance. → [Ajouter les chemins KONNEKT comme sites de confiance](https://docs.konnekt.io/troubleshooting/add-konnekt-paths-as-trusted-sites)
2. **Un double-clic sur un fichier Office ne fait rien ou les fichiers macro Excel ne s’ouvrent pas**
   * Les chemins KONNEKT doivent se trouver dans la zone Sites de confiance. → [Ajouter les chemins KONNEKT comme sites de confiance](https://docs.konnekt.io/troubleshooting/add-konnekt-paths-as-trusted-sites)
3. **KONNEKT plante lors de l’ouverture ou de l’aperçu de fichiers Office**
   * Les règles de réduction de la surface d’attaque (ASR) peuvent bloquer KONNEKT. Excluez `Konnekt.exe` et `KonnektStarter.exe` de la règle ASR « Office Child Process ». → [Action risquée bloquée](https://docs.konnekt.io/troubleshooting/risky-action-blocked)
4. **Office affiche une version obsolète d’un fichier**
   * → [Office affiche des versions obsolètes](https://docs.konnekt.io/troubleshooting/office-shows-outdated-versions)

### Problèmes de performances

1. **Navigation dans les dossiers lente**
   * Vérifiez le nombre d’éléments dans le dossier (>1 000 éléments ralentissent la navigation).
   * Vérifiez les paramètres du cache - un TTL très faible entraîne davantage d’appels API.
   * Si la lenteur est corrélée à des erreurs Graph API 429 ou 5xx dans le journal de débogage, [reproduisez avec Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) pour confirmer une limitation ou des problèmes de backend.
2. **Ouverture de fichiers lente**
   * Vérifiez la taille du fichier et la bande passante réseau.
   * Vérifiez la limitation (HTTP 429 dans les journaux). Si elle est présente, [reproduisez avec Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer).
3. **Lenteur intermittente (surtout le matin)**
   * Probablement une analyse antivirus des lecteurs KONNEKT.
   * → [Lenteur des performances ou erreurs causées par l’analyse antivirus](https://docs.konnekt.io/troubleshooting/slow-performance-or-errors-caused-by-antivirus-scanning)

### Autres problèmes

| Problème                                           | Résolution                                                                                                                                                                                                                                                                                     |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Aperçu PDF cassé (Windows 11)                      | → [Aperçu PDF cassé après la mise à jour Windows 11](https://docs.konnekt.io/troubleshooting/pdf-preview-broken-after-windows-11-update)                                                                                                                                                       |
| X gris sur les fichiers                            | Comportement attendu - KONNEKT marque les fichiers comme `FILE_ATTRIBUTE_OFFLINE` pour économiser la bande passante. Ce n’est pas une erreur. Voir [Pourquoi y a-t-il un X gris ou une mallette brune](https://docs.konnekt.io/troubleshooting/why-is-there-a-grey-x-on-my-files-and-folders). |
| Superposition de mallette brune sur les fichiers   | Le fichier est marqué pour une utilisation hors ligne. Comportement attendu.                                                                                                                                                                                                                   |
| Icône de la zone de notification KONNEKT manquante | Redémarrez l’appareil. Si elle est toujours absente, réinstallez KONNEKT.                                                                                                                                                                                                                      |
| Impossible de résoudre le problème                 | → [Préparer les journaux de débogage](https://docs.konnekt.io/troubleshooting/debug-log-preparation) et [contacter le support](https://docs.konnekt.io/support)                                                                                                                                |

## Pages associées

* [Reproduire les problèmes de fichier avec Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) - isoler les problèmes KONNEKT des problèmes du backend Microsoft 365
* [Journal des modifications](https://docs.konnekt.io/changelog) - correctifs récents et problèmes résolus
* [Préparation des journaux de débogage](https://docs.konnekt.io/troubleshooting/debug-log-preparation) - comment collecter les journaux pour le support
* [Support](https://docs.konnekt.io/support) - comment contacter le support 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/fr/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.