
OAuth 2.1 Standardında PKCE ile Yetkilendirme Kodu Akışı Koruması
Mobil ve tek sayfa uygulamalarında istemci sırrı tutma çıkmazı, OAuth 2.1 ile zorunlu kılınan PKCE mekanizması ve yetki kodu çalınması savunması.
OAuth 2.1 Standardında PKCE ile Yetkilendirme Kodu Akışı Koruması
Modern web ve mobil uygulama ekosisteminde kullanıcı yetkilendirmesi OAuth protokol ailesi üzerine kuruludur. Ancak 2012 yılında yayımlanan OAuth 2.0 (RFC 6749) standardı, günümüzün tek sayfa uygulamaları (SPA) ve yerel mobil yazılımları için ciddi güvenlik boşlukları barındırmaktaydı.
Eski standartta yer alan Örtük Yetkilendirme (Implicit Grant) akışı, erişim belirtecini (access token) doğrudan URL parçası (hash fragment) üzerinden tarayıcıya döndürerek tarayıcı geçmişine ve erişim kütüklerine sızmasına yol açıyordu. Daha da kritik olan sorun ise mobil uygulamalarda Yetkilendirme Kodu Araya Girme Saldırısı (Authorization Code Interception Attack) karşısında sistemlerin savunmasız kalmasıydı.
IETF tarafından hazırlanan OAuth 2.1 konsolidasyonu bu zafiyetleri gidermek için güvensiz akışları tamamen yürürlükten kaldırdı ve Kod Değişimi için İspat Anahtarı (PKCE - RFC 7636) mekanizmasını tüm istemciler için zorunlu kıldı.
Kapsam ve Doğrulama Sınırları
Bu analiz IETF OAuth 2.1 taslak standardını ve RFC 7636 PKCE uzantısını referans alır. React SPA istemcileri, iOS/Android özel URI şemaları ve Node.js yetkilendirme sunucuları üzerindeki kriptografik doğrulama adımları doğrulanmıştır.
Genel İstemciler (Public Clients) ve Gizli Anahtar Çıkmazı
OAuth mimarisinde iki temel istemci türü tanımlanır:
- Gizli İstemciler (Confidential Clients): Güvenli bir sunucu ortamında çalışan (örneğin Node.js veya Go arka ucu) ve
client_secretparolasını dış dünyadan gizleyebilen sistemler. - Genel İstemciler (Public Clients): Kullanıcının cihazında çalışan React, Vue, iOS veya Android uygulamaları.
Genel istemcilerin kaynak koduna gömülen herhangi bir client_secret sırrı güvenli değildir. Bir saldırgan mobil uygulamanın APK dosyasını derleme geriye çevirme (reverse engineering) araçlarıyla açarak veya tarayıcı geliştirici araçlarından JavaScript belleğini okuyarak bu sırrı dakikalar içinde ele geçirebilir.
Bu nedenle genel istemcilerde istemci sırrı kullanılamaz.
Yetkilendirme Kodu Araya Girme Saldırısı
PKCE olmadan işletilen klasik Yetkilendirme Kodu akışında şu ölümcül açık oluşur:
MEŞRU UYGULAMA (com.ornek.app) SALDIRGAN UYGULAMA
| |
| 1. Yetkilendirme İsteği Başlatır |
v |
[ MOBİL İŞLETİM SİSTEMİ (Android / iOS) ] |
| |
v |
[ YETKİLENDİRME SUNUCUSU (IdP) ] |
| |
| 2. Kullanıcı Giriş Yapar, Kod Üretilir |
v |
[ Yönlendirme: com.ornek.app://oauth-callback?code=GIZLI123 ]
| |
+--- (Özel URI Şeması Çakışması!) ------------------>|
Saldırgan Kodu Çalar!
Sunucuya Gider ve Kodu
Erişim Token'ına Dönüştürür!
Mobil işletim sistemlerinde birden fazla uygulama aynı özel URI şemasına (com.ornek.app://) kaydolabilir. Yetkilendirme sunucusu onay kodunu döndürdüğünde kötü niyetli bir uygulama araya girerek kodu kapabilir. Genel istemcide client_secret olmadığı için hırsız bu kodla token uç noktasına gidip kullanıcının tüm yetkilerini devralabilir.
PKCE (RFC 7636) Mekanizması Nasıl Çalışır?
PKCE bu açığı dinamik, anlık ve kriptografik bir sır üreterek çözer. Her yetkilendirme isteği için özel bir anahtar çifti oluşturulur:
1. code_verifier Üretimi:
İstemci kriptografik olarak rastgele 43 ile 128 karakter uzunluğunda
güvenli bir dize üretir. (Örnek: aB3_x9K...L2m)
2. code_challenge Hesabı:
İstemci bu dizeyi SHA-256 algoritmasıyla özetler ve Base64-URL kodlar:
code_challenge = BASE64URL(SHA256(code_verifier))
Akış şu şekilde güvenli hale gelir:
İSTEMCİ YETKİLENDİRME SUNUCUSU
| |
| --- 1. /authorize?code_challenge=XYZ&method=S256 --> |
| (Yalnızca Özet Gönderilir, Verifier Gizli Kalır!)|
| |
| <--- 2. Yetkilendirme Kodu Döner (code=ABC) -------- |
| |
| --- 3. /token?code=ABC&code_verifier=aB3_x9K... ---> |
| (Şimdi Orijinal Açık Sır Gönderilir) |
| |
| [ Sunucu SHA256(code_verifier) == XYZ Doğrular! ]|
| |
| <--- 4. Erişim Belirteci (Access Token) Verilir ---- |
Saldırgan 2. adımdaki code=ABC kodunu araya girip çalsa bile, 3. adımda token alamaz. Çünkü istemcinin belleğinde tuttuğu orijinal code_verifier dizesini bilmemektedir. Sunucu özet eşleşmesini yapamayacağı için isteği anında reddeder.
OAuth 2.1 ile Gelen Temel Değişiklikler
OAuth 2.1 taslağı güvenlik standartlarını şu kurallarla sıkılaştırır:
- PKCE Zorunluluğu: PKCE artık yalnızca mobil uygulamalar için değil, hem genel (public) hem de gizli (confidential) tüm istemciler için zorunludur.
- Implicit Grant Kaldırıldı: Yanıtta doğrudan token dönen güvensiz akış tamamen yasaklandı.
- ROPC Kaldırıldı: Kullanıcı adı ve şifrenin doğrudan istemciye verilmesini sağlayan Resource Owner Password Credentials akışı kaldırıldı.
- Tam URL Eşleşmesi: Yönlendirme adreslerinde (redirect URI) joker karakter (
*) kullanımı yasaklandı, tam dize eşleşmesi zorunlu oldu.
Test Ortamı ve Doğrulama Yöntemi
Test senaryosunda sahte bir istemci tarafından çalınan yetki koduyla token alma denemesi yapılmıştır.
Gözlem:
code_verifierparametresi olmadan yapılan istekinvalid_granthatasıyla reddedilmiştir.- Rastgele üretilmiş hatalı bir verifier gönderildiğinde SHA-256 hash uyuşmazlığı nedeniyle sunucu işlemi durdurmuş ve şüpheli aktivite uyarısı üretmiştir.
Güvenlik Karşılaştırma Matrisi
| Akış Türü | İstemci Sırrı Güvenliği | Kod Çalınma Koruması | OAuth 2.1 Durumu |
|---|---|---|---|
| Implicit Grant | Güvensiz (Token URL'dedir) | Koruma Yok | YASAKLANDI |
| Düz Yetkilendirme Kodu | Genel istemcide tutulamaz | Zafiyet Var (URI dinleme) | YASAKLANDI |
| Yetkilendirme Kodu + PKCE | Sır gerekmez (Dinamik verifier) | Tam Korumalı (Kriptografik) | STANDART ZORUNLU |
Modern kimlik mimarilerinde güvenliği sağlamak için istemcinin sır saklayabileceği varsayımından vazgeçilmeli ve OAuth 2.1 yönergeleri uyarınca PKCE standardı eksiksiz uygulanmalıdır.
Yazıyı Değerlendir
0 tepkiFikirlerinizi tek tıkla paylaşarak geri bildirim bırakın.
Ali Purtaş
@alipurtas • Hey, This is Ali!
Kendi halinde yazılım geliştiren bir öğrenci. Sistemler kuruyor, deniyor, bozuyor ve öğrendiği gerçek çözümleri burada belgeliyor.
Konu Kümesi & Önerilen Yazılar
Redis Pub/Sub ile L1/L2 Çok Katmanlı Önbellek Geçersizleştirme Ağı
Süreç içi yerel RAM (L1) ile merkezi Redis (L2) katmanlarını senkron tutan Pub/Sub tabanlı geçersizleştirme ve istemci önbellekleme mimarisi.
Önbellek İzdihamı ve XFetch Probabilistik Erken Yenileme Algoritması
Önbellek izdihamı (cache stampede) krizlerini önleyen XFetch olasılıksal erken yenileme algoritması ve tekil uçuş (singleflight) desen analizi.
Write-Behind Önbellekleme ve Veritabanı Toplu Yazma Yükü Mimarisi
Write-behind önbellekleme ile yazma gecikmesini düşürme, toplu veritabanı yazımları, veri kaybı riskleri ve çöküş kurtarma mimari rehberi.
Tartışma & Yorumlar
0Tartışmaya katılmak ve soru sormak için oturum açmalısınız.
Giriş Yap