RewritePlugin

Reescreve pedidos.

Definição de instância de plug-in

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

Exemplo de configuração

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

Propriedades de configuração

Propriedade	Descrição	Predefinido
rewritesFile	Caminho para o arquivo que contém definições de regravação	rewrites.json

Opções de linha de comando

Nenhuma

Reescrever exemplos de arquivo

Seguem-se exemplos de regras de reescrita.

Reescreva todas as solicitações de HTTP para HTTPS

Reescreva todas as solicitações de HTTP para HTTPS. Neste contexto, tudo significa todas as solicitações configuradas com o Dev Proxy ou o 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"
      }
    }
  ]
}

Simula propriedades de arquivo

Propriedade	Descrição	Obrigatório
rewrites	Matriz de objetos de reescrita que define a lista de regras de reescrita que o RewritePlugin aplica às solicitações intercetadas	sim

Reescrever objeto

Cada regra de reescrita tem as seguintes propriedades:

Propriedade	Descrição	Obrigatório
in	Reescreva o padrão para corresponder à solicitação de entrada.	sim
out	Reescrever padrão para reescrever a solicitação	sim

Observações

Se a solicitação intercetada pelo RewritePlugin não corresponder a todas as propriedades definidas no padrão in, o plug-in não aplicará a regra de regravação à solicitação.

Padrão de reescrita

Cada padrão de reescrita tem as seguintes propriedades:

Propriedade	Descrição	Obrigatório	Valor predefinido	Valores de exemplo
url	Expressão regular que o plugin se aplica ao URL.	sim		^http://(.*)

Observações

Se você usar grupos de captura na expressão regular nos padrões in , poderá fazer referência a eles no padrão out . Por exemplo, se quiser reescrever http://example.com/foo no https://example.com/foo, você pode usar a seguinte regra de reescrita:

{
  "$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"
      }
    }
  ]
}