Reproduire les problèmes de fichiers avec Graph Explorer

Lorsque les utilisateurs signalent une navigation lente, des ouvertures de fichiers échouées ou d’autres erreurs d’opération de fichiers et que les journaux de débogage KONNEKT montrent des erreurs d’API Graph, Microsoft Graph Explorer vous permet de reproduire directement dans le navigateur la requête qui échoue. Cela permet d’isoler si la cause racine se situe dans le backend Microsoft 365 ou dans KONNEKT, et fournit des preuves propres pour un ticket de support Microsoft.

Microsoft Graph Explorer est un outil gratuit de Microsoft, accessible via le navigateur. Il envoie des requêtes à l’API Microsoft Graph, qui est la même interface utilisée par KONNEKT, l’application de synchronisation Microsoft OneDrive, Microsoft Teams et Microsoft 365 lui-même pour lire et écrire des fichiers SharePoint Online et OneDrive. Aucune installation n’est requise.

Quand utiliser ce guide

Utilisez cette procédure lorsque :

• Plusieurs utilisateurs signalent le même problème au même moment (souvent le signe d’un problème de backend).
• Les journaux de débogage KONNEKT montrent des erreurs d’API Graph (HTTP 429, 500, 503, 504, ou UnknownError).
• Vous devez prouver au support Microsoft que le problème n’est pas causé par un logiciel tiers.
• Une lenteur intermittente persiste après que les vérifications habituelles de KONNEKT ont été écartées.

Collecter et examiner le journal de débogage

La manière normale d’obtenir les journaux KONNEKT pour le support consiste à exécuter crashguard.exe depuis C:\Program Files\Konnekt. Ce flux regroupe les journaux et les téléverse silencieusement en arrière-plan - dans la plupart des cas, ni l’utilisateur ni l’administrateur ne remarquent quoi que ce soit. Voir Préparation des journaux de débogage pour le flux de support standard.

Le flux Graph Explorer est différent : vous devez ouvrir vous-même le fichier journal, localement, afin de copier l’URL de la requête en échec et request-id dans Graph Explorer. Les fichiers journaux se trouvent à :

%LOCALAPPDATA%\Konnekt

KONNEKT conserve jusqu’à six fichiers journaux rotatifs d’environ 1 Mo chacun. Triez-les par heure de modification et commencez par le fichier le plus récent. Ouvrez-le dans un éditeur de texte et recherchez erreur ou le code d’état HTTP que vous examinez (par exemple, 504).

Avant de reproduire le problème, réglez le niveau de journalisation sur Débogage afin que les URL complètes des requêtes API Graph et les réponses soient capturées. Voir Journalisation pour savoir comment modifier le niveau de journalisation via l’interface Préférences, le registre ou une stratégie gérée.

À quoi ressemble une erreur d’API Graph dans le journal KONNEKT

Une entrée d’erreur typique :

[2026-04-22 14:14:25.281] [22380] [error] [RESTkitClient] Requête HTTP (OneDriveClient::GetItemByPath)
GET: https://graph.microsoft.com/v1.0/drives/b!YbLv.../root:%2F...%2F03:?$select=remoteItem,id,name,... - 504
    error: Réponse non reconnue(504)
    "{"error":{"code":"UnknownError","message":"","innerError":{
      "date":"2026-04-22T12:14:25",
      "request-id":"dc38b1d9-cd9d-4f3d-b75a-5448695fa719",
      "client-request-id":"dc38b1d9-cd9d-4f3d-b75a-5448695fa719"
    }}}"

Notez ces valeurs pour les étapes suivantes :

• L’intégralité de l’ GET URL (copiez tout jusqu’au code d’état HTTP, sans l’inclure).
• Le code d’état HTTP (504 dans cet exemple).
• Le request-id valeur. Le support Microsoft peut retracer la requête en échec à l’aide de cet identifiant.

Prérequis

