> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Débogage des piles HTTP personnalisées > Débogage des piles HTTP personnalisées # Débogage des piles HTTP personnalisées Utilisez cet article lorsque votre titre utilise directement une pile HTTP personnalisée au lieu de xCurl et que vous devez déboguer le trafic via un proxy tel que [XBOX Multiplayer Analysis Tool (XMAT)](/fr/tools/tools-services/live-xbox-multiplayer-analysis-tool). Pour les instructions et les téléchargements en amont, consultez la [documentation du projet XMAT](https://github.com/microsoft/xbox-multiplayer-analysis-tool/blob/main/README.md) et les [versions de XMAT](https://github.com/microsoft/xbox-multiplayer-analysis-tool/releases). Fiddler est également pris en charge. ## Quand utiliser ces conseils Ces conseils sont particulièrement utiles lorsqu'une ou plusieurs des conditions suivantes s'appliquent : * Votre titre doit inspecter ou appliquer directement les paramètres de proxy. * Votre flux de travail de débogage dépend de XMAT, de Fiddler ou d'un autre proxy de développement. * Votre pile HTTP n'utilise pas Schannel comme fournisseur de sécurité et doit charger explicitement les certificats du proxy. Pour des conseils généraux en matière de sécurité, consultez [Bonnes pratiques pour des requêtes web et des WebSockets sécurisés pour les titres du Microsoft Game Development Kit](/fr/build/game-principles/security/secure-webrequest-impl). ## Paramètres de proxy sur XBOX et PC Lorsque vous gérez les paramètres de proxy sur XBOX, privilégiez `WinHttpGetProxySettingsEx` avec `WinHttpProxySettingsTypeXBox` lorsque ce chemin est disponible dans votre build et votre environnement cible. Sur XBOX, cette API est l'API d'avenir pour lire les paramètres de proxy à partir du Microsoft Game Development Kit (GDK) d'avril 2026. Si votre titre cible un GDK antérieur sur XBOX, le chemin des paramètres de proxy propre à XBOX n'est pas disponible. Dans ce cas, définissez manuellement l'adresse et le port du proxy dans votre pile HTTP. Le chemin de chargement des certificats décrit plus loin dans cet article s'applique toujours à ces GDK plus anciens, même si l'API d'adresse de proxy propre à XBOX n'est pas disponible. Les titres PC peuvent également interroger les paramètres de proxy via WinHTTP, mais ne copiez pas directement le flux XBOX. Sur PC, `WinHttpGetProxySettingsEx` est asynchrone ; attendez donc que l'opération soit terminée avant d'appeler `WinHttpGetProxySettingsResultEx` et de copier les valeurs de proxy renvoyées dans votre pile HTTP. Un exemple utilisant libcurl consiste à résoudre l'adresse du proxy à l'aide de l'API de paramètres de proxy XBOX, puis à la transmettre directement à la pile. L'exemple ouvre la session avec `WINHTTP_FLAG_ASYNC` et inscrit un rappel d'état afin que le code gère à la fois une exécution synchrone et un retour `ERROR_IO_PENDING`. L'exemple suivant illustre le flux d'appels : ```cpp theme={null} // WinHttpCreateProxyResolver is not declared in WinHttp.h when using the GDK. WINHTTPAPI DWORD WINAPI WinHttpCreateProxyResolver(HINTERNET hSession, HINTERNET* phResolver); std::string ResolveXboxProxy() { HINTERNET session = WinHttpOpen( L"CustomHttp/1.0", WINHTTP_ACCESS_TYPE_AUTOMATIC_PROXY, WINHTTP_NO_PROXY_NAME, WINHTTP_NO_PROXY_BYPASS, WINHTTP_FLAG_ASYNC); if (!session) return {}; struct ProxyContext { HANDLE event; DWORD error; }; ProxyContext ctx{ CreateEventW(nullptr, TRUE, FALSE, nullptr), ERROR_SUCCESS }; WinHttpSetStatusCallback(session, [](HINTERNET, DWORD_PTR context, DWORD status, LPVOID info, DWORD) { auto* c = reinterpret_cast(context); if (status == WINHTTP_CALLBACK_STATUS_GETPROXYFORURL_COMPLETE) { c->error = ERROR_SUCCESS; SetEvent(c->event); } else if (status == WINHTTP_CALLBACK_STATUS_REQUEST_ERROR) { c->error = reinterpret_cast(info)->dwError; SetEvent(c->event); } }, WINHTTP_CALLBACK_FLAG_ALL_COMPLETIONS, 0); HINTERNET resolver = nullptr; if (WinHttpCreateProxyResolver(session, &resolver) != ERROR_SUCCESS) { CloseHandle(ctx.event); WinHttpCloseHandle(session); return {}; } DWORD result = WinHttpGetProxySettingsEx( resolver, WinHttpProxySettingsTypeXBox, nullptr, reinterpret_cast(&ctx)); if (result == ERROR_IO_PENDING) { // Wait for the async callback to fire (5-second timeout). WaitForSingleObject(ctx.event, 5000); result = ctx.error; } std::string proxyAddress; if (result == ERROR_SUCCESS) { WINHTTP_PROXY_SETTINGS_EX proxySettings{}; if (WinHttpGetProxySettingsResultEx(resolver, &proxySettings) == ERROR_SUCCESS) { PCWSTR proxy = proxySettings.pcwszSecureProxy != nullptr ? proxySettings.pcwszSecureProxy : proxySettings.pcwszProxy; if (proxy != nullptr) { // Example function for conversion. proxyAddress = Utf16ToUtf8(std::wstring(proxy)); } WinHttpFreeProxySettingsEx(WinHttpProxySettingsTypeXBox, &proxySettings); } } CloseHandle(ctx.event); WinHttpCloseHandle(resolver); WinHttpCloseHandle(session); return proxyAddress; } std::string proxyAddress = ResolveXboxProxy(); if (!proxyAddress.empty()) { curl_easy_setopt(curlHandle, CURLOPT_PROXY, proxyAddress.c_str()); } ``` ## Comportement du fournisseur TLS ### Piles basées sur Schannel Si votre pile s'appuie sur un comportement TLS reposant sur Schannel, la console applique automatiquement le certificat de proxy que vous configurez. Ce comportement s'applique également aux builds libcurl qui utilisent Schannel comme fournisseur TLS. ### Piles non basées sur Schannel Si votre pile s'appuie sur OpenSSL ou sur un autre fournisseur TLS autre que Schannel, votre titre est responsable du chargement explicite du certificat requis par l'outil de débogage actif. Conservez ce chemin de chargement de certificat dans votre code de mise en production. Sur console, les titres doivent également conserver le chemin de débogage via proxy associé dans les builds `RETAIL` afin que vous puissiez toujours diagnostiquer le trafic passant par un proxy si nécessaire. Pour obtenir des conseils sur l'approbation, les proxys et les paramètres sécurisés par défaut, consultez [Bonnes pratiques pour des requêtes web et des WebSockets sécurisés pour les titres du Microsoft Game Development Kit](/fr/build/game-principles/security/secure-webrequest-impl). ## Trouver le certificat racine du proxy Pour les piles non basées sur Schannel, chargez explicitement le certificat qui correspond à l'outil de débogage et conservez ce chemin dans votre code de mise en production. L'emplacement et le sujet du certificat dépendent de l'outil. Par exemple, [XBOX Multiplayer Analysis Tool (XMAT)](/fr/tools/tools-services/live-xbox-multiplayer-analysis-tool) utilise le certificat `Xbox Multiplayer Analysis Tool Root Cert Authority` dans `CurrentUser\Root`. Cet exemple recherche ce certificat et copie les octets du certificat encodé en DER dans une mémoire tampon appartenant au titre. ```cpp theme={null} #include #include HRESULT ExtractXmatRootCertificateDer(_Out_ std::vector& encodedCertificate) { encodedCertificate.clear(); constexpr DWORD certificateStoreLocation = CERT_SYSTEM_STORE_CURRENT_USER; constexpr wchar_t certificateStoreName[] = L"Root"; constexpr wchar_t certificateSubjectName[] = L"Xbox Multiplayer Analysis Tool Root Cert Authority"; HCERTSTORE certificateStore = CertOpenStore( CERT_STORE_PROV_SYSTEM_W, 0, 0, certificateStoreLocation | CERT_STORE_OPEN_EXISTING_FLAG | CERT_STORE_READONLY_FLAG, certificateStoreName); if (certificateStore == nullptr) { return HRESULT_FROM_WIN32(GetLastError()); } PCCERT_CONTEXT certificate = CertFindCertificateInStore( certificateStore, X509_ASN_ENCODING | PKCS_7_ASN_ENCODING, 0, CERT_FIND_SUBJECT_STR_W, certificateSubjectName, nullptr); if (certificate == nullptr) { HRESULT hr = HRESULT_FROM_WIN32(GetLastError()); CertCloseStore(certificateStore, 0); return hr; } encodedCertificate.assign( certificate->pbCertEncoded, certificate->pbCertEncoded + certificate->cbCertEncoded); CertFreeCertificateContext(certificate); CertCloseStore(certificateStore, 0); return S_OK; } ``` Après cette étape, transmettez `encodedCertificate` au chemin de chargement de certificat utilisé par votre fournisseur TLS. ## Flux de travail de débogage suggéré 1. Configurez la console pour le proxy de débogage : * Pour XMAT, ajoutez une capture **Web Proxy** pour la console, puis sélectionnez **Enable XBOX Proxy**. Pour plus d'informations, consultez [Utiliser XBOX Multiplayer Analysis Tool pour inspecter et modifier le trafic réseau](/fr/tools/tools-services/live-xbox-multiplayer-analysis-tool). * Pour Fiddler, configurez les paramètres de proxy de la console dans XBOX Device Portal comme décrit dans [Fiddler sur les kits de développement XBOX](/fr/build/console-features/networking/tools/fiddler-setup-networking). 2. Si vous ciblez XBOX avec le GDK d'avril 2026 ou ultérieur et que votre titre doit inspecter directement les paramètres de proxy, utilisez `WinHttpGetProxySettingsEx` avec `WinHttpProxySettingsTypeXBox`. 3. Si votre chemin de code PC interroge les paramètres de proxy via WinHTTP, attendez le résultat asynchrone avant d'appeler `WinHttpGetProxySettingsResultEx` et d'appliquer les valeurs de proxy renvoyées. 4. Si vous ciblez un GDK antérieur sur XBOX ou utilisez une pile qui n'exploite pas le chemin des paramètres de proxy propre à XBOX, définissez manuellement l'adresse et le port du proxy dans votre titre. 5. Si vous utilisez Schannel, appuyez-vous sur le certificat appliqué par la console. Si vous utilisez OpenSSL ou une autre pile, récupérez dans le magasin de certificats le certificat de l'outil de débogage que vous utilisez et chargez-le explicitement. ## Pages connexes * [Utiliser XBOX Multiplayer Analysis Tool pour inspecter et modifier le trafic réseau](/fr/tools/tools-services/live-xbox-multiplayer-analysis-tool) * [Fiddler sur les kits de développement XBOX](/fr/build/console-features/networking/tools/fiddler-setup-networking) * [Bonnes pratiques pour des requêtes web et des WebSockets sécurisés pour les titres du Microsoft Game Development Kit](/fr/build/game-principles/security/secure-webrequest-impl) ## Related topics - [Glossaire GDK des termes et acronymes](/fr/home/glossary.md) - [Glossaire des termes et acronymes du GDK](/fr-CA/home/glossary.md) - [Compiler et exécuter votre premier titre console GDKX](/fr-CA/home/build-first-title/first-console-title-walkthrough.md) - [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md) - [Installer la chaîne d'outils du GDK](/fr/home/setup-install/download-install.md)