> 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/fr/troubleshooting.md). # Dépannage Commencez ici lorsque quelque chose ne fonctionne pas. Suivez ces étapes pour identifier votre problème et accéder à la page de résolution appropriée. ## 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 de l'API Graph (HTTP 429, 500, 503, 504, ou `UnknownError`), la cause racine peut se situer dans le backend Microsoft 365 plutôt que dans KONNEKT. Confirmez d'abord cela : [Reproduisez les problèmes de fichiers 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 pourra pas se charger. → [Impossible d'ouvrir le 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 puis vérifiez à nouveau. 3. **Le service KONNEKT est-il en cours d'exécution ?** * Vérifiez : `Get-Service -Name "Konnekt*"` * Non en cours d'exécution → 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 répertorié, 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. **Vous utilisez 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 KQL du site - 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 de KONNEKT ne trouve que les sites dont l'utilisateur est **membre** de. → [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. **Vous utilisez des mappages gérés ?** * Vérifiez que la `SharepointSites` politique 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 "Failed to open site: Key not found" ?** * → [Ajouter un partage : "Key not found"](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 disposer d'autorisations pour le 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étectés 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 API peuvent être 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. **Bibliothèque spécifique vide ?** * L'utilisateur peut ne pas avoir l'autorisation d'accéder au contenu de la bibliothèque. Vérifiez les autorisations SharePoint. * La bibliothèque peut réellement être vide. 3. **Le 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 d'invite MFA (invitations 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. **Compte incorrect 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. **Échec du téléversement** * 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 de débit SharePoint se produit (recherchez HTTP 429 dans les journaux de débogage). Si vous constatez une limitation de débit ou des erreurs côté serveur, [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 a peut-être le fichier ouvert sans coédition activée. * Le fichier peut dépasser le seuil de taille en lecture seule. → [Limitations de taille d'ouverture de fichier](https://docs.konnekt.io/configuration/system-settings/open-file-size-limitations) 3. **Accès refusé** * L'utilisateur n'a pas d'autorisation d'écriture dans SharePoint. Vérifiez via l'interface web. 4. **"Chemin trop long" ou erreurs de nom de fichier** * Vérifiez que la longueur du chemin et du nom de fichier respecte les 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 ("cela 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 de 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 lente dans les dossiers** * 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 coïncide avec 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 un problème de limitation de débit ou côté serveur. 2. **Ouverture lente des fichiers** * Vérifiez la taille du fichier et la bande passante réseau. * Vérifiez la limitation de débit (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 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 de Windows 11](https://docs.konnekt.io/troubleshooting/pdf-preview-broken-after-windows-11-update) | | Croix grise sur les fichiers | Comportement attendu - KONNEKT marque les fichiers comme `FILE_ATTRIBUTE_OFFLINE` pour économiser la bande passante. Pas une erreur. Voir [Pourquoi y a-t-il une croix grise ou une valise brune](https://docs.konnekt.io/troubleshooting/why-is-there-a-grey-x-on-my-files-and-folders). | | Superposition de valise 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 connexes * [Reproduisez les problèmes de fichiers 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) - corrections récentes 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 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/fr/troubleshooting.md?ask=&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.