Przesyłanie plików w aplikacji: bezpieczne załączniki
Bezpieczne przesyłanie plików w aplikacji webowej nie kończy się na przycisku „Dodaj załącznik”. Plik powinien najpierw przejść kontrolę po stronie serwera w odizolowanej przestrzeni, a dopiero potem być dostępny dla uprawnionego użytkownika. W portalu firmowym rozsądnym punktem wyjścia są prywatna przestrzeń do przechowywania, wąska lista dozwolonych formatów, jasne limity i status „oczekuje na sprawdzenie”. Samo rozszerzenie ani udany transfer nie oznaczają, że załącznik jest bezpieczny.
Właściciel firmy nie musi wybierać silnika antywirusowego. Powinien jednak wiedzieć, czego wymagać od wykonawcy i na jakiej podstawie odebrać gotową funkcję. Ten poradnik dotyczy przyjmowania zdjęć serwisowych i dokumentów w portalu, a nie publicznego hostingu plików ani automatycznej analizy ich treści z użyciem AI.
Najpierw ustal, jakich załączników firma naprawdę potrzebuje
Przy projektowaniu aplikacji webowej na zamówienie zacznij od procesu: kto dodaje plik, do którego rekordu on należy, kto może go otworzyć i kiedy należy go usunąć. Jeśli serwis potrzebuje zdjęcia usterki i protokołu PDF, nie ma powodu domyślnie dopuszczać archiwów, plików wykonywalnych czy dowolnych dokumentów biurowych.
OWASP zaleca dopuszczanie wyłącznie rozszerzeń potrzebnych do realizacji funkcji biznesowej, ograniczanie wielkości plików, nadawanie nazw generowanych przez aplikację i sprawdzanie uprawnień do przesyłania. Te środki uzupełniają się; żaden nie wystarcza samodzielnie.
| Decyzja | Zalecane wymaganie | Kompromis |
|---|---|---|
| Formaty | Dopuść tylko konkretne potrzebne typy | Mniejsza wygoda przy nietypowych dokumentach |
| Limity | Określ wielkość pliku, liczbę załączników i przestrzeń na klienta | Duże materiały wymagają osobnej procedury |
| Dostępność | Udostępniaj dopiero po pomyślnych kontrolach | Użytkownik może chwilę poczekać |
| Przechowywanie | Wyznacz osobę odpowiedzialną i regułę usuwania | Reguła musi obejmować też kopie tymczasowe |
Przykład: portal serwisowy ze zdjęciami i protokołem
Przykład ilustracyjny, a nie wynik konkretnego klienta: firma przyjmuje reklamacje urządzeń. Klient może dodać do jednego zgłoszenia najwyżej pięć załączników w formacie JPEG, PNG lub PDF, każdy o wielkości do 10 MB. To proponowane reguły produktu, nie uniwersalny standard bezpieczeństwa.
Po transferze portal wyświetla „Załącznik został przyjęty i oczekuje na sprawdzenie”. Technik nie może go jeszcze pobrać i nie otrzymuje go jako załącznika do e-maila. Po pomyślnej kontroli status zmienia się na „Dostępny”. Odrzucenie wyjaśnia konkretny problem, na przykład nieobsługiwany format, i pozwala ponowić próbę.
Jeśli usługa sprawdzająca nie odpowiada, plik pozostaje niedostępny. Portal nie może uznać awarii kontroli za jej pomyślne zakończenie. Operator potrzebuje alertu i uzgodnionej procedury wyjaśniania zablokowanych załączników bez zbiorczego obchodzenia zabezpieczeń.
Co musi sprawdzić serwer, a nie tylko przeglądarka
Wybór plików w formularzu pomaga użytkownikowi, ale nie stanowi granicy bezpieczeństwa. Dokumentacja MDN dotycząca atrybutu accept wyraźnie wskazuje, że atrybut nie weryfikuje typu pliku, a wymagania trzeba egzekwować po stronie serwera. Testuj więc także przesyłanie z pominięciem zwykłego formularza.
Serwer powinien sprawdzić uprawnienie użytkownika do dodania załącznika do konkretnego zgłoszenia, dozwolone rozszerzenie, wielkość oraz rzeczywisty typ za pomocą odpowiednich kontroli zawartości. Nagłówkowi Content-Type przesłanemu przez klienta nie można ślepo ufać: OWASP ostrzega, że da się go podrobić. Zgodność typu i rozszerzenia także nie dowodzi, że cały dokument jest nieszkodliwy.
Oryginalną nazwę przechowuj jako dane do wyświetlenia, nie jako ścieżkę w magazynie plików. Aplikacja powinna utworzyć własny identyfikator i bezpiecznie wyświetlać pierwotną nazwę. Oddziela to nazwę nadaną przez użytkownika od lokalizacji technicznej. Plik o tej samej nazwie nie może przypadkowo zastąpić załącznika z innego zgłoszenia.
Kwarantanna: przyjęty plik nie jest jeszcze zatwierdzonym załącznikiem
W specyfikacji rozdziel stany „przesyłanie”, „oczekuje na sprawdzenie”, „dostępny”, „odrzucony” i „błąd sprawdzania”. Kwarantanna oznacza tu prywatną przestrzeń, z której zwykły użytkownik ani powiązane procesy nie mogą odczytać pliku. To nie tylko kolorowa etykieta w panelu administracyjnym.
OWASP zaleca użycie antywirusa lub izolowanego środowiska analizy, czyli sandboxa, jeśli są dostępne, a dla odpowiednich formatów także dodatkowe przetwarzanie usuwające ryzykowne elementy. Wykonawca powinien dobrać konkretny zestaw do formatów i ryzyka. Brak wykrytych zagrożeń przez antywirusa nie gwarantuje bezpieczeństwa. Kontrola typu, uprawnień, izolacja i bezpieczne przetwarzanie nadal są potrzebne.
Ta sama zasada dotyczy podglądów: nie twórz ich przez nieograniczone przetwarzanie niesprawdzonej treści. Określ limity, izolację przetwarzania oraz zachowanie po błędzie. Dopóki załącznik nie zostanie zatwierdzony, nie może trafić do kolejnego procesu automatycznego ani zostać rozesłany w powiadomieniu.
Prywatne pobieranie i pułapki podpisanych linków
OWASP zaleca oddzielny serwer lub przechowywanie poza publicznym katalogiem głównym witryny. Dla prywatnych firmowych załączników wymagaj magazynu bez anonimowego dostępu. Przy każdym żądaniu pobrania aplikacja powinna sprawdzić aktualne uprawnienie do danego załącznika; znajomość identyfikatora nie wystarcza.
Jednym z rozwiązań jest krótkotrwały podpisany link wydany po tej kontroli. Dokumentacja Amazon S3 potwierdza dostęp ograniczony czasowo, ale również możliwość wielokrotnego używania podpisanego URL do momentu wygaśnięcia. Nie nazywaj go więc automatycznie jednorazowym. Każdy, kto go uzyska, może go wykorzystać w granicach jego uprawnień i okresu ważności.
Nie umieszczaj podpisanych URL w analityce, na stronach publicznych ani w zwykłych notatkach wsparcia. Jeżeli odebranie dostępu musi obowiązywać przy każdym kolejnym pobraniu, kieruj pobieranie przez aplikację z ponowną kontrolą, zamiast polegać wyłącznie na ważności wcześniej wydanego linku. Przy podpisanym przesyłaniu do S3 użycie istniejącego klucza obiektu dodatkowo zastępuje ten obiekt; projektuj zatem unikalne klucze i kontrolowane zakończenie transferu.
Jak wdrożyć funkcję bez nadmiernego rozbudowywania projektu
- Spisz reguły. Przygotuj macierz użytkowników, typów załączników, limitów i przechowywania. Uwzględnij technika oraz administratora.
- Wybierz drogę transferu. Przesyłanie przez aplikację centralizuje kontrole; bezpośredni transfer do magazynu wymaga osobnego rozwiązania uprawnień, limitów i weryfikacji przyjętego obiektu.
- Wprowadź kwarantannę i przejścia między stanami. Udostępniaj po wszystkich obowiązkowych kontrolach, nie po odpowiedzi „transfer zakończony”.
- Podłącz kolejne procesy. W oprogramowaniu na zamówienie powiadomienia i przetwarzanie powinny reagować na dostępny załącznik, nie tylko na utworzony rekord.
- Przetestuj awarie i porządkowanie. Ustal postępowanie przy awarii kontroli, przerwanym transferze i braku miejsca. Sprawdź usuwanie pliku oraz jego tymczasowych kopii pochodnych.
Zacznij od potrzebnych formatów i jednego procesu. Obsługa archiwów, multimediów lub publicznych linków to dodatkowe wymaganie z własnymi ryzykami, a nie darmowe rozszerzenie tego samego przycisku. Większy zakres może oznaczać więcej pracy przy kontrolach i eksploatacji; bez znajomości wolumenu oraz wymagań nie można obiecać konkretnej ceny ani oszczędności.
Lista kontrolna odbioru przed uruchomieniem
- Niedozwolony typ jest odrzucany także po zmianie rozszerzenia i przy bezpośrednim wywołaniu serwera.
- Zbyt duży plik i przekroczenie liczby załączników dają zrozumiały komunikat.
- Klient A nie uzyska załącznika klienta B przez zmianę identyfikatora ani przez podgląd.
- Anonimowy odwiedzający nie otworzy obiektu pod bezpośrednim adresem magazynu.
- Pliku oczekującego lub odrzuconego nie można pobrać ani przekazać kolejnemu procesowi.
- Awaria kontroli nie ustawia statusu „dostępny” i jest widoczna dla obsługi.
- Ponowny transfer nie nadpisuje zatwierdzonego pliku; podpisany link nie działa po wygaśnięciu.
- Usuwanie obejmuje wymagane kopie zgodnie z ustaloną regułą i jest sprawdzone testem.
Częstym błędem jest przetestowanie wyłącznie prawidłowego PDF. Drugim jest traktowanie trudnej do odgadnięcia nazwy jako zamiennika uprawnień. Trzecim jest umożliwienie pobierania podczas oczekiwania na antywirusa, aby użytkownik „nie musiał czekać”. Takie skróty niweczą istotną część zaprojektowanej ochrony.
Najczęściej zadawane pytania
Czy wystarczy dopuścić tylko PDF?
Nie. Wąska lista ogranicza zakres obsługiwanych formatów, ale nie zastępuje kontroli serwerowych, bezpiecznego przetwarzania ani uprawnień do pobierania. Dozwolony format nadal jest niezaufanym wejściem.
Czy każdy załącznik musi przejść kontrolę antywirusową?
Zakres kontroli należy zaprojektować według ryzyka i formatów. W portalu przyjmującym zewnętrzne dokumenty firmowe rozsądnie jest wymagać warstwy kontroli oraz jasnych zasad na wypadek awarii. Jeśli specyfikacja uznaje kontrolę za obowiązkową, jej niedostępność nie może automatycznie zatwierdzać pliku.
Czy podpisany link jest jednorazowy?
Nie automatycznie. W przywołanej dokumentacji S3 można go używać wielokrotnie do wygaśnięcia. Faktycznie jednorazowy dostęp wymaga osobnej kontroli w aplikacji; sam limit czasu jej nie zapewnia.
Czy zabezpieczenia można dodać dopiero po uruchomieniu?
Poprawki są możliwe, ale prywatny magazyn, model stanów i kontrolę dostępu warto zaprojektować przed pierwszymi prawdziwymi załącznikami. Później może być konieczne przeniesienie starych plików i sprawdzenie, czy nie są nadal dostępne pod pierwotnymi adresami.
Przygotuj wymagania według swojego procesu
Jeśli planujesz portal klienta lub portal wewnętrzny, przygotuj listę załączników, grup użytkowników i sytuacji, w których plik nie może zostać udostępniony. Przez kontakt z Webiant możesz przesłać ten opis i uzgodnić zakres projektu aplikacji. Na początku nie wysyłaj prawdziwych dokumentów zawierających wrażliwe dane; do wyjaśnienia procesu wystarczą zanonimizowane przykłady.