Teknisk referens för Dev Proxy

Det här avsnittet innehåller teknisk referens för dev proxy-plugin-program och konfigurationsalternativ.

Vilket plugin-program ska jag använda för rapportering och analys?

Använd följande tabell för att välja det plugin-program som matchar det du vill lära dig om appens API-trafik. Plugin-program som skapar en rapport behöver en reporter, till exempel JsonReporter, MarkdownReporter eller PlainTextReporter, för att spara rapporten i en fil. Generatorpluginer skriver sin utdatafil direkt. Dev Proxy skapar utdatafilerna i den aktuella arbetskatalogen när du har slutat spela in.

Goal	Plugin + reporter	Utdatafil
Inventera de URL:er som min app anropar	UrlDiscoveryPlugin + JsonReporter	UrlDiscoveryPlugin_JsonReporter.json
Räkna begäranden och deras resultat	ExecutionSummaryPlugin + MarkdownReporter eller JsonReporter	ExecutionSummaryPlugin_MarkdownReporter.md eller ExecutionSummaryPlugin_JsonReporter.json
Samla in fullständiga begäranden och svar	HarGeneratorPlugin	devproxy-yyyyMMddHHmmss.har
Skapa förfrågningar som kan spelas upp på nytt	HttpFileGeneratorPlugin	requests_yyyyMMddHHmmss.http
Skapa en API-specifikation från trafik	OpenApiSpecGeneratorPlugin eller TypeSpecGeneratorPlugin	host-port-yyyyMMddHHmmss.json (eller .yaml) per API-värd eller name-yyyyMMddHHmmss.tsp per API-värd
Skapa mockar från trafik	MockGeneratorPlugin	mocks-yyyyMMddHHmmss.json
Hitta de minsta behörigheterna som min app behöver	MinimalPermissionsPlugin + MarkdownReporter eller JsonReporter	MinimalPermissionsPlugin_MarkdownReporter.md eller MinimalPermissionsPlugin_JsonReporter.json

Note

Om det redan finns en rapportfil med samma namn lägger reportern till en tidsstämpel i filnamnet, till exempel UrlDiscoveryPlugin_JsonReporter_yyyyMMddHHmmss.json. För Microsoft Graph API:er använder du GraphMinimalPermissionsPlugin för att hitta de minsta behörigheterna.

Plugin

Lista över plugin-program som fungerar med alla API:er.

Namn	beskrivning
AuthPlugin	Simulerar autentisering och auktorisering med hjälp av API-nycklar eller OAuth2.
DevToolsPlugin	Exponerar Dev Proxy-meddelanden och information om avlyssnade begäranden och svar i Chrome DevTools. Stöder både HTTP och STDIO.
CachingGuidancePlugin	Visar en varning när Dev Proxy snappade upp samma begäran inom den angivna tidsperioden.
CrudApiPlugin	Simulerar ett CRUD-API med ett minnesinternt datalager.
ExecutionSummaryPlugin	Genererar en sammanfattningsrapport över de begäranden som passerar genom proxyn.
GenericRandomErrorPlugin	Begäranden misslyckas med ett slumpmässigt valt fel från en fil som innehåller mockade fel.
HarGeneratorPlugin	Genererar HTTP-arkivfiler (HAR) från snappade begäranden och svar.
HttpFileGeneratorPlugin	Genererar HTTP-fil från snappade begäranden och svar.
LanguageModelFailurePlugin	Simulerar olika scenarier med fel i språkmodeller för att testa motståndskraften hos språkmodellberoende program.
LanguageModelRateLimitingPlugin	Simulerar tokenbaserad hastighetsbegränsning för språkmodell-API:er genom att spåra förbrukning av prompt- och slutförandetoken inom konfigurerbara tidsfönster.
LatencyPlugin	Fördröjer svar med ett slumpmässigt antal millisekunder från det konfigurerade intervallet. Stöder både HTTP och STDIO.
MinimalCsomPermissionsPlugin	Identifierar de minsta behörigheter som krävs för att anropa registrerade API-begäranden för SharePoint Client-Side Object Model (CSOM).
MinimalPermissionsPlugin	Returnerar de minimala behörigheter som krävs för att anropa de registrerade API-begärandena. Använder API-information från den angivna lokala mappen.
MinimalPermissionsGuidancePlugin	Jämför de behörigheter som används i JWT-token som skickas till API:er med de minsta nödvändiga omfång som krävs för begäranden som proxyn har registrerat och visar skillnaden.
MockGeneratorPlugin	Genererar Dev Proxy-simuleringar baserat på de uppfångade begärandena.
MockRequestPlugin	Gör att du kan utfärda webbbegäranden med dev proxy.
MockResponsePlugin	Simulerar svar.
MockStdioResponsePlugin	Simulerar svar för STDIO-baserade program, till exempel MCP-servrar.
ODataPagingGuidancePlugin	Visar en varning när proxyn fångar upp en OData-pagineringsbegäran med en URL som inte tidigare har returnerats i någon av de uppfångade svaren.
OpenAIMockResponsePlugin	Simulerar svar från Azure OpenAI och OpenAI med hjälp av en lokal språkmodell.
OpenAITelemetryPlugin	Genererar telemetridata för OpenAI-kompatibla API-begäranden.
OpenAIUsageDebuggingPlugin	Loggar Användningsstatistik för OpenAI API till en CSV-fil för felsökning och analys.
OpenApiSpecGeneratorPlugin	Genererar OpenAPI-specifikationen från de avlyssnade begärandena och svaren.
RateLimitingPlugin	Simulerar hastighetsbegränsningsbeteenden.
Försök igenAfterPlugin	Simulerar headern som Retry-After skickas av ett API efter att ha begränsat en begäran.
SkrivomPlugin	Skriver om begäranden.
TypeSpecGeneratorPlugin	Genererar TypeSpec-filer från avlyssnade begäranden och svar.
UrlDiscoveryPlugin	Skapar en lista över URL:er som proxyn har avlyssnat.

