Entra ID Custom Authentication Extensions: Karmaşık AD FS Claim Kurallarını Buluta Taşıma Mimarisi
Yıllardır AD FS sunucularını ayakta tutan son karmaşık SQL/REST/LDAP talep (claim) dönüşümlerini `OnTokenIssuanceStart` Custom Authentication Extensions ve Managed Identity Azure Functions ile Entra ID’ye taşıma rehberi.
Pek çok kurum AD FS üzerindeki uygulamaların büyük bölümünü Entra ID’ye taşıdıktan sonra kalan küçük bir yüzde nedeniyle WAP ve AD FS sunucularını bir türlü kapatamadı. Bunun arkasındaki temel neden genellikle eski ERP, sağlık veya bankacılık uygulamalarıydı; çünkü bu sistemler oturum token'ı içine harici bir SQL veya Oracle tablosundan dinamik bayii kodu, sicil numarası ya da özel vergi bilgisi (Custom Attribute Store Claims) basıyordu. Microsoft Entra Custom Authentication Extensions (`OnTokenIssuanceStart`), Entra ID'nin token'ı imzalamasından milisaniyeler önce Azure Functions üzerindeki REST uç noktanızı çağırıp bu dinamik talepleri doğrudan SAML veya OIDC token'ına eklemesini sağlar.
Bu mekanizma, 2022’deki AD FS Enterprise App Göçü ve 2023’teki Federasyon Emekliliği projelerinde "harici veritabanından dinamik rol çektiği için taşınamıyor" denilen son uygulamaları da Entra ID’ye devreden tamamlayıcı adımdır.
Güven Sınırları ve Token Akışı İlkeleri
Harici veri kaynağını oturum açma akışına bağlarken performans ve kimlik güvenliği aynı anda korunmalıdır:
- Token Basımı Sırasında Dinamik Zenginleştirme:
TokenIssuanceStart Custom Claims Provider, SAML veya OIDC token'ı imzalanmadan hemen önce REST API’yi çağırır ve dönen JSON alanlarınıCustom Claimsolarak token'a yazar. - Temiz Dizin Şeması: Dış kaynaklardan gelen
partnerIdveyabranchRolesgibi dinamik rolleri Entra dizinine kalıcı uzantı olarak yazmaya gerek kalmaz; değerler anlık olarak enjekte edilir. - İmzalı Çağrı Doğrulaması: Entra ID ile Azure Function arasındaki iletişim paylaşılan zayıf bir API anahtarı yerine, Entra’nın
CustomExtension.Receive.Payloadkapsamlı imzalı JWT Bearer token'ı ile doğrulanır. - Kilitlenme Önlemi: Koşullu Erişim ve kimlik doğrulama gücü kuralları üretim öncesinde mutlaka
Report-Onlykipinde sınanmalı; iki bulut tabanlıBreak-Glasshesabı kapsam dışı bırakılarak yönetici kilitlenmesi önlenmelidir.
Ön Koşullar ve Performans Sınırları
- Lisanslama: Entra ID Premium P1 veya P2 (Microsoft 365 E3/E5) ya da Entra External ID kapsamı gerekir.
- Azure ve RBAC: Azure Functions, Application Insights ve Managed Identity barındırabilecek Azure aboneliği; Entra tarafında ise
Custom Authentication Extension AdministratorveApplication Administratorrolleri gereklidir. - 2000 ms Zaman Aşımı Sınırı:
OnTokenIssuanceStartçağrısı Entra tarafında sıkı 2 saniye zaman aşımına tabidir. Sunucusuz Consumption planındaki soğuk başlatma gecikmesi oturumu düşürebileceği içinPremium (EP1)veyaAlways Onaçık App Service Plan tercih edilmelidir.
PowerShell ile Uzantı ve Uygulama Denetimi
Aşağıdaki komutlar salt okunur denetim sınıfındadır (CustomAuthenticationExtension.Read.All ve Application.Read.All Graph kapsamlarıyla çalışır). Canlı yapılandırmayı değiştirmeden tanımlı uzantıları ve hedef uygulamanın Service Principal kaydını listeler.
# Salt okunur denetim: Custom Authentication Extensions listesini ve hedef uygulamayı incele
Connect-MgGraph -Scopes "CustomAuthenticationExtension.Read.All", "Application.Read.All"
Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/v1.0/identity/customAuthenticationExtensions" |
Select-Object -ExpandProperty value | Select-Object id, displayName, '@odata.type'
Get-MgServicePrincipal -Filter "displayName eq 'Legacy-ERP-SAML'" |
Select-Object Id, DisplayName, AppIdOturum Telemetrisi ve KQL Doğrulama Sorgusu
Üretimde Custom Authentication Extension çağrı hatalarını (1003018, 1003020 gibi hata kodlarını) ve token basım gecikmelerini izlemek için aşağıdaki telemetri toplama sorgusu kullanılabilir (Log Analytics Reader veya Security Reader yetkisi gerekir).
// Veri Kaynağı: Microsoft Entra ID Diagnostic Settings -> Log Analytics / Microsoft Sentinel (SigninLogs)
SigninLogs
| where TimeGenerated > ago(14d)
| where AuthenticationProcessingDetails has_any ("CustomAuthenticationExtension", "TokenIssuanceStart") or toint(Status.errorCode) in (1003018, 1003020)
| project TimeGenerated, UserPrincipalName, AppDisplayName, Status, AuthenticationProcessingDetails
| summarize Events = count() by AppDisplayName, tostring(Status.errorCode), tostring(Status.failureReason)
| order by Events descSaha Riskleri, Sınırlar ve Geri Dönüş Planı
En sık yapılan iki hata şunlardır: birincisi, sabah ilk girişte 3–5 saniye süren soğuk başlatma gecikmesi nedeniyle Consumption planında login hatalarına yol açmak; ikincisi ise uzantıyı tanımlayıp ilgili Enterprise App üzerinde Claims Mapping ve AcceptedMappedClaims ayarını açmayı unutmak.
- Azaltılan ve Azaltılamayan Riskler: Koşullu Erişim,
Authentication Strengthsve token bağlama kontrolleri parola püskürtme ve oturum çalma saldırılarını daraltır. Ancak Entra SSO arkasına alınmamış harici SaaS uygulamalarını veya yetkili oturum içindeki meşru kullanıcı suistimalini tek başına durdurmaz. - Bağımlılıklar ve Kesinti Riski: Yapı
Entra ID P1/P2lisanslamasına, cihaz uyumluluk sinyallerine ve düşük gecikmeli Azure Function uç noktasına bağımlıdır. Kapsam dışı hesap tanımlanmadan açılan sıkı engelleme kuralları yöneticileri kiracı dışına kilitleyebilir. - Geri Dönüş (Rollback) Planı: Yeni kurallar önce
Report-Only(enabledForReportingButNotEnforced) olarak test edilmeli ve ikiBreak-Glasshesabı kapsam dışı tutulmalıdır. Üretimde beklenmedik bir kesinti yaşanırsaBreak-Glassoturumu üzerinden ilgili politika derhalReport-Onlydurumuna çekilmelidir.
Doğrulanmış Birincil Kaynaklar & Açık Kaynak Depolar
Bu teknik rehber aşağıdaki resmi duyuru, Microsoft Learn belgeleri ve açık kaynak PowerShell / KQL depolarıyla doğrulanmıştır.
Çok Kanallı Yayın Özeti (X & LinkedIn Taslağı)
X (Twitter) ve LinkedIn paylaşım taslaklarını göster / gizle
Çok Kanallı Yayın Özeti (X & LinkedIn Taslağı)
X (Twitter) ve LinkedIn paylaşım taslaklarını göster / gizleSon karmaşık AD FS Claim kurallarını buluta taşıyan Entra ID Custom Authentication Extensions (OnTokenIssuanceStart) mimarisi yayında. #EntraID #ADFS #CustomClaims
AD FS Çiftliğini Tamamen Kapatmanın Son Kilidi: SQL/API kaynaklı özel talepleri 2000ms SLA içinde Azure Functions Premium ile Entra Token’larına enjekte etme rehberi.