← Tüm Yazılara Dön
Microsoft Azure

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.

·9 dk okuma·
#Custom Authentication Extensions#AD FS Migration#SAML Claims#Azure Functions#Entra ID#M365 E3
Entra ID Custom Authentication Extensions: Karmaşık AD FS Claim Kurallarını Buluta Taşıma Mimarisi

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 Claims olarak token'a yazar.
  • Temiz Dizin Şeması: Dış kaynaklardan gelen partnerId veya branchRoles gibi 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.Payload kapsamlı 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-Only kipinde sınanmalı; iki bulut tabanlı Break-Glass hesabı 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 Administrator ve Application Administrator rolleri 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çin Premium (EP1) veya Always On açı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.

powershell
# 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, AppId

Oturum 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).

kql
// 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 desc

Saha 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 Strengths ve 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/P2 lisanslaması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 iki Break-Glass hesabı kapsam dışı tutulmalıdır. Üretimde beklenmedik bir kesinti yaşanırsa Break-Glass oturumu üzerinden ilgili politika derhal Report-Only durumuna ç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
X (Twitter) Taslağı

Son karmaşık AD FS Claim kurallarını buluta taşıyan Entra ID Custom Authentication Extensions (OnTokenIssuanceStart) mimarisi yayında. #EntraID #ADFS #CustomClaims

LinkedIn Taslağı

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.