Dela via

Felsöka Azure API Management-principer i Visual Studio Code

  • Artikel

GÄLLER FÖR: Utvecklare

Principer i Azure API Management ger kraftfulla funktioner som hjälper API-utgivare att hantera övergripande problem som autentisering, auktorisering, begränsning, cachelagring och transformering. Principer är en samling instruktioner som körs sekventiellt på begäran av eller efter ett svar från ett API.

I den här artikeln beskrivs hur du felsöker API Management-principer med hjälp av Azure API Management-tillägget för Visual Studio Code.

Förutsättningar

Villkor och begränsningar

  • Den här funktionen använder den inbyggda (tjänstnivå) all-access-prenumerationen (visningsnamnet "Inbyggd all-access-prenumeration") för felsökning.

Viktigt!

  • API Management stöder inte längre prenumerationer för spårning eller Ocp-Apim-Trace-huvudet .
  • För att förbättra API-säkerheten kan spårning nu aktiveras på nivån för ett enskilt API genom att hämta en tidsbegränsad token med API Management REST API och skicka token i en begäran till gatewayen. Mer information finns i Aktivera spårning av ett API.
  • Var försiktig när du aktiverar spårning, eftersom den kan exponera känslig information i spårningsdata. Se till att du har lämpliga säkerhetsåtgärder för att skydda spårningsdata.

Initiera en felsökningssession

  1. Starta Visual Studio-kod
  2. Gå till API Management-tillägget under Azure-tillägg
  3. Hitta DEN API Management-instans som ska felsökas
  4. Hitta API:et och åtgärden för felsökning
  5. Högerklicka på åtgärden och välj Starta principfelsökning

I det här läget försöker tillägget initiera och upprätta en felsökningssession med API Management-gatewayen.

initiera felsökning

Skicka en testbegäran

När felsökningssessionen har upprättats öppnar tillägget en ny redigerare som gör att vi kan skapa och skicka en HTTP-testbegäran till den här åtgärden med hjälp av REST-klienttillägget.

Du kommer att märka att Ocp-Apim-Debug-huvudet redan har lagts till i begäran. Det här huvudet krävs och värdet måste anges till prenumerationsnyckeln för tjänstnivå och all åtkomst för att utlösa felsökningsfunktionen i API Management-gatewayen.

Ändra HTTP-begäran i redigeraren enligt ditt testscenario. Klicka sedan på Skicka begäran för att skicka testbegäran till API Management-gatewayen.

skicka en testbegäran

Felsökningsprinciper

När HTTP-testbegäran har skickats öppnar tillägget felsökningsfönstret som visar de effektiva principerna för den här åtgärden och stoppar vid den första effektiva principen.

felsökningsprinciper

Om du vill följa princippipelinen kan du steg för steg gå igenom enskilda principer eller ange en brytpunkt i en princip och gå direkt till den principen.

I panelen Variabler kan du granska värden för systemskapade och användarskapade variabler. I panelen Brytpunkter kan du se listan över alla brytpunkter som har angetts. I panelen Samtalsstack kan du se det aktuella gällande principomfånget.

Om det uppstår ett fel under principkörningen visas information om felet i principen där det inträffade.

undantag

Dricks

Kom ihåg att avsluta felsökningssessionen genom att klicka på knappen Stoppa när du är klar.

Nästa steg