App Service veya Azure İşlevleri uygulamanızı Microsoft Entra oturum açma özelliğini kullanacak şekilde yapılandırma

Atlamak için başka bir kimlik doğrulama sağlayıcısı seçin.

Bu makalede, uygulamanızın kullanıcılarda kimlik doğrulama sağlayıcısı olarak Microsoft kimlik platformu (Microsoft Entra) ile oturum açması için Azure Uygulaması Hizmeti veya Azure İşlevleri için kimlik doğrulamasını nasıl yapılandırabileceğiniz gösterilir.

Uygulamanız ve kullanıcıları için bir kiracı seçin

Uygulamanızın kullanıcılarda oturum açabilmesi için önce iş gücüne veya dış kiracıya kaydetmeniz gerekir. Uygulamanızı çalışan veya iş konuklarının kullanımına sağlıyorsanız, uygulamanızı bir iş gücü kiracısına kaydedin. Uygulamanız tüketicilere ve iş müşterilerine yönelikse, uygulamayı bir dış kiracıya kaydedin.

1. Azure portalında oturum açın ve uygulamanıza gidin.

2. Uygulamanızın sol menüsünde Kimlik Doğrulama'yı ve ardından Kimlik sağlayıcısı ekle'yi seçin.

3. Kimlik sağlayıcısı ekle sayfasında, Microsoft ve Microsoft Entra kimliklerinde oturum açmak için Kimlik sağlayıcısı olarak Microsoft'u seçin.

4. Kiracı türü için çalışanlar ve iş konukları için İş gücü yapılandırması (geçerli kiracı) seçeneğini belirleyin veya tüketiciler ve iş müşterileri için dış yapılandırma'yı seçin.

Uygulama kaydını seçin

App Service Kimlik Doğrulaması özelliği sizin için otomatik olarak bir uygulama kaydı oluşturabilir veya sizin veya dizin yöneticisinin ayrı olarak oluşturduğu bir kaydı kullanabilirsiniz.

Ayrı olarak bir uygulama kaydı oluşturmanız gerekmediği sürece otomatik olarak yeni bir uygulama kaydı oluşturun. uygulama kaydını daha sonra isterseniz Microsoft Entra yönetim merkezinde özelleştirebilirsiniz.

Mevcut bir uygulama kaydını kullanmak için en yaygın durumlar aşağıdaki durumlardır:

• Hesabınızın Microsoft Entra kiracınızda uygulama kayıtları oluşturma izinleri yok.
• Uygulamanızın içinde olduğundan farklı bir Microsoft Entra kiracısından uygulama kaydı kullanmak istiyorsunuz.
• Yeni kayıt oluşturma seçeneği kamu bulutlarında kullanılamaz.

Ek denetimleri yapılandırma

Hangi isteklerin uygulamanıza erişmesine izin verileceğini belirleyen Ek denetimler yapılandırın. Bu davranışı şimdi özelleştirebilir veya daha sonra Kimlik doğrulama ayarları'nın yanındaki Düzenle'yi seçerek ana Kimlik Doğrulama ekranından bu ayarları değiştirebilirsiniz.

İstemci uygulaması gereksinimi için şunların yapılıp yapılmayacağını seçin:

• Yalnızca bu uygulamanın kendisinden gelen isteklere izin ver
• Belirli istemci uygulamalarından gelen isteklere izin ver
• Herhangi bir uygulamadan gelen isteklere izin ver (Önerilmez)

Kimlik gereksinimi için şunların yapılıp yapılmayacağını seçin:

• Herhangi bir kimlikten gelen isteklere izin ver
• Belirli kimliklerden gelen isteklere izin ver

Kiracı gereksinimi için şunların yapılıp yapılmayacağını seçin:

• Yalnızca veren kiracıdan gelen isteklere izin ver
• Belirli kiracılardan gelen isteklere izin ver
• Verene göre varsayılan kısıtlamaları kullanma

Uygulamanızın kodda ek yetkilendirme kararları almaya devam ediyor olması gerekebilir. Daha fazla bilgi için bkz . Yerleşik yetkilendirme ilkesi kullanma.

Kimlik doğrulaması ayarlarını yapılandırma