Plugin-program för Azure API Center

Lista över plugin-program som fungerar med Azure API Center.

Namn	beskrivning
ApiCenterMinimalPermissionsPlugin	Kontrollerar om appen använder minimal behörighet för att anropa API:er. Använder API-information från den angivna Azure API Center-instansen.
ApiCenterOnboardingPlugin	Kontrollerar om DE API:er som används i en app är registrerade i den angivna Azure API Center-instansen.
ApiCenterProductionVersionPlugin	Kontrollerar om DE API:er som används i en app är produktionsversion av API:erna som registrerats i den angivna Azure API Center-instansen.

Microsoft Entra-plugins

Lista över plugin-program som fungerar med Microsoft Entra API.

Namn	beskrivning
EntraMockResponsePlugin	Hånar svar till Microsoft Entra.

Plugin-program för Microsoft Graph

Lista över plugin-program som fungerar med Microsoft Graph API.

Namn	beskrivning
GraphBetaSupportGuidancePlugin	Visar en varning när proxyn identifierar en begäran till Betaslutpunkten i Microsoft Graph.
GraphClientRequestIdGuidancePlugin	Visar ett tips när en begäran till Microsoft Graph API inte innehåller client-request-id rubriken.
GraphConnectorGuidancePlugin	Visar kontextuell vägledning för att arbeta med Microsoft Graph-kopplingar.
GraphMinimalPermissionsPlugin	Returnerar en lista över de minimala behörigheter som krävs för Microsoft Graph-begäranden som proxyn registrerade.
GraphMinimalPermissionsGuidancePlugin	Jämför de behörigheter som används i JWT-token som skickas till Microsoft Graph med de minsta nödvändiga omfång som krävs för begäranden som proxyn registrerade och visar skillnaden.
GraphMockResponsePlugin	Simulerar svar på Microsoft Graph-API:er.
GraphRandomErrorPlugin	Begäranden till Microsoft Graph misslyckas på grund av slumpmässiga fel.
GraphSdkGuidancePlugin	Visar ett tips när proxyn fångar upp en begäran till Microsoft Graph som inte har utfärdats av en Microsoft Graph SDK.
GraphSelectGuidancePlugin	Visar en varning när proxyn fångar upp en begäran till Microsoft Graph-API:er som inte innehåller frågesträngsparametern $select .
ODSPSearchGuidancePlugin	Visar en varning när Dev Proxy identifierar en begäran till OneDrive- och SharePoint-sök-API:er.

Reportrar

Lista över reportrar som genererar rapporter i olika format.

Namn	beskrivning
JsonReporter	Genererar rapporter i JSON-format.
MarkdownReporter	Genererar rapporter i Markdown-format.
PlainTextReporter	Genererar rapporter i oformaterad textformat.

Konfiguration

Referens för konfigurationsalternativ för Dev Proxy.

Namn	beskrivning
devproxyrc	Konfigurationsfil för Dev Proxy.
Proxy-API	API för att interagera med Dev Proxy programmatiskt.
Proxyinställningar	Konfigurationsalternativ för proxyinställningar.