Model zagrożeń & OWASP ASVS L1 Self-Attestation

Ten model obejmuje produkcyjny deployment vaulted.fyi włącznie z frontendem webowym, trasami API i przechowywaniem w Upstash Redis. Obejmuje również opublikowane CLI i serwer MCP w zakresie, w jakim wchodzą w interakcję z tym samym API.

Poza zakresem:

• Urządzenie końcowe użytkownika (przeglądarka, system operacyjny, rozszerzenia, schowek, ekran).
• Kanał komunikacji, przez który dostarczany jest link udostępnienia (e-mail, Slack, SMS itp.).
• Późniejsze postępowanie odbiorcy z plaintekstem.
• Podatności w Vercel lub Upstash poniżej powierzchni API, z której korzystamy.

Zasób podstawowy: sekret w postaci plaintekstu. Nie może nigdy dotrzeć do serwera, nie może utrwalić się poza przeglądarkami nadawcy i odbiorcy, ani nie może zostać odtworzony wyłącznie ze stanu po stronie serwera.

Zasoby wtórne: ciphertext, IV, liczniki wyświetleń, znaczniki czasu wygaśnięcia oraz integralność i dostępność serwisu.

Granice zaufania (w kolejności malejącego zaufania):

1. Przeglądarka nadawcy — zaufana z plaintekstem i kluczem.
2. Przeglądarka odbiorcy — zaufana z plaintekstem i kluczem po otwarciu linku.
3. Sieć między klientem a serwerem — niezaufana; łagodzone przez TLS 1.3 i decyzję projektową, że tylko ciphertext ją przekracza.
4. Serwer Vaulted (my) — częściowo zaufany. Traktowany jako pasywny magazyn ciphertekstu. Model zagrożeń zakłada, że sam Vaulted mógłby zostać skompromitowany bez ujawniania plaintekstu.
5. Upstash Redis — ten sam poziom zaufania co serwer. Wyłącznie zaszyfrowane bloby.

Pasywny obserwator sieci. ISP, aktor on-path z dostępem do metadanych TLS. Pokonywany przez TLS i brak plaintekstu lub klucza w transmisji.

Aktywny atakujący sieciowy. Może próbować ataku MitM. Pokonywany przez TLS, HSTS preload i walidację certyfikatów. Udane skompromitowanie TLS nadal daje wyłącznie ciphertext.

Skompromitowany serwer / wrogi operator. Obejmuje nas. Nie może odczytać przechowywanych sekretów, bo klucz nigdy nie dociera. Może odmówić usługi lub zmodyfikować serwowany bundle JS — opisane w ryzyku rezydualnym poniżej.

Nieuwierzytelniony atakujący z prawidłowym linkiem udostępnienia. Z założenia każdy posiadający pełny link może odszyfrować. Limity wyświetleń, wygaśnięcie i opcjonalna passphrase skracają okno czasowe. To celowa właściwość, nie błąd.

Ukierunkowany atakujący na konkretnego nadawcę lub odbiorcę. Może wykorzystać urządzenie końcowe, kanał dostarczenia lub postępowanie odbiorcy po odszyfrowaniu. Poza kontrolą Vaulted; udokumentowane dla przejrzystości.

• Klientskie AES-256-GCM z losowymi 96-bitowymi IV z crypto.getRandomValues.
• 256-bitowe klucze generowane per sekret przez crypto.subtle.generateKey; umieszczane we fragmencie URL, nigdy nie przesyłane.
• Opcjonalne owijanie passphrase z PBKDF2 (wysoka liczba iteracji) i key wrapping AES-GCM.
• Atomowe egzekwowanie licznika wyświetleń przez Redis HINCRBY z usunięciem w tej samej transakcji przy osiągnięciu limitu.
• Automatyczne wygasanie oparte na TTL, ograniczone do 30 dni; brak przedłużenia po utworzeniu.
• Rate limiting per IP ze sliding window na endpointach tworzenia i wyświetlania.
• noindex na stronach wyświetlania /s/[id], żeby URL-e sekretów nie wyciekały przez wyszukiwarki.
• TLS 1.3 z HSTS preload, bezpieczne nagłówki bezpieczeństwa, brak logowania IP poza oknami rate limitów.

To są celowe decyzje o granicach, udokumentowane po to, by użytkownicy mogli zdecydować, czy Vaulted pasuje do ich modelu zagrożeń.

• Skompromitowanie urządzenia końcowego. Keylogger, zainfekowana przeglądarka lub wrogie rozszerzenie może odczytać plaintext po odszyfrowaniu.
• Wyciek kanału dostarczenia. Jeśli link udostępnienia zostanie przekazany dalej, zarchiwizowany lub zacytowany w wątku e-mail odpowiedzi, ten kanał staje się powierzchnią ataku.
• Celowa podmiana bundla. Skompromitowane CDN lub Vercel edge może serwować inny JS konkretnemu użytkownikowi. Subresource Integrity i odtwarzalne buildy są częściowym środkiem zaradczym i są na roadmapie.
• Zachowanie odbiorcy. Po odszyfrowaniu odbiorca może skopiować, zrobić zrzut ekranu lub przekazać treść dalej.
• Słaba passphrase. Jeśli użyta, słabą passphrase można złamać brute-force przez każdego posiadającego owinięty klucz.
• Wymuszenie / przymus fizyczny. Poza zakresem jakiejkolwiek kontroli technicznej.

Poniższa macierz odnosi implementację Vaulted do wybranych wymagań OWASP ASVS Level 1. Kategorie, które nie mają zastosowania (sesje, uwierzytelnianie, przesyłanie plików), są oznaczone N/A z krótkim uzasadnieniem zamiast pominięcia — by brak wpisu nie był odczytywany jako unikanie.

Numeracja zgodna ze strukturą ASVS 4.0. Lista jest wybrana, nie wyczerpująca — celem jest szczerość co do mechanizmów kontroli, które mają realne zastosowanie do bezstanowego, bezkontoweego zaszyfrowanego magazynu ciphertekstu.

Każda zmiana wpływająca na element w tym dokumencie — nowy endpoint, zmiana kryptograficzna, refaktoring wpływający na zależności, zmiana infrastruktury — musi wywołać przegląd tej strony w tym samym PR. Wersja i data publikacji powyżej zostaną zaktualizowane przy aktualizacji dokumentu; poprzednia wersja pozostaje dostępna w publicznej historii git.