Przegląd bezpieczeństwa — wrzesień 2026¶
Ta strona dokumentuje przegląd bezpieczeństwa bibliotek współdzielonych wykonany 2 września 2026, poprawki, które z nim trafiły do repozytorium, oraz punkty wymagające decyzji człowieka.
Biblioteki występują pod nazwami z dnia przeglądu: MediatR i MediatR.ML to od wersji 3.0 Mediator i Mediator.ML.
Zakres i metoda¶
- Wszystkie biblioteki w
src/(25 projektów, ok. 12 000 linii C#), projekty testowe, workflow GitHub Actions i skrypty PowerShell. - Statyczny przegląd źródeł w pięciu przebiegach (rdzeń płatności i providerzy, EF/Querying, MediatR/Email/ML, WebApi/ExceptionHandling, CI); każde znalezisko zweryfikowane w kodzie przed napisaniem poprawki.
dotnet list package --vulnerable --include-transitive: brak podatnych pakietów NuGet (bezpośrednich i przechodnich).System.Linq.Dynamic.Corejest przypięty powyżej poprawki CVE-2024-51417.- Każda poprawka ma testy jednostkowe; cała solucja (build + ponad 900 testów) była zielona przed commitem.
Znaleziska i status¶
| # | Waga | Obszar | Znalezisko | Status |
|---|---|---|---|---|
| 1 | Krytyczne | Payments (testy) | Produkcyjny sekret sklepu CashBill wraz z pasującymi podpisami był zakomitowany w pliku testowym (nieużywane dane). | Usunięty ze źródeł. Rotacja i wyczyszczenie historii wymagają właściciela — zobacz Zadania dla właściciela. |
| 2 | Wysokie | ExceptionHandling | Domyślny provider zwracał komunikat najgłębszego wyjątku (błędy SQL, hosty, ścieżki) anonimowym klientom jako HTTP 400 w każdym środowisku. | Naprawione: 500 + ogólny komunikat; szczegóły tylko w Development lub po jawnym włączeniu. |
| 3 | Wysokie | Payments (wszyscy providerzy) | Weryfikacja podpisu przy braku sekretu degradowała się do hasha bez klucza — każdy mógł sfałszować „poprawne” powiadomienie. | Naprawione: fail-closed w 9 providerach (w tym Stripe). |
| 4 | Wysokie | Payments (CashBill) | Komunikat błędu webhooka zwracał oczekiwany podpis (wyrocznia do fałszowania); starsza ścieżka TransactionStatusChange nie weryfikowała podpisu. |
Naprawione. |
| 5 | Wysokie | Payments (Revolut) | Podpisywany ładunek używał v1: zamiast v1.; brak kontroli znacznika czasu — przechwycony webhook można było odtwarzać bez końca. |
Naprawione: właściwy format, tolerancja 300 s (konfigurowalna), podpisy rotacyjne. |
| 6 | Wysokie | EntityFramework | SortField z żądania trafiał wprost do Dynamic LINQ (nawigacje, wiele kolumn, ujawnianie schematu); brak górnego limitu rozmiaru strony. |
Naprawione: walidacja identyfikatora, przeciążenie z allow-listą, limity stron i kontrola przepełnienia. |
| 7 | Wysokie | MediatR | Domyślny klucz cache używał ToString() właściwości — żądania różniące się tylko zawartością kolekcji dzieliły wpis (dane innych użytkowników). Scope logowania serializował całe żądania (sekrety, obrazy). |
Naprawione: klucze z hasha treści; scope zawiera tylko nazwę typu i correlation id. |
| 8 | Wysokie | Zmienne szablonu wstawiane dosłownie do HTML (linki phishingowe od zaufanego nadawcy); lista adresów po przecinku dodawała odbiorców; TLS SMTP domyślnie wyłączony. | Naprawione: kodowanie HTML domyślnie ({{{raw}}} jako wyjątek), jeden adresat, TLS włączony. |
|
| 9 | Wysokie | MediatR.ML | Komenda treningu czytała dowolny katalog i pisała pod dowolną ścieżkę z żądania; klasyfikacja przyjmowała dowolne, niezwalidowane bajty. | Naprawione: ścieżki ograniczone do TrainingRoot/ModelsRoot; walidacja rozmiaru i sygnatury. |
| 10 | Średnie | WebApi | Standardowy handler odporności ponawiał POST/PATCH dla każdego HttpClienta — duplikaty płatności/zamówień po timeoutach. | Naprawione: ponawianie metod nieidempotentnych domyślnie wyłączone. |
| 11 | Średnie | Payments | Porównanie podpisów w czasie zależnym od danych; nagłówki wrażliwe na wielkość liter (nie działa pod HTTP/2); nieescapowane identyfikatory w URL bramek; wyniki webhooków bez identyfikatora płatności. | Naprawione: WebhookSignature, słowniki case-insensitive, PaymentIdentifier, wypełnione identyfikatory. |
| 12 | Średnie | Payments (Przelewy24) | Podpisy notyfikacji/verify liczone z niewłaściwych zestawów pól (każde prawdziwe powiadomienie odrzucane). | Naprawione zgodnie z udokumentowaną kolejnością pól. |
| 13 | Średnie | EF UnitOfWork | Filtr transakcji commitował, gdy akcja zwróciła 4xx/5xx; obsługa błędu commitu mogła zostawić otwartą transakcję i ukryć pierwotną przyczynę. | Naprawione. |
| 14 | Średnie | Email.Office365 | Załączniki zwracane w kodowaniu transferowym i kluczowane typem MIME (awaria przy dwóch załącznikach tego samego typu). | Naprawione. |
| 15 | Średnie | CI/CD | Tokeny z prawem zapisu i zachowanymi poświadczeniami, akcje przypięte do ruchomych tagów, nazwa tagu interpolowana do skryptu, publikacja NuGet bez testów i z ukrywaniem błędów, niezaprzypięte instalacje pip. | Naprawione: minimalne uprawnienia, przypięcie do SHA + Dependabot, przekazywanie przez env, testy przed publikacją, --skip-duplicate, przypięty mkdocs-material. |
| 16 | Średnie | Payments (Tpay, Adyen) | Weryfikacja webhooka nie odpowiada protokołowi dostawcy (Tpay: formularz + md5sum + JWS; Adyen: HMAC z pól rozdzielonych dwukropkami w additionalData). Fail-closed, więc niewykorzystywalne, ale niefunkcjonalne. |
Naprawione w 2.0: Tpay weryfikuje md5sum i X-JWS-Signature (łańcuch do roota Tpay), Adyen — HMAC z additionalData.hmacSignature. |
Co się zmieniło, per biblioteka¶
Payments¶
- Nowe
TailoredApps.Shared.Payments.Security.WebhookSignature(FixedTimeEquals,FixedTimeEqualsIgnoreCase,IsSecretConfigured) iPaymentIdentifier(IsSafe,EnsureSafe). PaymentWebhookRequest.Headers/Querysą case-insensitive niezależnie od przypisanego słownika;TransactionStatusChangePayload.QueryParametersnigdy nie jestnull.- Wszyscy providerzy: fail-closed przy pustym sekrecie/podpisie, porównanie w stałym czasie,
PaymentUniqueIdz payloadu, zdarzeniaProcessingjakoIgnore, walidacja identyfikatorów przed wstawieniem do URL, zwalnianieJsonDocument. - CashBill: starsza ścieżka weryfikuje podpis MD5; komunikaty nie zawierają oczekiwanej wartości; brak sekretu → „Signature verification is not configured.”.
- Revolut:
v1.{timestamp}.{body},WebhookToleranceSeconds(domyślnie 300), podpisy rotacyjne. - Przelewy24: udokumentowane zestawy pól podpisu z JSON bez escapowania unicode; waluta normalizowana raz.
- PayU: obsługa SHA-1, nieznane algorytmy odrzucane. PayNow: stały
Idempotency-Key, statusEXPIRED. - Stripe: brak
WebhookSecret/nagłówka →Fail; zdarzenia płatności asynchronicznych z identyfikatorami. - Adyen: brak pola
successtraktowany jako niepowodzenie;merchantReference/pspReferencew wyniku. - HotPay: podpisywana nazwa usługi jest tą wysyłaną.
ExceptionHandling¶
DefaultExceptionHandlingProvider: walidacja → 400; reszta → 500 z komunikatem"An unexpected error occurred."; konstruktory(),(IHostEnvironment),(bool).- Middleware używa
GetRequiredService, nie pisze po rozpoczęciu odpowiedzi, ogranicza kod do 400–599.ExceptionOccuredResulthonoruje kod z modelu. Usunięta zdublowana rejestracja DI. Dokumentacja i prompt agenta przepisane pod rzeczywiste API.
WebApi¶
HttpClientSettings.RetryUnsafeHttpMethods(domyślniefalse) →Retry.DisableForUnsafeHttpMethods().
MediatR¶
ICachePolicy.GetCacheKey→{Typ.FullName}:{SHA-256(JSON)}przezCacheKeyGenerator.LoggingBehaviornie serializuje żądania; stack trace nie jest doklejany do szablonu komunikatu.CachingBehaviorużywa strukturalnych szablonów logów.
Email¶
TokenReplacingMailMessageBuilder: podmiana regexem w jednym przebiegu,{{token}}kodowane HTML,{{{token}}}surowe, opcjaHtmlEncodeVariables, argumenty odporne nanull.DefaultMessageBuilder: jeden przebieg, najdłuższy klucz pierwszy, kodowanie domyślne (konstruktor(bool)).SmtpEmailProvider: dokładnie jeden adresat (FormatExceptiondla list),CatchAllwymagany przyIsProd = false,EnableSsldomyślnietrue, poprawny Message-ID.Office365EmailProvider: załączniki dekodowane i kluczowane nazwą pliku.
MediatR.ML¶
ImageClassificationOptions.TrainingRoot,ModelsRoot,MaxImageBytes(domyślnie 10 MB).TrainImageClassificationModelCommandHandlerogranicza obie ścieżki (ArgumentExceptionpoza korzeniami,InvalidOperationExceptiongdy korzenie nie są skonfigurowane).ClassifyImageCommandHandlersprawdza obecność, rozmiar i sygnaturę JPEG/PNG. Wykrywanie JPEG akceptuje każdy nagłówekFF D8 FF.
EntityFramework / Querying¶
QuerySortingExtensions: pole sortowania musi być prostym identyfikatorem; przeciążeniaApplySorting(..., allowedSortFields); błędy parsowania Dynamic LINQ przepakowane wArgumentExceptionbez szczegółów typu.PagingQuery<T>:MaxPageSize(domyślnie 1000, statycznie i per instancja),Page >= 1,1 <= Count <= max, bezpieczne obliczenie skip.TransactionFilterAttribute: rollback przy wynikach 4xx/5xx;AggregateExceptiongdy commit i rollback zawiodą.UnitOfWork: commit/rollback zwalniają transakcję wfinally.
CI/CD¶
- Wszystkie workflow: domyślnie
permissions: contents: read,persist-credentials: false, akcje przypięte do SHA commitów (z komentarzem wersji),.github/dependabot.ymldlagithub-actions. ci.yml: build/test oddzielony od joba publikującegogh-pages(tylko ten macontents: write).release.yml:dotnet testprzed publikacją, każda paczka wypychana zartifacts/package/releasez--skip-duplicate, job kończy się błędem, gdy którykolwiek push się nie powiedzie,environment: nuget(dodaj wymaganych recenzentów w ustawieniach repozytorium). Publikacja korzysta z Trusted Publishing w nuget.org: job wymienia token OIDC z GitHuba na klucz API ważny godzinę, więc w repozytorium nie jest przechowywany żaden długotrwały klucz NuGet.release-notes.yml: nazwa tagu przezenv, bez interpolacji do skryptu.bump-deps.yml: pełny przebieg testów przed utworzeniem PR.
Zadania dla właściciela repozytorium¶
- Zrotuj sekret CashBill sklepu wskazanego w usuniętych danych testowych — w panelu sprzedawcy
CashBill. Wartość jest w historii gita od commitu
ed838d6; rotacja to jedyne pewne rozwiązanie. Jeśli repozytorium jest lub było publiczne, wyczyść też historię (git filter-repo) i wykonaj force-push — to operacja destrukcyjna, celowo tutaj niewykonana. - Sekret sandboxowy CashBill w
tests/TailoredApps.Shared.Payments.Tests/appsettings.jsonto poświadczenie środowiska testowego; przenieś go do user-secrets/sekretów CI, jeśli sklep testowy ma znaczenie. - W ustawieniach repozytorium dodaj wymaganych recenzentów do nowego środowiska
nuget, aby push tagu nie publikował pakietów bez akceptacji, i ustaw checki Docs guard oraz Build & Test PR jako wymagane namaster. Utwórz politykę Trusted Publishing w nuget.org i sekretNUGET_USERopisane w sekcji Wydawanie wersji na stronie Contributing, a następnie usuń stary sekretNUGET_API_KEYi unieważnij ten klucz w nuget.org. - Skonfiguruj
ImageClassification:TrainingRoot/ModelsRootw hostach używających komendy treningu i przekazujallowedSortFieldsdoApplySortingw endpointach listujących wrażliwe encje. - Przejrzyj konsumentów zależnych od starych zachowań: 400 z komunikatem wyjątku (teraz 500 ogólne),
surowy HTML w zmiennych maili (teraz kodowany; użyj
{{{token}}}), SMTP bez TLS (EnableSslteraztrue), listy odbiorców wSendMail, ponawianie POST przez domyślną odporność WebApi.
Do wykonania (poza tą zmianą)¶
- Tpay i Adyen: weryfikacja powiadomień odpowiada już protokołom dostawców, ale nie była sprawdzona prawdziwym powiadomieniem z sandboxa — wykonaj płatność testową przed wdrożeniem. Adyen: sesja Hosted Checkout i odczyt jej wyniku są zgodne ze specyfikacją API, ale też bez testu w środowisku Adyen.
- Awaria bramki nie jest już raportowana jako
PaymentStatusEnum.Rejected: providerzy HTTP rzucająPaymentGatewayException(2.0), a od 3.0 także Stripe (wcześniejStripeException). CachingBehaviornie zwraca jużdefaultprzy braku wpisu dla odpowiedzi typu wartościowego (poprawione w 1.5.1: wartość domyślna jest traktowana jak brak wpisu i handler się wykonuje). W 2.0 problem znika:CachingBehaviorkorzysta zHybridCache, który odróżnia brak wpisu od zapisanej wartości domyślnej i chroni przed równoległym wykonaniem handlera dla tego samego klucza.- Konwersja kwot na jednostki mniejsze obcina i zakłada dwa miejsca dziesiętne; dodaj wspólny helper ISO-4217.
- Tworzenie zamówienia PayU współdzieli jeden handler z pulą połączeń, który nie podąża za przekierowaniami (poprawione w 1.5.1; wcześniej handler powstawał per zamówienie). Nadal omija nazwanego klienta. Tokeny OAuth (PayU, Tpay) są pobierane przy każdym wywołaniu.
- EF:
SET TRANSACTION ISOLATION LEVELna poziomie sesji działa tylko na SQL Server i jest zbędne; wielokrotneAddUnitOfWorkkrzyżuje konteksty; kolektor audytu pomija encje proxy;HasDefaultValue(DateTime.UtcNow)utrwala stałą w migracjach. - Higiena pakietów:
Nullablewyłączone w większości projektów, brakPackageReadmeFilew większości pakietów, wersjex.*bez pliku lock,SourceRevisionIdzUtcNow, martwe warunki TFM. PagedAndSortedRequestduplikujePagedAndSortedQuery; dodaj atrybuty[Range].