• Accès au compte Microsoft 365 de l’utilisateur concerné, ou à l’utilisateur pour qu’il puisse se connecter lui-même.
• Un navigateur web moderne (Microsoft Edge, Chrome, Firefox ou Safari).
• Le chemin exact du fichier et le nom de fichier signalés par l’utilisateur, ou l’URL de l’API Graph à partir du journal de débogage.
• Accès Administrateur général au centre d’administration Microsoft 365 (uniquement si vous prévoyez d’ouvrir un ticket de support Microsoft).

Vous devez vous connecter en tant qu’utilisateur qui rencontre le problème, et non en tant qu’administrateur. L’utilisation d’un autre compte modifie les autorisations et l’accès aux fichiers, ce qui invalide le test.

Étape 1 : Ouvrir Graph Explorer

1. Ouvrez votre navigateur et accédez à https://developer.microsoft.com/graph/graph-explorer.
2. Cliquez sur Se connecter dans le coin supérieur gauche.
3. Connectez-vous avec les identifiants de l’utilisateur concerné.

Étape 2 : Accorder les autorisations requises

Graph Explorer utilise des autorisations déléguées. Pour les tests liés aux fichiers, accordez les étendues suivantes :

Étendue	Objectif
User.Read	Lire le profil de l’utilisateur connecté
Files.Read	Lire les fichiers OneDrive de l’utilisateur
Files.Read.All	Lire tous les fichiers auxquels l’utilisateur a accès
Sites.Read.All	Lire les éléments des sites SharePoint auxquels l’utilisateur a accès

Pour accorder les étendues :

1. Dans Graph Explorer, cliquez sur l’onglet Modifier les autorisations sous le champ de requête.
2. Localisez chaque étendue dans la liste.
3. Cliquez sur Consentement à côté de chaque étendue.
4. Acceptez l’invite de consentement.

Pour la référence complète des étendues, voir la référence des autorisations de Microsoft.

Étape 3 : Exécuter une requête de test

Définissez la méthode HTTP sur GET et saisissez l’une des requêtes ci-dessous dans le champ de l’URL de requête. Remplacez les valeurs de l’espace réservé entre accolades par de vraies valeurs.

Option A : Réutiliser l’URL du journal de débogage KONNEKT

Copiez l’URL complète de la ligne du journal qui commence par GET: https://graph.microsoft.com/.... Collez tout ce qui précède le code d’état HTTP, sans l’inclure, dans le champ d’URL de Graph Explorer.

C’est l’option recommandée, car elle reproduit la requête exacte qui a échoué.

Option B : Construire la requête manuellement

Pour lister le dossier racine OneDrive de l’utilisateur :

GET https://graph.microsoft.com/v1.0/me/drive/root/children

Pour accéder à un fichier spécifique par chemin :

GET https://graph.microsoft.com/v1.0/me/drive/root:/Documents/Reports/example.pdf

Pour accéder à un fichier sur un site SharePoint, obtenez d’abord l’ID du site :

GET https://graph.microsoft.com/v1.0/sites/{hostname}:/{site-path}

Puis interrogez le fichier à l’aide de cet ID de site :

GET https://graph.microsoft.com/v1.0/sites/{site-id}/drive/root:/Shared Documents/Folder/example.pdf

Cliquez sur Exécuter la requête et examinez le panneau de réponse.

Étape 4 : Interpréter le résultat

Le volet de réponse affiche un code d’état HTTP et un corps JSON. Utilisez le tableau ci-dessous pour classer le résultat et décider de l’étape suivante.