Bu seçenekler uygulamanızın kimliği doğrulanmamış isteklere nasıl yanıt vereceğini belirler ve varsayılan seçimler tüm istekleri bu yeni sağlayıcıyla oturum açmak üzere yeniden yönlendirir. Bu davranışı şimdi özelleştir seçeneğini değiştirebilir veya daha sonra Kimlik doğrulama ayarları'nın yanındaki Düzenle'yi seçerek bu ayarları ana Kimlik Doğrulama ekranından değiştirebilirsiniz. Bu seçenekler hakkında daha fazla bilgi edinmek için bkz . Kimlik doğrulama akışı.

Erişimi kısıtla için şunların yapılıp yapılmayeceğine karar verin:

• Kimlik doğrulaması gerektir
• Kimliği doğrulanmamış erişime izin ver

Kimliği Doğrulanmamış istekler için

• HTTP 302 Bulundu yeniden yönlendirme: web siteleri için önerilir
• HTTP 401 Yetkisiz: API'ler için önerilir
• HTTP 403 Yasak
• HTTP 404 Bulunamadı

Belirteç deposu (önerilir) öğesini seçin. Belirteç deposu, uygulamanız için belirteçleri toplar, depolar ve yeniler. Uygulamanızın belirteçlere ihtiyacı yoksa veya performansı iyileştirmeniz gerekiyorsa bunu daha sonra devre dışı bırakabilirsiniz.

Kimlik sağlayıcısını ekleme

İş gücü yapılandırmasını seçtiyseniz İleri: İzinler'i seçebilir ve uygulamanın ihtiyaç duyduğu Microsoft Graph izinlerini ekleyebilirsiniz. Bunlar uygulama kaydına eklenir, ancak bunları daha sonra da değiştirebilirsiniz. Dış yapılandırmayı seçtiyseniz, Microsoft Graph izinlerini daha sonra ekleyebilirsiniz.

Ekle'yi seçin.

Artık uygulamanızda kimlik doğrulaması için Microsoft kimlik platformu kullanmaya hazırsınız. Sağlayıcı, Kimlik Doğrulaması ekranında listelenir. Buradan bu sağlayıcı yapılandırmasını düzenleyebilir veya silebilirsiniz.

Azure Depolama ve Microsoft Graph'e erişen bir web uygulaması için Microsoft Entra oturum açma yapılandırması örneği için bu öğreticiye bakın.

İstekleri yetkilendirme

Varsayılan olarak, App Service Kimlik Doğrulaması yalnızca kimlik doğrulamasını işler ve çağıranın söyledikleri kişi olup olmadığını belirler. Çağıranın bir kaynağa erişimi olup olmadığını belirlemek, kimlik doğrulamasının ötesinde bir ek adımdır. Bu kavramlar hakkında daha fazla bilgi için Microsoft kimlik platformu yetkilendirme temel bilgilerine göz atın.

Uygulamanız kodda yetkilendirme kararları verebilir. App Service Kimlik Doğrulaması, yardımcı olabilecek bazı yerleşik denetimler sağlar, ancak bunlar uygulamanızın yetkilendirme gereksinimlerini karşılamak için tek başına yeterli olmayabilir.

Uygulama kodundan doğrulama gerçekleştirme

Uygulama kodunuzda yetkilendirme denetimleri gerçekleştirdiğinizde, App Service Kimlik Doğrulaması tarafından sağlanan talep bilgilerini kullanabilirsiniz. Eklenen x-ms-client-principal üst bilgi, çağıran hakkında iddia edilen talepleri içeren Base64 ile kodlanmış bir JSON nesnesi içerir. Varsayılan olarak, bu talepler bir talep eşlemesi üzerinden geçer, bu nedenle talep adları belirteçte gördüğünüz adlarla her zaman eşleşmeyebilir. Örneğin, tid talep bunun yerine ile http://schemas.microsoft.com/identity/claims/tenantid eşlenir.

Eklenen üst bilgiden x-ms-token-aad-access-token doğrudan temel erişim belirteci ile de çalışabilirsiniz.

Yerleşik yetkilendirme ilkesi kullanma

