Passkeys ve WebAuthn 2026'da: Web Geliştiricileri için Pratik Uygulama Kılavuzu
Passkeys, şifre gizli tutmadan şifreli olmayan oturum açmayı vaat eder, ancak WebAuthn'i doğru şekilde uygulamak, bir tarayıcı API'sini çağırmaktan daha fazlasını gerektirir. Kayıt, kimlik doğrulama, sunucu tarafı doğrulama, keşfedilebilir kimlik bilgileri ve hesap kurtarma işlemlerinin güvenli bir web uygulamasında nasıl bir araya geldiğini öğrenin.
Passkeys and WebAuthn in 2026: Web Geliştiricileri için Pratik Uygulama Kılavuzu
Parolalar, web uygulamaları için dekadler boyunca varsayılan kimlik doğrulama mekanizması olmuştur. Ayrıca devam eden güvenlik sorunları da kaynağıdır.
Kullanıcılar tekrar kullanırlar. Saldırıcılar phishing yoluyla onları çalar. Sunucular parola hash'lerini korumalı, sıfırlamaları yönetmel ve credential-stuffing saldırılarına karşı korumalı olmalıdır.
Passkeys, temel olarak farklı bir yaklaşım sunar.
Kullanıcıların bir ortak gizli şifreyi hatırlamasını isteyenek, passkeys, kullanıcı kontrollü bir authenticator ile public-key kriptografisi kullanır. Tarayıcı WebAuthn üzerinden standart bir arabirim sağlarken, sunucu doğru kimlik bilgisinin kullanıldığını doğrulamak için kriptografik kanıtı verir.
Teknoloji art deneysel değildir. WebAuthn modern tarayıcılarda geniş olarak mevcuttur ve JSON uygun yöntemleri entegrasyonu considerably kolaylaştırmıştır.
Ancak güvenli bir passkey girişi inşa etmek henBackend tasarımı dikkatli gerektirir.
Bu kılavuz mimariyi açıklar, tarayıcı tarafı akışlarını demonstrasyonlar ve geliştiricilerin ihmal etmemi gereken sunucu tarafı kontrolleri tanımlar.
1. Passkey Nedir Tam olarak?
Passkey, public-key kriptografisi kullanarak bir kullanıcayı kimlik doğrulamak için kullanılan bir FIDO bulabilen kimlikdir.
Kayıt sırasında, bir authenticator kriptografik anahtar çifti oluşturur.
Özel anahtar, authenticator veya kimlik bilgisi yönetim ekosistemine tarafından korurulur. Web sitesi Corresponding public key alır ve kullanıcı hesabına ilişkilendirir.
Kimlik doğrulaması sırasında, sunucu yeni bir challenge çıkar. Authenticator, challenge ile ilişkili veriyi imzalar ve sunucu stored public key kullanarak imzayı doğrular.
Web sitesine tekrar kullanılabilir parola gönderilmez.
Authenticator, bir akıllı telefon, Windows Hello kullanan bir bilgisayar, donanım güvenlik anahtarı veya senkronize passkeys destekleyen bir kimlik bilgisi yöneticisi olabilir.
Her passkey'ın cihazlar arasında senkronize olmadığı her passkey. bazı kimlik bilgileri cihaza bağlı kalırken, diğerleri güvenli yedeğine alındı ve bir kimlik bilgisi sağlayıcısı aracılığıyla kullanılabilir hale getirilebilir.
FIDO spesifikasyonları, bağlamayı relying party's domain'a bağlayarak phishing'e karşı direncil olarak tasarlanmıştır. Biometrik veri, kullanıldığında cihaz tarafından yerel olarak işleme alınmaz ve website gönderilmez.
2. WebAuthn, passkeys Arkasındaki Tarayıcı API'si
WebAuthn, sitelerin public-key kimlik bilgilerini oluşturmasını ve kullanmasını sağlayan web platform API'sidir.
Temel iki tarayıcı yöntemi şunlardır:
navigator.credentials.create()
navigator.credentials.get()
Birincisi bir kimlik bilgisi oluşturur. İkisi mevcut bir kimlik bilgisi kullanarak kimlik doğrulaması ister.
Her ikisi de publicKey seçeneği ile çalışır ve güvenli bir bağlam gerektirir, normal olarak HTTPS.
Önemli, tarayıcı kullanıcının kimliğini kararağacı olarak kararlaştırmaz. Arka uç tarafından doğrulanması gereken veriyi döndürür.
Başarılı bir tarayıcı istemi, bir girişin kabul edilmesi kanıtı değildir.
Sunucu, challenge, kaynak, relying-party tanımlayıcı ve kriptografik kanıtı doğrulamakla sorumludur.
3. Tamlum Tam Mimariyi
Tipik bir uygulama dört bileşen içerir:
- WebAuthn'ı çağrılan web uygulaması frontend'i,
- challenges oluşturup yanıtları doğrulayan uygulama backend'i,
- Özel anahtarı koruyan authenticator veya passkey sağlayıcısı,
- kimlik bilgisi meta verilerini ve public key'leri depolayan veri tabanı,
Kayıt akışı: web uygulaması kayıt seçenekleri ister; backend bir challenge ve kullanıcı verisi oluşturur; tarayıcı ve authenticator bir credential ve key çifti oluşturur; ve backend sonucu doğrular ve public key'i depolar.
Sunucu, kayit verilerini yalnızca tarayıcının döndürmesi nedeniyle asla güvenmemelidir.
K惡意的なクライアントは、期待されるフロントエンドを使用せずに arbitrary HTTP リクエストを送信できます。
Neden doğrulama sunucuda yapılmalıdır.
4. Sunucuda Kayıt Seçenekleri Üret
WebAuthn' çağrılmadan önce, backend bir kayıt challenge ve seçenekler üirir.
Temsilçi options nesnesi bu şekilde görünebilir:
{
"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
}
Bu illustrative JSON, tam bir üretim yanıtı değil.
Birkaç alan önemli.
rp.id relying party'yi tanımlar. Örneğin, example.com WebAuthn's RP ID doğrulama kurallarına konu olarak domainin uygun alt domainleri için kullanılabilir.
user.id base64url için JSON taşıması yapıstabil,.opaque account identifier olmalı. Gereksiz kişisel bilgiyi ortaya çıkmamalıdır.
challenge sunucuda kripto güvenli rastgele kaynak kullanılarak üretilmelidir.
residentKey: "required" discoverable credential ister, passkey deneyimi için necesaria.
userVerification: "required" yerel kullanıcı doğrulama ister, cihaz PIN'si veya biometrik kimlik doğrulaması gibi. Backend daha sonra gerçekte doğrulama gerçekleştiğini kontrol etmelidir.
Google's server-side registration guide bu alanları tanımlar ve kayıt verisi oluşturma ve validation için bakım gören bir WebAuthn kütüphanesi kullanmayı önerir.
5. JavaScript'te Passkey Oluştur
Modern tarayıcılar kullanışlı bir yöntem sağlar:
PublicKeyCredential.parseCreationOptionsFromJSON()
base64url-encoded binary fields'i WebAuthn' beklenen yapıya dönüştürür.
Her alan için özel base64url-to-ArrayBuffer dönüştürme mantığını yazmaktan kaçınır.
Basit bir tarayıcı tarafı kayıt fonksiyonu:
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();
}
The csrfToken değişkeni, uygulama tarafından sağlanan bir anti-CSRF token'ını temsilir. Sunucu onu doğrulamalıdır. Örnek ayrıca sayfa zaten güvenli olarak kimlik doğrulanmış bir kullanıcıyla ilişkili olduğunu varsayar.
credential.toJSON(), döndürülen credential'ın JSON-pleasant bir temsili sağlar, başka bir manuel binary seri durumuna dönüştürme katmanını önler.
Bu conveniences, mevcut tarayıcılarda kullanılabilir, ancak eskı tarayıcı sürümlerini destekleyen uygulamalar uyumluluk işlemleri sağlamalıdır.
Yukarıdaki kod sadece tarayıcı tarafıdır. Tam bir authentication implementation değildir.
6. Kayıt sırasında Sunucunun Doğrulması Gerekenler
Tarayıcı yeni bir credential döndürdüğüne, backend herhangi bir şey depolarmadan önce bunu validasyon etmeli.
En az doğrulama sürecinin şunu स्थापित etmesi gerekir:
- Bu kayıt denemesi için oluşturulan challenge döndürülenle eşleşir.
- Challenge fresh olup tüketilmemiş olduğundan emin olmalı.
- Raporlanan kaynak, açıkça güvenilen uygulama kaynağıyla eşleşir.
- Authenticator verisi beklenilen RP ID'ye corresponds.
- Gerekli user-presence ve user-verification koşulları sağlanmalıdır.
- Credential's public key ve identifier çıkarılabilir ve valid edilebilir.
- Kayıt, doğru authenticated account ile ilişkilidir.
Uygulamanın ilkesine bağlı olarak, ek kontroller desteklenen algoritmalar, credential uniquess ve attestation requirements içerebilir.
Başarılı bir kayıt tipik olarak şunu depolar:
| Field | Purpose |
|---|---|
credential_id |
Identifies the credential |
user_id |
Links it to an account |
public_key |
Verifies future signatures |
sign_count |
Tracks authenticator counter data |
transports |
Optional authenticator transport hints |
created_at |
Registration timestamp |
last_used_at |
Account management and auditing |
backup_eligible / backup_state |
Optional backup-related metadata |
Taban veritabanı temsilinin t tam verification library ve uygulama depends.
CBOR parsing, attestation verification veya cryptographic signature validation from scratch uygulamanız özellikle bir neden yok ve bunu bakım alacak uzmanlık sahipseniz yapmayın.
W3C spesifikası detaylı kayıt ve authentication verification prosedürleri tanımlar.
7. Mevcut Kullanıcıyı Kimlik Doğrula
Kimlik doğramması benzer bir yapı izler ancak yeni bir key çifti oluşturmaz.
Sunucu yeni bir challenge oluşturup tarayıcıya authentication seçenekleri gönderir.
Görülebilir passkey login için o seçenekler şunları içerebilir:
{
"challenge": "NEW_SERVER_GENERATED_CHALLENGE",
"rpId": "example.com",
"userVerification": "required",
"timeout": 300000
}
Tarayıcı ardından bir credential ister:
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();
}
Bu örnek, backend issued challenge'ı kısa ömürlü, anonymous login transaction ile ilişkilendirir, appropriate rate limiting uygular ve başarıyla doğrulama sonrası yeni authenticated session establishe eder.
Sunucu credential ID'yi look up eder, stored public key ile signed assertion'ı doğrular, challenge ve origin'ı doğrular, user-verification policy'yi zorunlu kılar.
Sadece o zaman kullanıcının session'ını oluşturmalıdır.
parseRequestOptionsFromJSON(), modern WebAuthn API'nin bir parçası olup, yaygın tarayıcı tarafı entegrasyonlarında manuel binary field decode ihtiyacını kaldırır.
8. Koşullu Ara ile Mevcut Login Formlarına Passkey Ekle
WebAuthn'ın en kullanışlı özelliklerinden biri koşullu aradır, bazen passkey autofill denir.
Aynen ayrı bir passkey dialog göstermek yerine, tarayıcı kullanıcı bir login alanına etkileşimde bulunduğunda kullanılabilir passkey'i diğer kaydedilmiş kimlik bilgileri yanında sunabilir.
HTML input şunu kullanabilir:
<input
type="text"
name="username"
autocomplete="username webauthn"
>
Uygulama destek kontrolü yapabilir:
const supported =
await PublicKeyCredential.isConditionalMediationAvailable();
if (supported) {
// Request authentication with mediation: 'conditional'.
}
navigator.credentials.get()'i çağırdığında, uygulama şunu kullanır:
{
publicKey,
mediation: 'conditional'
}
Görülebilir-credential autofill için sunucunun seçenekleri, belirli bir credential ID listesine isteği kısıtlamamalıdır.
Koşullu ara, parolalardan تدريجي geçiş sırasında özellikle kullanışlıdır, kullanıcılar belirli bir account passkey'a sahip olduğunu hatırlamaya gerek kalmaz.
Tarayıcı tanıdık login deneyiminin içinde uygun seçenekleri sunabilir.
9. Challenge ve Origin Kontrollerinin Neden Önemli Olması
Passkeys phishing'e dayanıklı olsa bir aplikasyonun authentication protokolünü ihmal etmesi anlamına gelmez.
Challenge replay saldırılarına karşı korur.
Fresh, unpredictable bir challenge olmadan, saldırıcı önceki bir session'dan authentication verisini tekrar kullanmaya çalışabilir.
Origin ve RP ID kontrolleri, kimlik bilgilerinin planlanan website bağlamında kullanıldığından emin olur.
Örneğin, example.com için oluşturulmuş bir passkey, examp1e.com gibi bir lookalike phishing sitesi tarafından basitçe tekrar kullanılmaz.
Tarayıcı ve authenticator bu domain binding önemli parçalarını zorlar, backend sonuç kanıtı bağımsız olarak valid eder.
İyi bir implementasyon, kısa ömürlü challenge'lar kullanır, her challenge'ı bir kez tüketir ve tanıgıhostname'ların akıldak benzeyen nedeniyle yanık geleneksel kaynakları asla kabul etmez.
MDN, challenged güvenilir ortamda üretilir ve yaklaşık on dakikaya kadalık kısa bir süre sonra geçersiz kılınır önerir.
10. İmza Sayacı Kavgalanma
WebAuthn authenticatorlar bir imza sayacı içerebilir.
Tarihsel olarak, sayacıpotentially cloned authenticators algılamak için yardımcı oldu. Counter beklenmedik şekilde artışa durursa, relying party risk sinyal olarak düşünebilir.
Ancak her authenticator anlamlı bir sayacı korumaz.
birçok kimlik bilgileri her zaman sıfır raporlar. Senkronize kimlik bilgileri, birden fazla cihazın aynı kimlik bilgisi kopyalarını kullanabilir counter yorumlamayı karmaşıklaştırır.
W3C spesifikası, beklenmedik counter davranışını kesin cloning proof olası bir sinyal olarak muamelesır.
Bu nedenle, geliştiriciler counter'ı nol veya değiştirmeden her login reddirmeden bulunmayacak.
Counter'ı authenticator davranışına, WebAuthn verification library's guidance ve uygulamanın güvenlik ilkesine göre kullanın.
11. Hesap Kurtarması Passkey Güvenliğin Bir Parçası
Bir passkey implementasyonu bir recovery strategy olmadan tam değildir.
Kullanıcı bir cihaz kaybettiğinde ne olabilir?
Sadece passkey'ını silerlse ne olur?
Kimlik bilgisi sağlayıcısını değiştirirse veya senkronize bir credential'a erişemediği durumda ne olur?
Akılcı bir tasarım, kullanıcıların birden çok passkey kaydolmasını ve hesap ayarlarından yönetmesini sağlar.
Yönetim arayızes, tanınabilir credential isimleri, oluşturulma tarihleri ve kullanılabilirse güncel kullanım bilgilerini göstermelidir.
Kullanıcılar, daha güvenmediği kimlik bilgilerini revoke edebilmelidir.
Ancak kurtarma mekanizması özel dikkat deserves.
Eğer bir saldırıcı zayıf email recovery sürecini kullanarak passkey authentication'ı bypass edebilirse, genel hesap o recovery path kadar güvenli olur.
Daha riskli hesaplar için, stronger recovery verification, recovery codes, additional registered authenticators ve hassas hesap değişiklikleri hakkında bildirimleri düşünün.
Google's passkey UX kılavuzu, uygun bir recovery yöntemini kurma ve uygun onde multiple passkeys destekleme önerir.
12. Ortak Uygulama Hataları
Birçok hata, beraberinde promissing passkey entegrasyonları zayıflatır.
Tarayıcı başarısı sunucu kimlik doğrulaması olarak değerlendirilir. Bir resolved navigator.credentials.get() promise, server-side kriptographic verification'i değiştirmez.
JavaScript'te challenge generer. Challenge'lar güvenilir sunucudan olmalı ve appropriate authentication transaction ile bağlı olmalı.
Yanlış RP ID kullanımı. Domain scoping, beauty bir ayar değil, güvenlik özelliğidir. Production, staging ve local development ortamları deliberate konfigürasyon gerektirir.
Tüm passkeys senkronize olduğunu varsama. Device-bound credential'lar ekosisteminin önemli bir parçası kalır.
Kimlik bilgisi revocation'u unutmak. Kullanıcılar, lost veya compromised authenticator'ları hesabından kaldırmak için bir yol ihtiyacı vardır.
Zayıf bir fallback oluşturmak. A phishing-resistant login, account recovery easily exploited ise çok değerini kaybeder.
Eski tarayıcıları ihmal etme. Modern JSON uygun yöntemler karmaşıklığı azaltır, ancak eskı tarayıcı gerektiren uygulamalar yine de uyumluluk kodu ihtiyacı olabilir.
CSRF ve session protection'ı atmak. Registration ve credential-management işlemleri hassas hesap değişiklikleridir. diğer yüksek etkili hesap eylemleriyle aynı korumalar gerekir.
Needless custom cryptographic verification yazmak. Bir bakım gören WebAuthn sunucu kütüphanesi, doğrudan spesifikayı uygulaymakten daha güvenlidir.
13. Her website anında parolaları değiştirmeli mi?
Elbette değil.
Passkeys hem usability hem security'ı iyileştirebilir, ancak migration strategy matter.
Yeni bir uygulama için, ürün iyi tasarlanmış bir recovery akımı target platformlarını desteklerse parolaless registration makul default olabilir.
Binlerlerci kullanıcılı bir mevcut uygulama için, incremental adoption daha güvenli olabilir.
Başarılı kullanıcılarla başlayarak, hesap ayarlarında passkey kaydetme izin verin.
Ardından mevcut authentication sisteminin yanına passkey login ekleyin.
Koşullu ara destekleninceye bulundurulur.
Kayıt başarısı, authentication hataları, cihaz uyumluluk ve recovery talepleri Ölçün.
Sonunda, kullanıcı deneyimi ve recovery mekanizmaları yeterince matüre ulaşılıncaya passkeys tercih edilen kimlik doğrulama yöntemi olma iradesini düşünün.
A phased rollout, sahte kullanıcıları dışarı kilitlemadan tarayıcı özel sorunları tanımlamak daha kolay olur.
14. Üretim Hazırlık Listesi
Passkey'leri üretime etkinleştirmeden önce, aşağıdaki doğrulanmal:
- Tüm WebAuthn işlemler uygun bir secure context içinde çalışır.
- RP IDs ve güvenilen kaynaklar açıklandığı şekilde konfigüre edilir.
- Challenge'lar kripto random, short-lived ve single-use olmalı.
- Kayıt uygun account yetkisi gerektirir.
- Sunucu tarafı verification WebAuthn spesifikasyonunu izler.
- Public key'ler ve credential identifier'lar güvenli bir şekilde depolanır.
- Başarılı doğrulama sonrası sadece session establish edilir.
- User-verification gereklilikleri sunucuda zorunlu kılınır.
- Credential removal ve account recovery korunur.
- Uygun yerde birden çok credential per account desteklenir.
- Authentication hataları ve security-sensitive hesap değişiklikler izlenir.
- Mobil, masaüstü, cross-device ve hardware-key senaryolar test edilir.
Bu kontroller, frontend biometric login prompt display edebilinceye daha önemli matter.
Sonuç: Passkeys, Sadece Bir Tarayıcı Özelliği Değil, Authentication Architecturedır
WebAuthn, sır ordinary web uygulamalarına public-key authentication erişilebilir kılar.
Modern tarayıcı API'leri, daha önce passkey integration'i massively cumbersome yapmış serialization çalışmalarını çok azalttı.
Ancak tarayıcı sistemin sadece bir parçasıdır.
Gerçek uygulama çalışı, challenge management, server-side verification, credential storage, domain configuration, account recovery ve secure user journeys'da yatık.
PHP, JavaScript, Python veya diğer backend ortamlarında modern uygulamalar geliştiriyorlar, passkeys tradisional passwords'ün pratik bir alternatif olarak değerlendirilene kadar art increasingly değer.
En iyi başlangıç noktası, bir entire authentication system overnight değiştirmek değil.
Biri tam olarak, doğru doğrulanmış bir kayıt ve login akışı uygulayın, ardından b ona çevrelemek güvenli bir migration strategy.