| | | 1 | | using System; |
| | | 2 | | using System.Net; |
| | | 3 | | using System.Net.Sockets; |
| | | 4 | | using System.Threading; |
| | | 5 | | using System.Security.Cryptography; |
| | | 6 | | using System.Text; |
| | | 7 | | using Microsoft.AspNetCore.Mvc; |
| | | 8 | | using Microsoft.AspNetCore.Mvc.Filters; |
| | | 9 | | using Microsoft.Extensions.Configuration; |
| | | 10 | | using Microsoft.Extensions.Logging; |
| | | 11 | | using Services.OzonWebhookServices.Models; |
| | | 12 | | |
| | | 13 | | namespace OzonOrdersWeb.Middleware |
| | | 14 | | { |
| | | 15 | | /// <summary> |
| | | 16 | | /// Action-фильтр, ограничивающий доступ к endpoint'у приёма push-уведомлений Ozon |
| | | 17 | | /// только разрешёнными IP-адресами. |
| | | 18 | | /// |
| | | 19 | | /// Разрешённые диапазоны по документации Ozon: |
| | | 20 | | /// 195.34.21.0/24, 185.73.192.0/22, 91.223.93.0/24 |
| | | 21 | | /// |
| | | 22 | | /// Дополнительно разрешены loopback-адреса (127.0.0.1, ::1, 0.0.0.0) |
| | | 23 | | /// для локальной разработки и тестирования. |
| | | 24 | | /// |
| | | 25 | | /// Применяется через [ServiceFilter(typeof(OzonIpWhitelistFilter))] на контроллере, |
| | | 26 | | /// а не как глобальный middleware — чтобы не затрагивать остальные маршруты. |
| | | 27 | | /// Зарегистрирован как Scoped в DI. |
| | | 28 | | /// </summary> |
| | | 29 | | public sealed class OzonIpWhitelistFilter : IActionFilter |
| | | 30 | | { |
| | | 31 | | /// <summary> |
| | | 32 | | /// CIDR-диапазоны IP-адресов, с которых Ozon отправляет уведомления. |
| | | 33 | | /// Источник: https://docs.ozon.ru/api/seller/#tag/push-notifications |
| | | 34 | | /// </summary> |
| | 1 | 35 | | private static readonly string[] OzonCidrRanges = |
| | 1 | 36 | | { |
| | 1 | 37 | | "195.34.21.0/24", |
| | 1 | 38 | | "185.73.192.0/22", |
| | 1 | 39 | | "91.223.93.0/24", |
| | 1 | 40 | | "172.18.0.0/24" |
| | 1 | 41 | | }; |
| | | 42 | | |
| | | 43 | | /// <summary>Параметр запроса с общим секретом (<c>?token=…</c> в URL, зарегистрированном в Ozon).</summary> |
| | | 44 | | public const string TokenQueryParameter = "token"; |
| | | 45 | | |
| | | 46 | | /// <summary>Ключ конфигурации с общим секретом; пусто — проверка токена отключена.</summary> |
| | | 47 | | public const string SharedTokenConfigKey = "OzonWebhook:SharedToken"; |
| | | 48 | | |
| | | 49 | | private static int _missingTokenWarned; |
| | | 50 | | |
| | | 51 | | private readonly ILogger<OzonIpWhitelistFilter> _logger; |
| | | 52 | | private readonly string? _sharedToken; |
| | | 53 | | |
| | 8 | 54 | | public OzonIpWhitelistFilter(ILogger<OzonIpWhitelistFilter> logger, IConfiguration configuration) |
| | | 55 | | { |
| | 8 | 56 | | _logger = logger; |
| | 8 | 57 | | _sharedToken = configuration[SharedTokenConfigKey]; |
| | 8 | 58 | | } |
| | | 59 | | |
| | | 60 | | public void OnActionExecuting(ActionExecutingContext context) |
| | | 61 | | { |
| | | 62 | | // Реальный IP Ozon до приложения не доходит: stream-nginx на VPS (SNI-роутер без proxy_protocol) |
| | | 63 | | // подменяет его на 127.0.0.1, а loopback в белом списке. Поэтому список IP сам по себе не защищает — |
| | | 64 | | // дополнительно проверяем общий секрет в URL. |
| | 8 | 65 | | if (!IsTokenValid(context)) |
| | | 66 | | { |
| | 3 | 67 | | _logger.LogInformation("Ozon webhook: запрос отклонён — неверный или отсутствующий token"); |
| | 3 | 68 | | context.Result = new JsonResult(OzonErrorResponseFactory.Unknown("Доступ запрещён")) |
| | 3 | 69 | | { |
| | 3 | 70 | | StatusCode = StatusCodes.Status403Forbidden, |
| | 3 | 71 | | ContentType = "application/json" |
| | 3 | 72 | | }; |
| | 3 | 73 | | return; |
| | | 74 | | } |
| | | 75 | | |
| | 5 | 76 | | var remoteIp = context.HttpContext.Connection.RemoteIpAddress; |
| | | 77 | | |
| | | 78 | | // Нормализуем IPv4-mapped IPv6 (например ::ffff:127.0.0.1 → 127.0.0.1) |
| | 5 | 79 | | if (remoteIp is not null && remoteIp.IsIPv4MappedToIPv6) |
| | 0 | 80 | | remoteIp = remoteIp.MapToIPv4(); |
| | | 81 | | |
| | 5 | 82 | | if (remoteIp is null || !IsAllowed(remoteIp)) |
| | | 83 | | { |
| | 3 | 84 | | var ipString = remoteIp?.ToString() ?? "unknown"; |
| | 3 | 85 | | _logger.LogInformation( |
| | 3 | 86 | | "Ozon webhook: запрос отклонён — IP {Ip} не входит в список разрешённых диапазонов", |
| | 3 | 87 | | ipString); |
| | | 88 | | |
| | 3 | 89 | | context.Result = new JsonResult( |
| | 3 | 90 | | OzonErrorResponseFactory.Unknown($"Доступ запрещён: IP {ipString} не авторизован")) |
| | 3 | 91 | | { |
| | 3 | 92 | | StatusCode = StatusCodes.Status403Forbidden, |
| | 3 | 93 | | ContentType = "application/json" |
| | 3 | 94 | | }; |
| | | 95 | | } |
| | 5 | 96 | | } |
| | | 97 | | |
| | | 98 | | private bool IsTokenValid(ActionExecutingContext context) |
| | | 99 | | { |
| | 8 | 100 | | if (string.IsNullOrEmpty(_sharedToken)) |
| | | 101 | | { |
| | 2 | 102 | | if (Interlocked.Exchange(ref _missingTokenWarned, 1) == 0) |
| | 1 | 103 | | _logger.LogInformation( |
| | 1 | 104 | | "Ozon webhook: {Key} не задан — endpoint защищён только белым списком IP, который за nginx не ра |
| | 1 | 105 | | SharedTokenConfigKey); |
| | 2 | 106 | | return true; |
| | | 107 | | } |
| | | 108 | | |
| | 6 | 109 | | var provided = context.HttpContext.Request.Query[TokenQueryParameter].ToString(); |
| | 6 | 110 | | return CryptographicOperations.FixedTimeEquals( |
| | 6 | 111 | | Encoding.UTF8.GetBytes(provided), Encoding.UTF8.GetBytes(_sharedToken)); |
| | | 112 | | } |
| | | 113 | | |
| | | 114 | | public void OnActionExecuted(ActionExecutedContext context) |
| | | 115 | | { |
| | | 116 | | // Действий после выполнения не требуется |
| | 0 | 117 | | } |
| | | 118 | | |
| | | 119 | | // ───────────────────────────────────────────────────────────────────── |
| | | 120 | | // Приватные методы |
| | | 121 | | // ───────────────────────────────────────────────────────────────────── |
| | | 122 | | |
| | | 123 | | private bool IsAllowed(IPAddress ip) |
| | | 124 | | { |
| | | 125 | | // Loopback (127.0.0.1, ::1) и Any (0.0.0.0) — для локальной разработки |
| | 5 | 126 | | if (IPAddress.IsLoopback(ip) || |
| | 5 | 127 | | ip.Equals(IPAddress.Any) || |
| | 5 | 128 | | ip.Equals(IPAddress.IPv6Any)) |
| | 1 | 129 | | return true; |
| | | 130 | | |
| | 33 | 131 | | foreach (var cidr in OzonCidrRanges) |
| | | 132 | | { |
| | 13 | 133 | | if (IsInSubnet(ip, cidr)) |
| | 1 | 134 | | return true; |
| | | 135 | | } |
| | | 136 | | |
| | 3 | 137 | | return false; |
| | | 138 | | } |
| | | 139 | | |
| | | 140 | | /// <summary> |
| | | 141 | | /// Проверяет, попадает ли IP-адрес в подсеть, заданную в CIDR-нотации. |
| | | 142 | | /// Поддерживает только IPv4. IPv6-адреса Ozon не использует. |
| | | 143 | | /// </summary> |
| | | 144 | | private bool IsInSubnet(IPAddress ip, string cidr) |
| | | 145 | | { |
| | | 146 | | try |
| | | 147 | | { |
| | 13 | 148 | | if (ip.AddressFamily != AddressFamily.InterNetwork) |
| | 0 | 149 | | return false; |
| | | 150 | | |
| | 13 | 151 | | var parts = cidr.Split('/'); |
| | 13 | 152 | | if (parts.Length != 2) |
| | 0 | 153 | | return false; |
| | | 154 | | |
| | 13 | 155 | | if (!IPAddress.TryParse(parts[0], out var networkAddress)) |
| | 0 | 156 | | return false; |
| | | 157 | | |
| | 13 | 158 | | if (!int.TryParse(parts[1], out var prefixLength) || |
| | 13 | 159 | | prefixLength < 0 || prefixLength > 32) |
| | 0 | 160 | | return false; |
| | | 161 | | |
| | 13 | 162 | | var ipBytes = ip.GetAddressBytes(); |
| | 13 | 163 | | var networkBytes = networkAddress.GetAddressBytes(); |
| | | 164 | | |
| | | 165 | | // Маска в виде uint: для /24 → 0xFFFFFF00 |
| | 13 | 166 | | uint mask = prefixLength == 0 |
| | 13 | 167 | | ? 0u |
| | 13 | 168 | | : uint.MaxValue << (32 - prefixLength); |
| | | 169 | | |
| | 13 | 170 | | uint ipInt = ((uint)ipBytes[0] << 24) | ((uint)ipBytes[1] << 16) | |
| | 13 | 171 | | ((uint)ipBytes[2] << 8) | ipBytes[3]; |
| | 13 | 172 | | uint networkInt = ((uint)networkBytes[0] << 24) | ((uint)networkBytes[1] << 16) | |
| | 13 | 173 | | ((uint)networkBytes[2] << 8) | networkBytes[3]; |
| | | 174 | | |
| | 13 | 175 | | return (ipInt & mask) == (networkInt & mask); |
| | | 176 | | } |
| | 0 | 177 | | catch (Exception ex) |
| | | 178 | | { |
| | 0 | 179 | | _logger.LogError(ex, "Ошибка при проверке CIDR {Cidr} для IP {Ip}", cidr, ip); |
| | 0 | 180 | | return false; |
| | | 181 | | } |
| | 13 | 182 | | } |
| | | 183 | | } |
| | | 184 | | } |