Oluşturulan uygulama kaydı, Microsoft Entra kiracınız için gelen isteklerin kimliğini doğrular. Varsayılan olarak, kiracı içindeki herkesin uygulamaya erişmesine de olanak tanır ve bu da birçok uygulama için uygundur. Ancak bazı uygulamaların yetkilendirme kararları alarak erişimi daha fazla kısıtlaması gerekir. Uygulama kodunuz genellikle özel yetkilendirme mantığını işlemek için en iyi yerdir. Ancak, yaygın senaryolar için Microsoft kimlik platformu erişimi sınırlamak için kullanabileceğiniz yerleşik denetimler sağlar.

Bu bölümde, App Service kimlik doğrulaması V2 API'sini kullanarak yerleşik denetimlerin nasıl etkinleştirileceği gösterilmektedir. Şu anda bu yerleşik denetimleri yapılandırmanın tek yolu Azure Resource Manager şablonları veya REST API'sini kullanmaktır.

API nesnesi içinde, Microsoft Entra kimlik sağlayıcısı yapılandırması aşağıdaki yapıda olduğu gibi bir nesne içerebilen bir defaultAuthorizationPolicy bölüme sahiptirvalidation:

{
    "validation": {
        "defaultAuthorizationPolicy": {
            "allowedApplications": [],
            "allowedPrincipals": {
                "identities": []
            }
        }
    }
}

Ayrıca, kullanılan API sürümünden bağımsız olarak bazı denetimler bir uygulama ayarı aracılığıyla yapılandırılabilir. Uygulama WEBSITE_AUTH_AAD_ALLOWED_TENANTS ayarı, talepte belirtildiği tid gibi, gelen belirtecin belirtilen kiracılardan birinden olmasını gerektirmek için en fazla 10 kiracı kimliği (örneğin, "aaaabbbb-0000-cccc-1111-dddd2222eeeee") virgülle ayrılmış bir listeyle yapılandırılabilir. Uygulama WEBSITE_AUTH_AAD_REQUIRE_CLIENT_SERVICE_PRINCIPAL ayarı, gelen belirtecin bir oid talep içermesini gerektirecek şekilde "true" veya "1" olarak yapılandırılabilir. Bu ayar yoksayılır ve yapılandırıldıysa allowedPrincipals.identities true olarak değerlendirilir (talep bu sağlanan kimlik listesinde denetlendiğinden oid ).

Bu yerleşik denetimlerde başarısız olan isteklere bir HTTP 403 Forbidden yanıtı verilir.

İstemci uygulamalarını App Service'inize erişecek şekilde yapılandırma

Önceki bölümlerde, kullanıcıların kimliğini doğrulamak için App Service veya Azure İşlevinizi kaydettiniz. Bu bölümde, N katmanlı mimaride olduğu gibi kullanıcılar veya kendileri adına App Service'iniz tarafından kullanıma sunulan API'lere erişim isteyebilmeleri için Microsoft Entra'da yerel istemcilerin veya daemon uygulamalarının nasıl kaydedildiği açıklanmaktadır. Yalnızca kullanıcıların kimliğini doğrulamak istiyorsanız bu bölümdeki adımları tamamlamanız gerekmez.

Yerel istemci uygulaması

Oturum açmış bir kullanıcı adına App Service uygulamanızın API'lerine erişim istemek için yerel istemcileri kaydedebilirsiniz.

1. Portal menüsünden Microsoft Entra'yı seçin.

2. Sol gezinti bölmesinden Uygulama kayıtları> Yeni kayıt'ı seçin.

3. Uygulama kaydetme sayfasında, uygulama kaydınız için bir Ad girin.

4. Yeniden yönlendirme URI'si bölümünde Genel istemci (mobil ve masaüstü) öğesini seçin ve URL'yi <app-url>/.auth/login/aad/callbackyazın. Örneğin, https://contoso.azurewebsites.net/.auth/login/aad/callback.

5. Kaydet'i seçin.

6. Uygulama kaydı oluşturulduktan sonra Uygulama (istemci) kimliği değerini kopyalayın.

   Not

   Bir Microsoft Store uygulaması için bunun yerine URI olarak SID paketini kullanın.

7. Sol gezinti bölmesinde API izinleri>İzin ekle>API'lerim'i seçin.

