IAli
Tüm Yazılar
OAuth 2.1 Standardında PKCE ile Yetkilendirme Kodu Akışı Koruması

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:

  1. Gizli İstemciler (Confidential Clients): Güvenli bir sunucu ortamında çalışan (örneğin Node.js veya Go arka ucu) ve client_secret parolasını dış dünyadan gizleyebilen sistemler.
  2. 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:

TEXT
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:

TEXT
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:

TEXT
İ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_verifier parametresi olmadan yapılan istek invalid_grant hatası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 tepki

Fikirlerinizi tek tıkla paylaşarak geri bildirim bırakın.

Bu teknik notu çevrenizle paylaşın

Ali Purtaş

@alipurtas • Hey, This is Ali!

İletişime Geç

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

İç Bağlantılı Mimari
Yorumlar yükleniyor...