OAuth Uygulamalarında Çoklu Redirect URI ve Token Yenileme

GitHub, OAuth uygulamalarında kısa ömürlü erişim tokenları için refresh token desteği, en fazla 10 redirect URI tanımı ve wildcard eşleşmesini opsiyonel hale getiren güncellemeler yayınladı. GHES 3.23’te de geçerli.

GitHub, OAuth uygulamaları ve GitHub App platformlarında güvenliği artırmayı hedefleyen bir dizi güncelleme yayımladı. Değişiklikler OAuth uygulamalarına süresi dolan erişim tokenları ile yenileme (refresh) tokenı kullanma imkanı tanıyor, birden fazla redirect URI kaydına olanak veriyor ve redirect URI’ler için joker (wildcard) eşleşmesini opsiyonel hale getiriyor. Aşağıda her başlığın kaynaktaki bilgilere göre ne anlama geldiğini ve geliştirici tarafında nasıl uygulandığını özetliyorum.

OAuth uygulamaları için dönen (rotating) tokenlar

OAuth uygulamaları artık kullanıcı kimlik doğrulama akışı sırasında kısa ömürlü token talep edebiliyor. Uygulama bu davranışa dahil olduğunda sekiz saat geçerli bir erişim tokenı ve altı ay geçerli bir yenileme tokenı elde ediyor. Erişim tokenının süresi dolduğunda uygulama, yenileme tokenını kullanarak yeni bir token çifti alıyor.

Geliştiriciler yenileme tokenı desteğini uygulamaya iki farklı şekilde ekleyebilir:

  • Kimlik doğrulama isteğine offline_access kapsamını (scope) eklemek. Bu yöntem kısa ömürlü token akışını tetikliyor ve GitHub’ın belirttiği üzere değişikliği test edip aşamalı olarak devreye almanın önerilen yolu.
  • Uygulama kaydında her zaman kısa ömürlü token kullanılacak şekilde ayar yapmak. Bu seçenek, güncellenmemiş eski istemcileri güncellemeye zorlamak ve tüm istemcilerin kısa ömürlü token almasını garantiye almak için tercih edilebilir.

Kısa ömürlü tokenlar, yeni oluşturulan tüm uygulamalarda varsayılan olarak etkin geliyor. Kullandığınız kimlik doğrulama SDK’sı yenileme tokenı akışını henüz desteklemiyorsa SDK’yı güncellerken bu özelliği geçici olarak devre dışı bırakabilirsiniz.

Bir OAuth uygulamasında birden fazla redirect URI

Bir diğer önemli yenilik, OAuth uygulamalarına en fazla 10 redirect URI (GitHub arayüzünde “callback URI” olarak geçiyor) tanımlama imkanı vermesi. Böylece birden fazla ortam, alan adı veya dağıtım konfigürasyonu, ayrı uygulamalar oluşturmaya gerek kalmadan aynı OAuth uygulaması altında desteklenebiliyor.

Geliştiriciler, uygulama ayarlarında yeni eklenen Add redirect URI düğmesiyle eşleşmede kullanılacak ek URL’leri tanımlayabilir.

Redirect URI’ler için wildcard eşleşmesi

OAuth uygulamaları ve GitHub App’ler, yapılandırılmış her redirect URI için ayrı ayrı wildcard eşleşmesini etkinleştirebiliyor. Bu, örneğin bir uygulamanın kiracı bazlı (tenanted) alt alan adları gibi birden fazla ilgili site için her kiracıya özel redirect URI kaydetmeden yönlendirme yapabilmesine olanak tanıyor.

Wildcard eşleşmesi etkinleştirildiğinde yetkilendirme kodunun (ve kullanıcının), redirect URI’nin bir alt alan adına ya da ek bir yoluna uyan herhangi bir URL’ye GitHub tarafından gönderilmesine izin veriliyor.

Yönlendirilen site kendi rotaları üzerinde güçlü bir kontrole sahip değilse (örneğin kullanıcı içeriği barındırıyorsa) wildcard eşleşmesi kötüye kullanılabilir. GitHub, bu özelliği açmadan önce uygulama mimarisinin gözden geçirilmesini öneriyor.

Yalnızca tek bir redirect URI’ye sahip uygulamalarda wildcard eşleşmesi zaten etkin durumda. Bu GitHub’ın eski (legacy) davranışıydı; artık görünür ve kontrol edilebilir hale geldi. GitHub, mevcut uygulamaların gözden geçirilmesini ve ihtiyaç yoksa wildcard eşleşmesinin devre dışı bırakılmasını tavsiye ediyor. Bu, tüm OAuth uygulamalarını ve tek bir redirect URI kayıtlı olan GitHub App’leri kapsıyor.

