Passkeys a WebAuthn v roce 2026: Praktický návod k implementaci pro webové vývojáře
Passkeys slibují přihlášení bez hesla bez uklízení tajných hodnot hesel, ale správná implementace WebAuthn vyžaduje více než volání API prohlížeče. Naučte se, jak registrace, autentizace, ověřování na serveru, zjištění credentials a obnovení účtu spolupracují ve bezpečné webové aplikaci.
Passkeys a WebAuthn v roce 2026: Praktický průvodce implementací pro webové vývojáře
Hesla jsou výchozím mechanismem autentizace pro webové aplikace už desítky let. Jsou také trvalým zdrojem bezpečnostních problémů.
Uživatelé je používají opakovaně. Útočníci je odcizují prostřednictvím phishingu. Servery musí chránit hashe hesel, spravovat resetování a bránit se útokům typu credential stuffing.
Passkeys nabízejí zcela jiný přístup.
Místo aby po uživatelích žádaly, aby si pamatovali sdílený tajemství, passkeys používají asymetrickou kryptografii a autentikátor ovládaný uživatelem. Prohlížeč poskytuje standardní rozhraní přes WebAuthn, zatímco server ověřuje kryptografická důkazy, že byl použit správný přihlašovací údaj.
Technologie už není experimentální. WebAuthn je široce dostupný v moderních prohlížečích a jeho metody pro práci s JSON výrazně zjednodušily integraci.
Ale i přes to vyžaduje budování bezpečného přihlašování přes passkeys pečlivý návrh backendu.
Tento průvodce vysvětluje architekturu, demonstruje toky v prohlížeči a identifikuje kontrolu na straně serveru, které vývojáři nesmí přehlédnout.
1. Co přesně je passkey?
Passkey je zjistitelný FIDO přihlašovací údaj používaný k autentizaci uživatele prostřednictvím asymetrické kryptografie.
Během registrace autentikátor vytvoří kryptografický pár klíčů.
Privátní klíč zůstává chráněn autentikátorem nebo jeho ekosystémem pro správu přihlašovacích údajů. Webová stránka obdrží odpovídající veřejný klíč a spojí ho s uživatelským účtem.
Během autentizace server vydá novou výzvu (challenge). Autentikátor podepíše data spojená s touto výzvou a server ověří podpis pomocí uloženého veřejného klíče.
Žádné znovupoužitelné heslo není posláno na webovou stránku.
Autentikátorem může být smartphone, počítač používající Windows Hello, hardwarový bezpečnostní klíč nebo správce přihlašovacích údajů podporující synchronizované passkeys.
Ne každý passkey je synchronizován napříč zařízeními. Některé přihlašovací údaje zůstávají vázané na zařízení, zatímco jiné mohou být bezpečně zazálohovány a zpřístupněny prostřednictvím poskytovateľa přihlašovacích údajů.
FIDO specifikace jsou navržené tak, aby odolávaly phishingu vazbou přihlašovacích údajů na doménu relying party. Biometrická data, když jsou použita, jsou zpracovávána lokálně zařízením a nejsou odesílána na webovou stránku.
2. WebAuthn je prohlížečové API za passkeys
WebAuthn je webové platformové API, které umožňuje webovým stránkám vytvářet a používat přihlašovací údaje s veřejným klíčem.
Dvě metody prohlížeče tvoří základ:
navigator.credentials.create()
navigator.credentials.get()
První vytváří přihlašovací údaj. Druhá žádá o autentizaci pomocí existujícího přihlašovacího údaje.
Obě metody pracují s možností publicKey a vyžadují bezpečný kontext, obvykle HTTPS.
Důležité je, že prohlížeč nerozhoduje, zda je uživatel autentizován. Vrací data, která backend musí ověřit.
Úspěšný výzva v prohlížeči není důkazem, že by se mělo přihlášení přijmout.
Server zůstává zodpovědný za ověření výzvy (challenge), origin, identifikátoru relying party a kryptografických důkazů.
3. Pochopte kompletní architekturu
Typická implementace obsahuje čtyři komponenty:
- Frontend webové aplikace, který volá WebAuthn.
- Backend aplikace, který generuje výzvy a ověřuje odpovědi.
- Autentikátor nebo poskytovatel passkeys, který chrání privátní klíč.
- Databáze, která ukládá metadata přihlašovacích údajů a veřejné klíče.
Registrační tok je: webová aplikace požaduje možnosti registrace; backend generuje výzvu a uživatelská data; prohlížeč a autentikátor vytvoří přihlašovací údaj a pár klíčů; a backend ověří výsledek a uloží veřejný klíč.
Server nesmí důvěřovat registračním datům jen proto, že byla vrácena prohlížečem.
Zlomyslný klient může odeslat libovolné HTTP požadavky bez použití očekávaného frontendu.
To je důvod, proč ověření patří na server.
4. Generujte možnosti registrace na serveru
Před voláním WebAuthn backend generuje registrační výzvu a možnosti.
Reprezentativní objekt možností vypadá takto:
{
"rp": {
"name": "Example Application",
"id": "example.com"
},
"user": {
"id": "dXNlci0xMjM",
"name": "alex@example.com",
"displayName": "Alex"
},
"challenge": "SERVER_GENERATED_BASE64URL_CHALLENGE",
"pubKeyCredParams": [
{
"type": "public-key",
"alg": -7
}
],
"authenticatorSelection": {
"residentKey": "required",
"userVerification": "required"
},
"attestation": "none",
"timeout": 300000
}
Jedná se o ilustrační JSON, ne kompletní produkční odpověď.
Několik polí je důležitých.
rp.id identifikuje relying party. Například example.com lze použít pro vhodné subdomény této domény, podle pravidel validace RP ID v WebAuthn.
user.id by měl být stabilní, neprůhledný identifikátor účtu zakódovaný jako base64url pro přenos v JSON. Neměl by vystavovat zbytečné osobní informace.
challenge musí být generován pomocí kryptograficky bezpečného náhodného zdroje na serveru.
residentKey: "required" žádá o zjistitelný přihlašovací údaj, což je nezbytné pro prostředí passkeys.
userVerification: "required" žádá o lokální ověření uživatele, jako je PIN zařízení nebo biometrická autentizace. Backend musí později zkontrolovat, že ověření skutečně proběhlo.
Googlový průvodce serverovou registrací popisuje tato pole a doporučuje používat udržovanou WebAuthn knihovnu pro generování a validaci registračních dat.
5. Vytvořte passkey v JavaScriptu
Moderní prohlížeče poskytují užitečnou metodu:
PublicKeyCredential.parseCreationOptionsFromJSON()
Převede JSON reprezentaci obsahující base64url-zkódovaná binární pole na strukturu očekávanou WebAuthn.
Tím se vyhnete psaní vlastní logiky pro převod base64url na ArrayBuffer pro každé pole.
Zde je zjednodušená browser-side registrační funkce:
async function registerPasskey() {
const optionsResponse = await fetch(
'/api/passkeys/register/options',
{
method: 'POST',
credentials: 'same-origin',
headers: {
'Content-Type': 'application/json',
'X-CSRF-Token': csrfToken
}
}
);
if (!optionsResponse.ok) {
throw new Error('Unable to start registration');
}
const optionsJson = await optionsResponse.json();
const publicKey =
PublicKeyCredential.parseCreationOptionsFromJSON(
optionsJson
);
const credential = await navigator.credentials.create({
publicKey
});
if (!credential) {
throw new Error('No credential was created');
}
const verifyResponse = await fetch(
'/api/passkeys/register/verify',
{
method: 'POST',
credentials: 'same-origin',
headers: {
'Content-Type': 'application/json',
'X-CSRF-Token': csrfToken
},
body: JSON.stringify(credential.toJSON())
}
);
if (!verifyResponse.ok) {
throw new Error('Registration verification failed');
}
return await verifyResponse.json();
}
Proměnná csrfToken představuje aplikačně poskytnutý anti-CSRF token. Server ho musí ověřit. Příklad také předpokládá, že stránka je již spojena se zabezpečeně autentizovaným uživatelem.
credential.toJSON() poskytuje JSON-příjemnou reprezentaci vráceného přihlašovacího údaje, čímž se vyhne další vrstvě ruční binární serializace.
Tyto pohodlnosti jsou dostupné v současných prohlížečích, i když aplikace podporující starší verze prohlížečů by měly zajistit kompatibilitu.
Kód výše je pouze stranou prohlížeče. Není to kompletní implementace autentizace.
6. Co server musí ověřit během registrace
Když prohlížeč vrátí nový přihlašovací údaj, backend musí ho ověřit před uložením čehokoliv.
Minimálně proces ověření musí zjistit, že:
- Vrácená výzva odpovídá té vygenerované pro tento registrační pokus.
- Výzva je čerstvá a ještě nebyla spotřebována.
- Nahlášený origin odpovídá explicitně důvěryhodnému originu aplikace.
- Data autentikátoru odpovídají očekávanému RP ID.
- Požadované podmínky uživatelské přítomnosti a ověření uživatele jsou splněny.
- Veřejný klíč a identifikátor přihlašovacího údaje lze extrahovat a ověřit.
- Registrace je spojena se správným autentizovaným účtem.
V závislosti na politice aplikace mohou další kontroly zahrnovat podporované algoritmy, unikátnost přihlašovacího údaje a požadavky na atestaci.
Úspěšná registrace obvykle ukládá:
| Pole | Účel |
|---|---|
credential_id |
Identifikuje přihlašovací údaj |
user_id |
Spojuje ho s účtem |
public_key |
Ověří budoucí podpisy |
sign_count |
Sleduje data čítače autentikátoru |
transports |
Volitelné nápovědy k transportu autentikátoru |
created_at |
Časové razítko registrace |
last_used_at |
Správa účtu a auditování |
backup_eligible / backup_state |
Volitelné metadata související se zálohováním |
Přesná databázová reprezentace závisí na verifikační knihovně a aplikaci.
Neimplementujte parsování CBOR, verifikaci atestace nebo kryptografickou validaci podpisu od nuly, pokud nemáte dôvod a odbornost k její údržbě.
W3C specifikace definuje podrobné postupy verifikace registrace a autentizace.
7. Autentizujte existujícího uživatele
Autentizace následuje podobnou strukturu, ale nevytváří nový pár klíčů.
Server vygeneruje novou výzvu a pošle autentizační možnosti prohlížeči.
Pro přihlášení zjistitelným passkeyem mohou tyto možnosti obsahovat:
{
"challenge": "NEW_SERVER_GENERATED_CHALLENGE",
"rpId": "example.com",
"userVerification": "required",
"timeout": 300000
}
Prohlížeč pak může požádat o přihlašovací údaj:
async function authenticateWithPasskey() {
const optionsResponse = await fetch(
'/api/passkeys/login/options',
{
credentials: 'same-origin'
}
);
if (!optionsResponse.ok) {
throw new Error('Unable to start authentication');
}
const optionsJson = await optionsResponse.json();
const publicKey =
PublicKeyCredential.parseRequestOptionsFromJSON(
optionsJson
);
const credential = await navigator.credentials.get({
publicKey
});
if (!credential) {
throw new Error('Authentication was cancelled');
}
const verifyResponse = await fetch(
'/api/passkeys/login/verify',
{
method: 'POST',
credentials: 'same-origin',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify(credential.toJSON())
}
);
if (!verifyResponse.ok) {
throw new Error('Authentication failed');
}
return await verifyResponse.json();
}
Tento příklad předpokládá, že backend spojí vydanou výzvu s krátkodobou anonymní přihlašovací transakcí, aplikuje vhodné rate limiting a vytvoří novou autentizovanou relaci až po úspěšné verifikaci.
Server musí vyhledat ID přihlašovacího údaje, ověřit podepsanou assertion uloženým veřejným klíčem, potvrdit výzvu a origin a vynutit svou politiku ověření uživatele.
Až tehdy by měl vytvořit relaci uživatele.
parseRequestOptionsFromJSON() je součástí moderního WebAuthn API a odstraní potřebu ručně dekódovat binární pole v běžných browser-side integracích.
8. Přidejte passkeys do stávajících přihlašovacích formulářů s podmíněnou mediací
Jednou z nejužitečnějších vlastností WebAuthn je podmíněná mediace, někdy zvaná passkey autofill.
Místo aby prohlížeč hned zobrazoval samostatný passkey dialog, může nabídnout dostupný passkey společně s dalšími uloženými přihlašovacími údaji, když uživatel interaguje s přihlašovacím polem.
HTML input může použít:
<input
type="text"
name="username"
autocomplete="username webauthn"
>
Aplikace může zkontrolovat podporu:
const supported =
await PublicKeyCredential.isConditionalMediationAvailable();
if (supported) {
// Request authentication with mediation: 'conditional'.
}
Při volání navigator.credentials.get() aplikace používá:
{
publicKey,
mediation: 'conditional'
}
Pro autofill zjistitelných přihlašovacích údajů by možnosti serveru neměly omezovat požadavek na konkrétní seznam ID přihlašovacích údajů.
Podmíněná mediace je obzvláště užitečná při postupné migraci z hesel, protože uživatelé nemusí pamatovat, zda konkrétní účet má passkey.
Prohlížeč může prezentovat vhodné možnosti ve známém přihlašovacím prostředí.
9. Proč kontroly výzvy a originu jsou zásadní
Passkeys jsou odolné vůči phishingu, ale to neznamená, že aplikace může ignorovat svůj autentizační protokol.
Výzva (challenge) chrání před replay útoky.
Bez čerstvé, nepředvídatelné výzvy by útočník mohl zkusit znovu použít autentizační data z předchozí relace.
Kontroly originu a RP ID zajišťují, že přihlašovací údaje jsou používány v zamýšleném kontextu webové stránky.
Například passkey vytvořený pro example.com nemůže být jednoduše znovu použit podvodnou stránkou jako examp1e.com.
Prohlížeč a autentikátor vynutila důležité části této vazby na doménu, zatímco backend nezávisle ověřuje vzniklé důkazy.
Dobrá implementace používá krátkodobé výzvy, spotřebuje každou výzvu jednou a nikdy nepřijímá libovolné originy jen proto, že sdílejí známě vypadající hostname.
MDN doporučuje generovat výzvy v důvěryhodném prostředí a zneplatňovat je po krátké době, obecně ne déle než asi deset minut.
10. Nefalejte v nepochopení podpisových čítačů
WebAuthn autentikátory mohou zahrnovat podpisový čítač.
Historicky čítače pomáhali detekovat potenciálně klonované autentikátory. Pokud čítač neočekávaně přestane růst, relying party to může považovat za rizikový signál.
Avšak ne každý autentikátor udržuje smysluplný čítač.
Některé přihlašovací údaje vždy hlásí nulu. Synchronizované přihlašovací údaje mohou také komplikovat interpretaci čítače, protože více zařízení může používat kopie stejného přihlašovacího údaje.
W3C specifikace explicitně zachází s neočekávaným chováním čítače jako možným signálem, ne jako definitivním důkazem klonování.
Proto by vývojáři neměli slepě odmítat každé přihlášení, jehož čítač je nula nebo se nezměnil.
Používejte čítač podle chování autentikátoru, pokynů WebAuthn verifikační knihovny a bezpečnostní politiky aplikace.
11. Obnova účtu je součástí bezpečnosti passkeys
Implementace passkeys není kompletní bez strategie obnovení.
Co se stane, když uživatel ztratí zařízení?
Co když smaže svůj jediný passkey?
Co když změní poskytovatele přihlašovacích údajů nebo nemá přístup k synchronizovanému přihlašovacímu údaji?
Rozumný návrh umožňuje uživatelům registrovat více passkeys a spravovat je z nastavení účtu.
Rozhraní pro správu by mělo zobrazovat rozpoznatelné názvy přihlašovacích údajů, data vytvoření a informace o nedávném použití, pokud jsou k dispozici.
Uživatelé by měli mít možnost odvolat přihlašovací údaje, kterým už nedůvěřují.
Ale mechanismus obnovení zaslouží zvláštní péči.
Pokud útočník může obejít autentizaci passkeys pomocí slabého emailového procesu obnovení, celý účet je jen tak bezpečný, jako je ta cesta k obnovení.
Pro účty s vyšším rizikem zvažte silnější verifikaci obnovení, obnova kódy, další registrované autentikátory a upozornění o citlivých změnách účtu.
Googlový UX průvodce passkeys doporučuje zřídit metodu obnovení a podporovat více passkeys, kde je to vhodné.
12. Časté implementační chyby
Několik chyb opakovaně podkopává jinak slibné passkey integrace.
Považování úspěchu prohlížeče za serverovou autentizaci. Vyřešený navigator.credentials.get() promise nenahrazuje serverovou kryptografickou verifikaci.
Generování výzev v JavaScriptu. Výzvy by měly pocházet z důvěryhodného serveru a být svázány s příslušnou autentizační transakcí.
Použití špatného RP ID. Doménové rozmezování je bezpečnostní vlastnost, ne kosmetické nastavení. Produkční, staging a lokální vývojová prostředí vyžadují úmyslnou konfiguraci.
Předpokládání, že všechny passkeys synchronizují. Zařízeními vázané přihlašovací údaje zůstávají důležitou częścií ekosystému.
Zapomenutí odvolání přihlašovacích údajů. Uživatelé potřebují způsob, jak odebrat ztracený nebo ohrozený autentikátor ze svého účtu.
Vytvoření slabého záložního mechanismu. Phishing-odolné přihlášení ztrácí hodně své hodnoty, pokud lze obnovení účtu snadno zneužít.
Ignorování starých prohlížečů. Moderní JSON metody zjednodušují, ale aplikace s požadavky na starší prohlížeče stále mohou potřebovat kompatibilní kód.
Vynechání CSRF a ochrany relací. Registrace a operace správy přihlašovacích údajů jsou citlivé změny účtu. Potřebují stejnou ochranu jako jiné akce s vysokým dopadem na účet.
Psaní vlastní kryptografické verifikace zbytečně. Udržovaná WebAuthn serverová knihovna je obvykle bezpečnější volba než přímá implementace specifikace.
13. Měly by všechny webové stránky okamžitě nahradit hesla?
Ne nutně.
Passkeys mohou zlepšit jak použitelnost, tak bezpečnost, ale strategie migrace je důležitá.
Pro novou aplikaci může být bezheslová registrace rozumným výchozím nastavením, pokud má produkt dobře navržený obnova tok a podporuje své cílové platformy.
Pro existující aplikaci s tisíci uživateli je inkrementální adopce často bezpečnější.
Začněte tím, že umožníte autentizovaným uživatelům registrovat passkeys v nastavení účtu.
Pak přidejte passkey přihlášení vedle stávajícího autentizačního systému.
Zavedejte podmíněnou mediaci tam, kde je podporována.
Měřte úspěch registrace, selhání autentizace, kompatibilitu zařízení a požadavky na obnovení.
Nakonec zvažte udělení passkeys preferovanou autentizační metodou, jakmile je uživatelské prostředí a mechanismy obnovení dostatečně zralé.
Fázovaný rollout také usnadňuje identifikaci prohlížeč-specifických problémů bez zamknutí legitimních uživatelů venku.
14. Kontrolní seznam pro produkční připravenost
Před povolením passkeys v produkci ověřte následující:
- Všechny WebAuthn operace běží v příslušném bezpečném kontextu.
- RP ID a důvěryhodné originy jsou explicitně nakonfigurovány.
- Výzvy jsou kryptograficky náhodné, krátkodobé a jednorázové.
- Registrace vyžaduje příslušnou autorizaci účtu.
- Serverová verifikace následuje WebAuthn specifikaci.
- Veřejné klíče a identifikátory přihlašovacích údajů jsou uloženy bezpečně.
- Přihlášení vytvoří relaci až po úspěšné verifikaci.
- Požadavky na ověření uživatele jsou vynuceny na serveru.
- Odstranění přihlašovacích údajů a obnovení účtu jsou chráněny.
- Více přihlašovacích údajů na účet je podporováno, kde je to vhodné.
- Selhání autentizace a bezpečnostně citlivé změny účtu jsou monitorovány.
- Mobilní, desktopové, cross-device a hardwarový klíč scénáře jsou otestovány.
Tyto kontroly jsou důležitější než to, zda frontend dokáže zobrazit atraktivní biometrický přihlašovací prompt.
Závěr: passkeys jsou autentizační architektura, ne jen funkce prohlížeče
WebAuthn dělá autentizaci s veřejným klíčem přístupnou pro běžné webové aplikace.
Moderní prohlížečová API odstranila grande část serializační práce, která dříve ztěžovala integraci passkeys.
Ale prohlížeč je jen jednou částí systému.
Skutečná implementační práce spočívá v správě výzev, serverové verifikaci, ukládání přihlašovacích údajů, doménové konfiguraci, obnovení účtu a bezpečných uživatelských cestách.
Pro vývojáře budující moderní aplikace v PHP, JavaScriptu, Pythonu nebo jiných backendových prostředích jsou passkeys čím dál více vhodnou praktickou alternativou k tradičním heslům.
Nejlepším výchozím bodem není nahrazení celého autentizačního systému přes noc.
Je to implementace jednoho kompletního, správně ověřeného registračního a přihlašovacího toku, a pak budování bezpečné migrační strategie kolem něj.