Создайте настраиваемый подключаемый модуль

Статья
2025-03-10

Из этой статьи вы узнаете, как создать пользовательский плагин для Dev-прокси. Создавая подключаемые модули для прокси-сервера разработки, вы можете расширить функциональные возможности и добавить пользовательские функции в соответствии с вашими потребностями.

Предварительные условия

Прежде чем приступить к созданию пользовательского плагина, убедитесь, что у вас есть следующие требования:

Базовый пакет SDK для .NET
Последняя версия библиотеки DLL абстракции прокси-сервера разработки, которую можно найти на странице выпусков GitHub для прокси-сервера разработки.

Создайте новый подключаемый модуль

Выполните следующие действия, чтобы создать новый проект:

Создайте проект библиотеки классов с помощью dotnet new classlib команды.
```
dotnet new classlib -n MyCustomPlugin
```
Откройте созданный проект в Visual Studio Code.
```
code MyCustomPlugin
```
Добавьте DLL-файл Dev Proxy Abstractions (dev-proxy-abstractions.dll) в папку проекта.

dev-proxy-abstractions.dll Добавьте ссылку на файл проектаDevProxyCustomPlugin.csproj.

<ItemGroup>
  <Reference Include="dev-proxy-abstractions">
    <HintPath>.\dev-proxy-abstractions.dll</HintPath>
    <Private>false</Private>
    <ExcludeAssets>runtime</ExcludeAssets>
  </Reference>
</ItemGroup>

Добавьте пакеты NuGet, необходимые для проекта.

dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.Binder
dotnet add package Microsoft.Extensions.Logging.Abstractions
dotnet add package Unobtanium.Web.Proxy

Исключите библиотеки зависимостей DLL из выходных данных сборки, добавив тег ExcludeAssets на каждый PackageReference в файле DevProxyCustomPlugin.csproj.
```
<ExcludeAssets>runtime</ExcludeAssets>
```

Создайте новый класс, реализующий BaseProxyPlugin интерфейс.

using Microsoft.DevProxy.Abstractions;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Logging;

namespace MyCustomPlugin;

public class CatchApiCalls(IPluginEvents pluginEvents, IProxyContext context, ILogger logger, ISet<UrlToWatch> UrlsToWatch, IConfigurationSection? configSection = null) : BaseProxyPlugin(pluginEvents, context, logger, UrlsToWatch, configSection)
{
  public override string Name => nameof(CatchApiCalls);

  public override async Task RegisterAsync()
  {
    await base.RegisterAsync();

    PluginEvents.BeforeRequest += BeforeRequestAsync;
  }

  private Task BeforeRequestAsync(object sender, ProxyRequestArgs e)
  {
    if (UrlsToWatch is null ||
      !e.HasRequestUrlMatch(UrlsToWatch))
    {
      // No match for the URL, so we don't need to do anything
      Logger.LogRequest("URL not matched", MessageType.Skipped, new LoggingContext(e.Session));
      return Task.CompletedTask;
    }

    var headers = e.Session.HttpClient.Request.Headers;
    var header = headers.Where(h => h.Name == "Authorization").FirstOrDefault();
    if (header is null)
    {
      Logger.LogRequest($"Does not contain the Authorization header", MessageType.Warning, new LoggingContext(e.Session));
      return Task.CompletedTask;
    }

    return Task.CompletedTask;
  }
}

Создайте свой проект.
```
dotnet build
```

Использование пользовательского подключаемого модуля

Чтобы использовать настраиваемый подключаемый модуль, необходимо добавить его в файл конфигурации тестового прокси-сервера.

Добавьте новую конфигурацию плагина в файл devproxyrc.json.

{
  "plugins": [{
    "name": "CatchApiCalls",
    "enabled": true,
    "pluginPath": "./bin/Debug/net8.0/MyCustomPlugin.dll",
  }]
}

Запустите прокси-сервер разработки.
```
devproxy
```

Пример подключаемого модуля проверяет все соответствующие URL-адреса для требуемого заголовка авторизации. Если заголовок отсутствует, отображается предупреждение.

Добавление настраиваемой конфигурации в подключаемый модуль (необязательно)

Вы можете расширить логику вашего плагина, добавив пользовательскую конфигурацию.

Добавьте новый _configuration объект и привязать его к методу Register .

using Microsoft.DevProxy.Abstractions;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Logging;

namespace MyCustomPlugin;

public class CatchApiCallsConfiguration
{
  public string? RequiredHeader { get; set; }
}

public class CatchApiCalls(IPluginEvents pluginEvents, IProxyContext context, ILogger logger, ISet<UrlToWatch> UrlsToWatch, IConfigurationSection? configSection = null) : BaseProxyPlugin(pluginEvents, context, logger, UrlsToWatch, configSection)
{
  public override string Name => nameof(CatchApiCalls);

  // Define you custom configuration
  private readonly CatchApiCallsConfiguration _configuration = new();

  public override async Task RegisterAsync()
  {
    await base.RegisterAsync();

    // Bind your plugin configuration
    configSection?.Bind(_configuration);

    // Register your event handlers
    PluginEvents.BeforeRequest += BeforeRequestAsync;
  }

  private Task BeforeRequestAsync(object sender, ProxyRequestArgs e)
  {
    if (UrlsToWatch is null ||
      !e.HasRequestUrlMatch(UrlsToWatch))
    {
      // No match for the URL, so we don't need to do anything
      Logger.LogRequest("URL not matched", MessageType.Skipped, new LoggingContext(e.Session));
      return Task.CompletedTask;
    }

    // Start using your custom configuration
    var requiredHeader = _configuration?.RequiredHeader ?? string.Empty;
    if (string.IsNullOrEmpty(requiredHeader))
    {
      // Required header is not set, so we don't need to do anything
      Logger.LogRequest("Required header not set", MessageType.Skipped, new LoggingContext(e.Session));
      return Task.CompletedTask;
    }

    var headers = e.Session.HttpClient.Request.Headers;
    var header = headers.Where(h => h.Name == requiredHeader).FirstOrDefault();
    if (header is null)
    {
      Logger.LogRequest($"Does not contain the {requiredHeader} header", MessageType.Warning, new LoggingContext(e.Session));
      return Task.CompletedTask;
    }

    return Task.CompletedTask;
  }
}

Создайте проект.
```
dotnet build
```

Обновите devproxyrc.json файл, чтобы включить новую конфигурацию.

{
  "plugins": [{
    "name": "CatchApiCalls",
    "enabled": true,
    "pluginPath": "./bin/Debug/net8.0/MyCustomPlugin.dll",
    "configSection": "catchApiCalls"
  }],
  "catchApiCalls": {
    "requiredHeader": "Authorization" // Example configuration
  }
}

Запустите прокси-сервер разработки.
```
devproxy
```