GitHub Enterprise Server tarafı

Değişikliklerin tamamının GitHub Enterprise Server 3.23 sürümünde de yer alacağı belirtiliyor. Böylece self-hosted GHES kullanan kurumlar da aynı token yenileme ve redirect URI iyileştirmelerinden yararlanabilecek.

Geliştiricilerin dikkat etmesi gerekenler

  • Kimlik doğrulama SDK’nızın yenileme tokenı akışını destekleyip desteklemediğini kontrol edin; desteklemiyorsa güncelleme planı yaparken kısa ömürlü tokenları geçici olarak kapatmayı değerlendirin.
  • Kısa ömürlü token akışını önce offline_access kapsamıyla test edip aşamalı yaymak, uygulama kaydında zorunlu hale getirmeden önce daha güvenli bir geçiş sağlar.
  • Tek redirect URI’li uygulamalarda geçmişten gelen wildcard davranışının hala açık olabileceğini unutmayın; gerçekten gerekmiyorsa kapatın.
  • Wildcard etkinleştirmeden önce hedef alan adının rota kontrolünü ve kullanıcı içeriği barındırıp barındırmadığını değerlendirin.

Token yaşam döngüsü ve OAuth güvenliği konularını daha geniş bir çerçevede ele almak isteyenler, kimlik doğrulama tokenlarının veri sözleşmesi olarak kullanılmaması gerektiğine dair daha önceki değerlendirmeye de göz atabilir.

Kaynaklar ve İleri Okuma

Bu yazı yapay zeka (büyük dil modelleri) ile hazırlanmış, insan editör tarafından incelenmiştir. İçerik üretim sürecimiz.
Aşkın KILIÇ

20+ yıl deneyimli Azure Solutions Architect. Microsoft sertifikalı bulut mimari ve DevOps danışmanı. Azure, yapay zekâ ve bulut teknolojileri üzerine Türkçe teknik içerikler üretiyor.

AZ-305AZ-104AZ-500AZ-400DP-203AI-102

Bu içerik işinize yaradı mı?

Benzer içerikleri kaçırmamak için YouTube ve GitHub hesaplarımı takip edin.

Haftalık Bülten

Her pazar özenle seçilmiş teknoloji yazıları doğrudan e-postanıza gelsin.

Kurumsal DevOps ve bulut dönüşümü danışmanlığı: Danışmanlık Hizmetleri

3 Yorum

  1. Refresh token desteği uzun zamandır beklenen bir şeydi, özellikle uzun süreli oturumları yönetirken her seferinde kullanıcıyı yeniden authenticate etmek zorunda kalmak can sıkıcıydı. 10 redirect URI limiti biraz kısıtlayıcı gelebilir ama çoğu uygulama için yeterli sanırım, siz ne düşünüyorsunuz?

  2. Refresh token desteği epey geç geldi açıkçası, birçok uygulamada token süresi dolunca kullanıcıyı yeniden login’e göndermek zorunda kalıyorduk. 10 redirect URI limiti de makul, ama büyük kurumsal uygulamalarda dar gelebilir mi acaba?

  3. Refresh token desteği çok geç geldi açıkçası, özellikle uzun süreli oturum gerektiren uygulamalarda token süresi dolunca kullanıcıyı tekrar login’e göndermek can sıkıcıydı. 10 redirect URI sınırı biraz kısıtlayıcı gelebilir, staging ve production ortamlarını ayırınca hızla dolabiliyor bu limit.

Yoruma kapalı.

✉

Haftalık Bülten

Azure, DevOps ve Yapay Zeka dünyasındaki en güncel içerikleri her hafta doğrudan e-postanıza alın.

Spam yok. İstediğiniz zaman iptal edebilirsiniz.
📱
Uygulamayı Yükle Ana ekrana ekle, çevrimdışı oku
Kategoriler
Ara
Paylaş
WhatsApp
İçindekiler
← Visual Studio 18.9 ile Git Sub...
Ajan Ekonomisi: Pilotlardan Öl... →
📩

Gitmeden önce!

Her pazar özenle seçilmiş teknoloji yazıları ve AI haberleri doğrudan e-postanıza gelsin. Ücretsiz, spam yok.

🔒 Bilgileriniz güvende. İstediğiniz zaman ayrılabilirsiniz.

📬 Haftalık bülten: Teknoloji + AI haberleri
Beni Takip Et Yeni Azure / AI / DevOps yazılarını GitHub ve RSS üzerinden takip edin.