8. App Service uygulamanız için daha önce oluşturduğunuz uygulama kaydını seçin. Uygulama kaydını görmüyorsanız, uygulama kaydına user_impersonation kapsamını eklediğinizden emin olun.

9. Temsilci izinleri'nin altında user_impersonation'ı ve ardından İzin ekle'yi seçin.

App Service uygulamanıza bir kullanıcı adına erişim isteyebilen bir yerel istemci uygulaması yapılandırmış oldunuz.

Daemon istemci uygulaması (hizmet-hizmet çağrıları)

N katmanlı mimaride, istemci uygulamanız bir App Service veya İşlev uygulamasını istemci uygulamasının kendisi adına çağırmak için bir belirteç alabilir (kullanıcı adına değil). Bu senaryo, oturum açmış bir kullanıcı olmadan görevler gerçekleştiren etkileşimli olmayan daemon uygulamaları için kullanışlıdır. Standart OAuth 2.0 istemci kimlik bilgileri verme işlevini kullanır.

1. Portal menüsünden Microsoft Entra'yı seçin.
2. Sol gezinti bölmesinden Uygulama kayıtları> Yeni kayıt'ı seçin.
3. Uygulama kaydetme sayfasında, uygulama kaydınız için bir Ad girin.
4. Bir daemon uygulaması için Yeniden Yönlendirme URI'sine ihtiyacınız yoktur, bu nedenle bu uri'yi boş tutabilirsiniz.
5. Kaydet'i seçin.
6. Uygulama kaydı oluşturulduktan sonra Uygulama (istemci) kimliği değerini kopyalayın.
7. Sol gezinti bölmesinde Sertifikalar ve gizli diziler İstemci gizli>dizileri Yeni istemci gizli dizisi'ni> seçin.
8. Bir açıklama ve süre sonu girin ve Ekle'yi seçin.
9. Değer alanında istemci gizli anahtarı değerini kopyalayın. Bu sayfadan uzaklaştıktan sonra bir daha gösterilmez.

Şimdi parametresini hedef uygulamanın Uygulama Kimliği URI'sine ayarlayarak resource istemci kimliğini ve istemci gizli dizisini kullanarak erişim belirteci isteyebilirsiniz. Sonuçta elde edilen erişim belirteci standart OAuth 2.0 Yetkilendirme üst bilgisi kullanılarak hedef uygulamaya sunulabilir ve App Service kimlik doğrulaması, çağıranın (bu durumda kullanıcının değil, uygulamanın) kimliğinin doğrulandığını belirtmek için belirteci her zamanki gibi doğrular ve kullanır.

Şu anda bu, Microsoft Entra kiracınızdaki tüm istemci uygulamalarının erişim belirteci istemesine ve hedef uygulamada kimlik doğrulaması yapmasına olanak tanır. Yalnızca belirli istemci uygulamalarına izin vermek için yetkilendirmeyi zorlamak istiyorsanız, bazı ek yapılandırmalar gerçekleştirmeniz gerekir.

1. Korumak istediğiniz App Service veya İşlev uygulamasını temsil eden uygulama kaydının bildiriminde bir Uygulama Rolü tanımlayın.
2. Yetkilendirilmesi gereken istemciyi temsil eden uygulama kaydında API izinleri>İzin ekle>API'lerim'i seçin.
3. Daha önce oluşturduğunuz uygulama kaydını seçin. Uygulama kaydını görmüyorsanız bir Uygulama Rolü eklediğinizden emin olun.
4. Uygulama izinleri'nin altında, daha önce oluşturduğunuz Uygulama Rolünü seçin ve ardından İzin ekle'yi seçin.
5. İstemci uygulamasını izin isteme yetkisi vermek için Yönetici onayı ver'i seçtiğinizden emin olun.
6. Önceki senaryoya benzer şekilde (herhangi bir rol eklenmeden önce), artık aynı hedef resourceiçin bir erişim belirteci isteyebilirsiniz ve erişim belirteci, istemci uygulaması için yetkilendirilmiş Uygulama Rollerini içeren bir roles talep içerir.
7. Hedef App Service veya İşlev uygulama kodunda, artık beklenen rollerin belirteçte mevcut olduğunu doğrulayabilirsiniz (bu, App Service kimlik doğrulaması tarafından gerçekleştirilmez). Daha fazla bilgi için bkz . Access kullanıcı talepleri.

