Skriv omPlugin

Skriver om begäranden.

Definition av plugin-instans

{
  "name": "RewritePlugin",
  "enabled": true,
  "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
  "configSection": "rewritePlugin"
}

Konfigurationsexempel

{
  "rewritePlugin": {
    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v1.0.0/rewriteplugin.schema.json",
    "rewritesFile": "rewrites.json"
  }
}

Konfigurationsegenskaper

Fastighet	beskrivning	Standard
rewritesFile	Sökväg till filen som innehåller omskrivningsdefinitioner	rewrites.json

Kommandoradsalternativ

Ingen

Skriva om filexempel

Här följer exempel på omskrivningsregler.

Skriv om alla begäranden från HTTP till HTTPS

Skriv om alla begäranden från HTTP till HTTPS. I det här sammanhanget innebär alla begäranden som konfigurerats med Dev Proxy eller RewritePlugin.

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v1.0.0/rewriteplugin.rewritesfile.schema.json",
  "rewrites": [
    {
      "in": {
        "url": "^http://(.*)"
      },
      "out": {
        "url": "https://$1"
      }
    }
  ]
}

Simulerar filegenskaper

Fastighet	beskrivning	Obligatoriskt
rewrites	Matris med omskrivningsobjekt som definierar listan över omskrivningsregler som omskrivningspluggen gäller för de begäranden som den fångar upp	ja

Skriv om objekt

Varje omskrivningsregel har följande egenskaper:

Fastighet	beskrivning	Obligatoriskt
in	Skriv om mönstret för att matcha den inkommande begäran.	ja
out	Skriv om mönstret för att skriva om begäran	ja

Kommentarer

Om begäran som RewritePlugin fångar upp matchar inte alla egenskaper som definierats i in-mönstret tillämpar plugin-programmet inte omskrivningsregeln på begäran.

Skriv om mönster

Varje omskrivningsmönster har följande egenskaper:

Fastighet	beskrivning	Obligatoriskt	Standardvärde	Exempelvärde
url	Reguljärt uttryck som plugin-programmet gäller för URL:en.	ja		^http://(.*)

Kommentarer

Om du använder avbildningsgrupper i det reguljära uttrycket i in-mönstren kan du referera till dem i ut-mönstret. Om du till exempel vill skriva om http://example.com/foo till https://example.com/fookan du använda följande omskrivningsregel:

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v1.0.0/rewriteplugin.rewritesfile.schema.json",
  "rewrites": [
    {
      "in": {
        "url": "^http://(.*)"
      },
      "out": {
        "url": "https://$1"
      }
    }
  ]
}