> 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 correspondante. ## Avant de commencer Si **plusieurs utilisateurs signalent le même problème en même temps**, ou si les journaux de débogage de KONNEKT montrent des erreurs de l'API Graph (HTTP 429, 500, 503, 504, ou `UnknownError`), la cause racine peut se situer du côté du backend de Microsoft 365 plutôt que dans KONNEKT. Confirmez d'abord ceci : [Reproduire 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 échouera au chargement. → [É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*"` * Pas 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 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) ### Des 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 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. **Utilisez-vous des mappages gérés ?** * Vérifiez que la `SharepointSites` stratégie 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 sur 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 personnels OneDrive 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 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 n'a peut-être pas l'autorisation d'accéder au contenu de la bibliothèque. Vérifiez les autorisations SharePoint. * La bibliothèque peut être réellement 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. **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érations sur les fichiers 1. **Échec du téléchargement** * 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 voyez une limitation ou des erreurs de backend, [reproduisez avec Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer) pour confirmer des 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 à l'ouverture des fichiers](https://docs.konnekt.io/configuration/system-settings/open-file-size-limitations) 3. **Accès refusé** * L'utilisateur n'a pas l'autorisation d'écriture dans SharePoint. Vérifiez via l'interface web. 4. **Erreurs de longueur de chemin ou 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 (« cela pourrait endommager votre ordinateur »)** * La marque du Web (MOTW) est appliquée aux fichiers provenant d'emplacements réseau. → [L'ouverture des 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 des 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 à l'API. * Si la lenteur est corrélée à des erreurs 429 ou 5xx de l'API Graph 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 de débit ou des problèmes de backend. 2. **Ouverture de fichier lente** * Vérifiez la taille du fichier et la bande passante réseau. * Vérifiez s'il y a une limitation de débit (HTTP 429 dans les journaux). Si oui, [reproduisez avec Graph Explorer](https://docs.konnekt.io/troubleshooting/reproduce-file-issues-with-graph-explorer). 3. **Lenteur intermittente (surtout le matin)** * Probablement due à l'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 valise marron](https://docs.konnekt.io/troubleshooting/why-is-there-a-grey-x-on-my-files-and-folders). | | Superposition de valise marron 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 * [Reproduire 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 de 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 joindre 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 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/fr/troubleshooting.md?ask=&goal= ``` `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.