Bezpečnost
Cache a sdílená zařízení
- HTML jen na povolení: bez
X-PWA-Cache: allow(middlewarepwa.cache) SW žádnou stránku neuloží. Výchozí stav je tedy bezpečný. - Oddělení uživatelů: stránky a API odpovědi jsou v
pwa-pages-{hash}apwa-rule-{name}-{hash}. Hash jeHMAC-SHA256(id uživatele, APP_KEY)zkrácený na 16 znaků (hlavičkaX-PWA-User). Když SW uvidí jiný hash, smaže cache předchozího uživatele i frontu offline akcí. - Odhlášení:
X-PWA-Logout+Clear-Site-Data: "cache"smaže cache a frontu. - Nikdy do cache: odpovědi jiné než 200,
no-store, 503, cesty zcache.never_cache(login, logout, register, broadcasting, livewire, sanctum,/pwa/*).
Doporučení: na citlivé stránky pwa.cache nedávejte; odpovědi s citlivými daty posílejte s Cache-Control: no-store.
Cookies
| Cookie | Kdo | Obsah | Šifrovaná |
|---|---|---|---|
pwa_display | klient | režim zobrazení (standalone, browser …) | ne (vyjmuta z EncryptCookies) |
| remember cookie | Laravel | standardní remember token | ano, HttpOnly |
pwa_display je jen nápověda; podvržená hodnota může nanejvýš zapnout remember-me při přihlášení (a jen když formulář pole remember výslovně nevypne). ?source=pwa remember-me nezapne.
CSP
| Zdroj | Jak projde |
|---|---|
/pwa/client.js | script-src 'self' + nonce z Vite::useCspNonce() |
#pwa-config | type="application/json", CSP nespouští |
<x-pwa::nav/> inline skript a styl | nonce |
| offline stránka | nonce (precachovaná odpověď nese i svou CSP hlavičku) |
| obrazovka údržby | předrenderovaná, bez nonce → hashe |
| lišta klienta | styly přes CSSOM (element.style), CSP je neblokuje |
Hashe obrazovky údržby:
use NyonCode\LaravelPwa\Facades\Pwa;
$hashes = Pwa::cspHashes();
// ['script-src' => ["'sha256-…'"], 'style-src' => ["'sha256-…'"]]Skript obrazovky údržby neobsahuje data z PHP, takže jeho hash je stabilní. Styl obsahuje barvy z theme: po jejich změně hashe přepočítejte. Příklad se spatie/laravel-csp:
foreach (Pwa::cspHashes() as $directive => $values) {
foreach ($values as $hash) {
$policy->add($directive === 'script-src' ? Directive::SCRIPT : Directive::STYLE, $hash);
}
}Další direktivy: worker-src 'self', manifest-src 'self', connect-src 'self' (keep-alive, ping, telemetrie).
Telemetrie
POST /pwa/telemetry:
- bez CSRF (posílá ji SW bez cookies), rate limit 30 požadavků za minutu,
- validace:
sourcesw|client, max.telemetry.max_eventsudálostí, zpráva do 500 znaků, stack do 2000, - pošle událost
TelemetryReceived(Události); výchozí listener zapíšewarnings prefixem[pwa]dotelemetry.channel(nebo výchozího logu), vypnete hotelemetry.log = false, - obsahuje User-Agent (300 znaků), žádné osobní údaje.
Vypnutí: telemetry.enabled = false.
Push notifikace
Volitelný modul push se řídí stejným pravidlem po uživatelích: odhlášení odebere odběry session, zařízení s jiným přihlášeným uživatelem ukáže jen neutrální notifikaci a server posílá jen na push služby z push.endpoints. Podrobnosti v Push notifikace.
Co balíček záměrně nedělá
- Nemaže
storagepři odhlášení (zrušilo by SW a push odběr). - Neukládá klasické POST formuláře do fronty (navigace).
- Nezasahuje do cizích domén.
- Nepoužívá localStorage pro nic, na čem závisí přihlášení nebo data.
Hlášení zranitelností
ondrej@nyoncode.cz, viz SECURITY.md.