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érations sur les fichiers, et que les journaux de débogage KONNEKT montrent des erreurs de l’API Graph, Microsoft Graph Explorer vous permet de reproduire la requête en échec directement dans le navigateur. Cela permet d’isoler si la cause première se situe dans le backend Microsoft 365 ou dans KONNEKT, et fournit des preuves propres pour une demande d’assistance Microsoft.

Microsoft Graph Explorer est un outil gratuit de Microsoft, basé sur le navigateur. Il envoie des requêtes à l’API Microsoft Graph, qui est la même interface que KONNEKT, l’application de synchronisation Microsoft OneDrive, Microsoft Teams et Microsoft 365 utilisent eux-mêmes 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 en même temps (souvent un signe d’un problème de backend).

• Les journaux de débogage KONNEKT montrent des erreurs de l’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.

• Un ralentissement intermittent persiste après que les vérifications habituelles de KONNEKT ont été écartées.

Collecter et examiner le journal de débogage

La façon 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 discrètement en arrière-plan - dans la plupart des cas, ni l’utilisateur ni l’administrateur ne remarque quoi que ce soit. Voir Préparation du journal de débogage pour le workflow de support standard.

Le workflow Graph Explorer est différent : vous devez ouvrir vous-même le fichier journal, localement, pour 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 par heure de modification et commencez par le fichier le plus récent. Ouvrez-le dans un éditeur de texte et recherchez error ou le code d’état HTTP que vous examinez (par exemple, 504).

Avant de reproduire le problème, définissez le niveau de journalisation sur Debug afin que les URL complètes des requêtes et les réponses de l’API Graph 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 de l’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 ultérieures :

• L’intégralité du GET URL (copiez tout jusqu’au code d’état HTTP, sans l’inclure).

• Le code d’état HTTP (504 dans cet exemple).

• La valeur request-id . Le support Microsoft peut tracer 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 disponible pour se connecter lui-même.

• Un navigateur web moderne (Microsoft Edge, Chrome, Firefox ou Safari).

• Le chemin complet et le nom de fichier exact signalés par l’utilisateur, ou l’URL de l’API Graph issue 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 d’assistance 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 la zone de saisie de la 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 Référence des autorisations 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 indicatives entre accolades par des valeurs réelles.

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

Copiez l’URL complète à partir de la ligne de 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 URL de Graph Explorer.

C’est l’option recommandée car elle reproduit exactement la requête 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}

Interrogez ensuite 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 panneau 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 Non autorisé	Le jeton est manquant, expiré ou invalide.	Déconnectez-vous de Graph Explorer puis reconnectez-vous. Si l’erreur persiste, voir Problèmes liés au jeton d’accès.
403 Interdit	L’utilisateur connecté n’a pas l’autorisation d’accéder à 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 Introuvable	Le fichier ou le dossier n’existe pas au chemin donné.	Vérifiez le chemin. Le fichier a peut-être été déplacé, renommé ou supprimé.
429 Trop de requêtes	Limitation de débit de SharePoint Online.	Limitation de débit côté Microsoft. Vérifiez l’en-tête Retry-After , attendez, puis réessayez. Les paramètres de prévention du throttling peuvent réduire la récurrence.
500 Erreur interne du serveur, 503 Service indisponible, 504 Délai d’attente de la passerelle dépassé	Erreur du backend Microsoft.	Le problème se situe du côté de Microsoft. Passez aux étapes suivantes.
UnknownError dans le corps de la réponse	Erreur du backend Microsoft sans code spécifique.	Même chose que ci-dessus. Capturez le request-id et ouvrez un ticket d’assistance Microsoft.

Étape 5 : Capturer les preuves

Avant de fermer Graph Explorer, documentez le test. De bonnes preuves accélèrent la résolution des tickets d’assistance.

Collectez :

• 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, avec le fuseau horaire.

• Le UPN de l’utilisateur connecté (par exemple, [email protected]).

• Le chemin exact du fichier testé.

• La valeur 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 d’assistance Microsoft

N’effectuez cette étape que si Graph Explorer a renvoyé une réponse 500, 503, 504 ou UnknownError .

1. Accédez à https://admin.microsoft.com et connectez-vous avec un compte Administrateur général.

2. Allez dans Support -> Nouvelle demande de service.

3. Sélectionnez SharePoint Online ou OneDrive Entreprise comme service concerné, en correspondant au point de terminaison ayant échoué.

4. Décrivez le problème et joignez les captures d’écran de l’étape précédente.

5. Incluez le request-id provenant à la fois du journal de débogage KONNEKT et de la réponse Graph Explorer. Cela permet à Microsoft de tracer les requêtes exactes qui ont échoué.

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 de l’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 d’un 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 SharePoint Search

• Problèmes liés au jeton d’accès - pour les réponses 401 Non autorisé

• Comment gérer les erreurs - pour les erreurs sur des fichiers spécifiques

• Préparation du journal de débogage - comment collecter des journaux avec les détails de l’API Graph

• Journalisation - configuration du niveau de journalisation