Code d’état	Signification	Étape suivante
200 OK	L’appel à l’API Graph a réussi. Le fichier est accessible au niveau de l’API.	Le problème se situe du côté de KONNEKT ou dans l’environnement client. Retournez au centre de dépannage.
401 Unauthorized	Le jeton est manquant, expiré ou invalide.	Déconnectez-vous de Graph Explorer, puis reconnectez-vous. Si l’erreur persiste, voir Problèmes de jeton d'accès.
403 Forbidden	L’utilisateur connecté n’a pas l’autorisation pour ce fichier ou ce site.	Il ne s’agit pas d’un problème KONNEKT ni d’un problème de backend Microsoft. Vérifiez les autorisations dans l’interface web SharePoint.
404 Not Found	Le fichier ou le dossier n’existe pas au chemin indiqué.	Vérifiez le chemin. Le fichier a peut-être été déplacé, renommé ou supprimé.
429 Too Many Requests	Limitation de débit SharePoint Online.	Limitation de débit côté Microsoft. Vérifiez l’ Retry-After en-tête, attendez, puis réessayez. Les paramètres de prévention de la limitation de débit peuvent réduire les récurrences.
500 Internal Server Error, 503 Service Unavailable, 504 Gateway Timeout	Erreur du backend Microsoft.	Le problème se situe du côté de Microsoft. Poursuivez avec les étapes suivantes.
UnknownError dans le corps de la réponse	Erreur du backend Microsoft sans code spécifique.	Idem ci-dessus. Capturez le request-id et ouvrez un ticket de support Microsoft.

Étape 5 : Capturer les preuves

Avant de fermer Graph Explorer, documentez le test. De bonnes preuves permettent de résoudre les tickets de support plus rapidement.

Recueillez :

• Une capture d’écran de la fenêtre Graph Explorer montrant l’URL de la requête, le code d’état HTTP et le corps de la réponse.
• La date et l’heure du test, y compris le fuseau horaire.
• L’UPN de l’utilisateur connecté (par exemple, [e-mail]).
• Le chemin exact du fichier qui a été testé.
• Le request-id valeur du corps de réponse JSON.
• Pour les erreurs intermittentes, répétez la requête plusieurs fois et capturez chaque résultat.

Étape 6 : Ouvrir un ticket de support Microsoft

Ne suivez cette étape que si Graph Explorer a renvoyé une réponse 500, 503, 504 ou UnknownError réponse.

1. Accédez à https://admin.microsoft.com et connectez-vous avec un compte Administrateur général.
2. Accédez à Support -> Nouvelle demande de service.
3. Sélectionnez SharePoint Online ou OneDrive pour les entreprises comme service concerné, en faisant correspondre l’endpoint qui a échoué.
4. Décrivez le problème et joignez les captures d’écran de l’étape précédente.
5. Incluez le request-id à la fois du journal de débogage KONNEKT et de la réponse Graph Explorer. Cela permet à Microsoft de retracer les requêtes exactes en échec.
6. Indiquez explicitement que le problème a été reproduit dans Microsoft Graph Explorer.

L’inclusion de preuves Graph Explorer indique que les causes tierces ont déjà été écartées. Le support Microsoft traite généralement ces tickets plus rapidement.

Points de terminaison courants de l’API Graph

Référence rapide des points de terminaison les plus souvent vus dans les journaux de débogage KONNEKT :

Opération	Point de terminaison
Profil utilisateur	GET /me
Liste de la racine OneDrive	GET /me/drive/root/children
Fichier par chemin (OneDrive)	GET /me/drive/root:/{path}
Fichier par ID d’élément	GET /drives/{drive-id}/items/{item-id}
Site par nom d’hôte et chemin	GET /sites/{hostname}:/{site-path}
Lecteurs SharePoint sur un site	GET /sites/{site-id}/drives
Téléchargement du contenu du fichier	GET /drives/{drive-id}/items/{item-id}/content
Requête delta	GET /drives/{drive-id}/root/delta

Pour la référence complète, voir le Microsoft Graph Drive API.

Problèmes similaires

• Sites manquants ou dossiers vides - pour les erreurs du backend de recherche SharePoint
• Problèmes de jeton d'accès - pour les réponses 401 Unauthorized
• Comment gérer les erreurs - pour les erreurs sur des fichiers spécifiques
• Préparation des journaux de débogage - comment collecter les journaux avec les détails de l’API Graph
• Journalisation - configuration du niveau de journalisation