App Service uygulamanıza kendi kimliğini kullanarak erişebilen bir daemon istemci uygulaması yapılandırmış oldunuz.

En iyi yöntemler

Kimlik doğrulamasını ayarlamak için kullandığınız yapılandırmadan bağımsız olarak, aşağıdaki en iyi yöntemler kiracınızı ve uygulamalarınızı daha güvenli tutar:

• Her App Service uygulamasını Microsoft Entra'da kendi uygulama kaydıyla yapılandırın.
• Her App Service uygulamasına kendi izinlerini ve onayını verin.
• Ayrı dağıtım yuvaları için ayrı uygulama kayıtları kullanarak ortamlar arası izin paylaşımından kaçının. Yeni kodu test ederken bu uygulama, sorunların üretim uygulamasını etkilemesini önlemeye yardımcı olabilir.

Microsoft Graph'a geçiş

Bazı eski uygulamalar, kullanımdan kaldırılacak şekilde zamanlanan kullanımdan kaldırılmış Azure AD Graph bağımlılığıyla da ayarlanmış olabilir. Örneğin, uygulama kodunuz ara yazılım işlem hattındaki yetkilendirme filtresinin bir parçası olarak grup üyeliğini denetlemek için Azure AD Graph'ı çağırmış olabilir. Uygulamalar, Azure AD Graph kullanımdan kaldırma işleminin bir parçası olarak Microsoft Entra tarafından sağlanan yönergeleri izleyerek Microsoft Graph'a taşınmalıdır. Bu yönergeleri izleyerek App Service kimlik doğrulaması yapılandırmanızda bazı değişiklikler yapmanız gerekebilir. Uygulama kaydınıza Microsoft Graph izinleri ekledikten sonra şunları yapabilirsiniz:

1. Henüz yapmadıysanız Veren URL'sini "/v2.0" sonekini içerecek şekilde güncelleştirin.

2. Oturum açma yapılandırmanızdan Azure AD Graph izinleri isteklerini kaldırın. Değiştirebileceğiniz özellikler, kullandığınız yönetim API'sinin sürümüne bağlıdır:

   • V1 API' sini ()/authsettings kullanıyorsanız, bu dizide additionalLoginParams yer alır.
   • V2 API' sini ()/authsettingsV2 kullanıyorsanız, bu dizide loginParameters yer alır.

   ";, örneğin, tüm başvurularınıhttps://graph.windows.net" kaldırmanız gerekir. Bu parametreyi resource ("/v2.0" uç noktası tarafından desteklenmeyen) veya Azure AD Graph'ten özel olarak istediğiniz kapsamları içerir.

   Ayrıca, uygulama kaydı için ayarladığınız yeni Microsoft Graph izinlerini istemek için yapılandırmayı güncelleştirmeniz gerekir. Bu kurulumu birçok durumda basitleştirmek için .default kapsamını kullanabilirsiniz. Bunu yapmak için yeni bir oturum açma parametresi scope=openid profile email https://graph.microsoft.com/.defaultekleyin.

Bu değişikliklerle, App Service Kimlik Doğrulaması oturum açmayı denediğinde artık Azure AD Graph için izin istemeyecek ve bunun yerine Microsoft Graph için bir belirteç alacaktır. Microsoft Entra tarafından sağlanan yönergelere göre, uygulama kodunuzdan bu belirteci her türlü kullanımın da güncelleştirilmiş olması gerekir.

Sonraki adımlar

• App Service Kimlik Doğrulamasına / Yetkilendirmeye genel bakış.
• Öğretici: Azure Uygulaması Hizmetinde uçtan uca kullanıcıların kimliğini doğrulama ve yetkilendirme

• Öğretici: Azure Depolama ve Microsoft Graph'a erişen bir web uygulamasında kullanıcıların kimliğini doğrulama ve yetkilendirme
• Öğretici: Azure Uygulaması Hizmetinde uçtan uca kullanıcıların kimliğini doğrulama ve yetkilendirme