Aracılığıyla paylaş

Kimlik doğrulaması ve yetkilendirme için Microsoft kimlik platformu kod örnekleri

Bu kod örnekleri, Microsoft kimlik platformu kimlik doğrulama kitaplıklarımızın kullanımını göstermek için Microsoft tarafından derlenir ve korunur. Yaygın kimlik doğrulama ve yetkilendirme senaryoları çeşitli uygulama türlerinde, geliştirme dillerinde ve çerçevelerde uygulanır.

  • Kullanıcıları web uygulamalarında oturum açın ve korumalı web API'lerine yetkili erişim sağlayın.
  • API işlemlerini gerçekleştirmek için erişim belirteci gerektirerek bir web API'sini koruyun.

Her kod örneği, projenin nasıl derlenip (varsa) örnek uygulamayı çalıştırmayı açıklayan bir README.md dosyası içerir. Koddaki açıklamalar, kimlik platformunu kullanarak kimlik doğrulaması ve yetkilendirme gerçekleştirmek için bu kitaplıkların uygulamada nasıl kullanıldığını anlamanıza yardımcı olur.

Örnekler ve kılavuzlar

Örnekleri uygulama türüne veya tercih ettiğiniz dile/çerçeveye göre sıralamak için sekmeleri kullanın.

Tek sayfalı uygulamalar

Bu örnekler, Microsoft kimlik platformu ile güvenli hale getirilen tek sayfalı bir uygulamanın nasıl yazılacağını gösterir. Bu örnekler MSAL.js çeşitlerinden birini kullanır.

Dil/
Platforma		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama süreci Hızlı Başlangıç Kılavuz
Tepki • Oturum açma kullanıcıları MSAL Tepki PKCE ile yetkilendirme kodu Hızlı Başlangıç Eğitim
Açısal • Oturum açma kullanıcıları MSAL Açısal PKCE ile yetkilendirme kodu Hızlı Başlangıç Eğitim
JavaScript • Oturum açma kullanıcıları
• Microsoft Graph'ı arayın
• Node.js web API'lerini çağırma
• Azure Depolama ve App Service'e dağıtma		 MSAL.js PKCE ile yetkilendirme kodu Hızlı Başlangıç
Blazor WebAssembly • Oturum açma kullanıcıları
• Microsoft Graph'ı arayın
• Azure Uygulaması Hizmetine dağıtma		 MSAL.js PKCE ile yetkilendirme kodu Hızlı Başlangıç

Web uygulamaları

Aşağıdaki örneklerde, kullanıcılarda oturum açabilen web uygulamaları gösterilmektedir. Bazı örnekler, Microsoft Graph'ı çağıran uygulamayı veya kullanıcının kimliğiyle kendi web API'nizi de gösterir.

Dil / Platform GitHub'da kod örnekleri Kimlik doğrulama ve yetkilendirme kitaplıkları Kimlik doğrulama süreci Hızlı Başlangıç Kılavuz
ASP.NET • Microsoft Graph Eğitim Örneği
• Kullanıcı hesaplarında oturum açın ve yönetici kısıtlı kapsamıyla Microsoft Graph'ı çağırın		 • MSAL.NET
• Microsoft.Identity.Web
• Gelişmiş Belirteç Önbelleği Senaryoları		 • OpenID bağlantısı
• Yetkilendirme kodu
• Biri Adına (OBO)		 Hızlı Başlangıç
ASP.NET Çekirdeği • Oturum açma kullanıcıları
• Microsoft Graph'ı arayın
• Belirteç önbelleğini özelleştirme
• Adım adım kimlik doğrulaması gerçekleştirmek için Koşullu Erişim kimlik doğrulaması bağlamını kullanın
• Çağrı Grafiği (çok kiracılı)
• Azure REST API'lerini çağırma
• Web API'lerini koruma
• Çok kiracılı web API'lerini koruma
• Erişim denetimi için Uygulama Rollerini kullanma
• Erişim denetimi için Güvenlik Gruplarını kullanma
• Azure Depolama ve App Service'e dağıtma
• Active Directory Federasyon Hizmetlerinden Microsoft Entra'ya geçiş		 Microsoft.Identity.Web • OpenID bağlantısı
• Yetkilendirme kodu
• Adına İşlem Akışı (OBO)		 Hızlı Başlangıç Eğitim
Blazor • Oturum açma kullanıcıları
• Microsoft Graph'ı arayın
• Web API'lerini çağırma		 MSAL.NET Karma akış
Java Spring • Oturum açma kullanıcıları
• Microsoft Graph'ı arayın
• Erişim denetimi için Uygulama Rollerini kullanma
• Erişim denetimi için Grupları kullanma
• Web API'lerini koruma
• Azure Uygulaması Hizmetine dağıtma		 MSAL Java Yetki kodu Eğitim
Java Servlet’leri • Oturum açma kullanıcıları
• Microsoft Graph'ı arayın
• Erişim denetimi için Uygulama Rollerini kullanma
• Erişim denetimi için Güvenlik Gruplarını kullanma
• Azure Uygulaması Hizmetine dağıtma		 MSAL Java Yetki kodu Hızlı Başlangıç
Node.js Ekspres • Oturum açma kullanıcıları
• MSAL Node ve Microsoft kimlik platformu ile oluşturulmuş hızlı web uygulaması
• Microsoft Graph'ı arayın
• BFF ara sunucusu aracılığıyla Microsoft Graph'ı arayın
• Erişim denetimi için Uygulama Rollerini kullanma
• Erişim denetimi için Güvenlik Gruplarını kullanma
• Azure Uygulaması Hizmetine dağıtma		 MSAL Düğümü • Yetkilendirme kodu
• Arka Uçtan Ön Uca (BFF) ara sunucusu		 Hızlı Başlangıç Eğitim
"Python Flask (Python için bir mikro web çerçevesi)" • Oturum açma kullanıcıları
• Microsoft Entra Kimliği'nde oturum açmak ve isteğe bağlı olarak bir aşağı akış API'si (Microsoft Graph) çağırmak için şablon		 MSAL Python Yetki kodu Hızlı Başlangıç Eğitim
Python Django • Oturum açma kullanıcıları MSAL Python Yetki kodu
Ruby programlama dili • Kullanıcı oturum aç ve Microsoft Graph'ı çağırın OmniAuth OAuth2 Yetki kodu

Web API'si

Aşağıdaki örneklerde, Microsoft kimlik platformu ile bir web API'sini koruma ve web API'sinden aşağı akış API'sini çağırma gösterilmektedir.

Dil/
Platforma		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama süreci Hızlı Başlangıç Kılavuz
ASP.NET • Microsoft Graph'ı arayın MSAL.NET Birisi Adına (OBO) Hızlı Başlangıç
ASP.NET Çekirdeği • Microsoft kimlik platformu ile erişim denetimi (korumalı yollar) MSAL.NET Birisi Adına (OBO) Hızlı Başlangıç Eğitim
Java • Java Spring Boot web API'nizi Microsoft kimlik platformu ile koruyun MSAL Java Birisi Adına (OBO)
Node.js • Node.js web API'lerini koruma MSAL Düğümü Yetkilendirme taşıyıcısı

Masaüstü

Aşağıdaki örneklerde, Microsoft Graph API'sine veya kullanıcı adına kendi web API'nize erişen genel istemci masaüstü uygulamaları gösterilmektedir. Web Authentication Manager (WAM) ile Masaüstü (Konsol) örneği dışında, tüm bu istemci uygulamaları Microsoft Kimlik Doğrulama Kitaplığı'nı (MSAL) kullanır.

Dil/
Platforma		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama süreci Hızlı Başlangıç Kılavuz
.NET Çekirdeği • Microsoft Graph'ı arayın
• Belirteç önbelleği ile Microsoft Graph'ı çağırma
• Özel web kullanıcı arabirimi HTML'i ile Microsoft Graph'ı çağırma
• Özel web tarayıcısı ile Microsoft Graph'ı arayın
• Cihaz kodu akışıyla kullanıcı oturum açma
• Kullanıcı adı/parola ile oturum açarak Microsoft Graph'a bağlanın		 MSAL.NET • PKCE ile yetkilendirme kodu
• Cihaz kodu
• Kaynak sahibi parola kimlik bilgileri
Java • Microsoft Graph'ı arayın MSAL Java Tümleşik Windows kimlik doğrulaması
Node.js • Oturum açma kullanıcıları MSAL Düğümü PKCE ile yetkilendirme kodu Hızlı Başlangıç Eğitim
Piton • Oturum açma kullanıcıları MSAL Python Kaynak sahibinin parola kimlik bilgileri
Windows Presentation Foundation (WPF) • Kullanıcı oturum aç ve Microsoft Graph'ı çağırın
• Windows Presentation Foundation (WPF) kullanıcı oturum açma, korumalı web API'si erişimi (Microsoft Graph)
• Kullanıcıları oturum açma ve ASP.NET Core web API'lerini çağırma
• Kullanıcı oturum aç ve Microsoft Graph'ı çağırın		 MSAL.NET PKCE ile yetkilendirme kodu Hızlı Başlangıç Eğitim

Mobil

Aşağıdaki örneklerde Microsoft Graph API'sine erişen genel istemci mobil uygulamaları gösterilmektedir. Bu istemci uygulamaları Microsoft Kimlik Doğrulama Kitaplığı'nı (MSAL) kullanır.

Dil/
Platforma		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama süreci Hızlı Başlangıç Kılavuz
.NET Çekirdeği • MAUI kullanarak Microsoft Graph'ı arayın
• Komisyoncu ile MAUI kullanarak Microsoft Graph'ı çağırın		 MSAL.NET PKCE ile yetkilendirme kodu
Ios • Microsoft Graph'ı yerel olarak çağır MSAL iOS PKCE ile yetkilendirme kodu Hızlı Başlangıç Eğitim
Java • Kullanıcı oturum aç ve Microsoft Graph'ı çağırın MSAL Android PKCE ile yetkilendirme kodu Hızlı Başlangıç Eğitim
Kotlin Belediyesi • Kullanıcı oturum aç ve Microsoft Graph'ı çağırın MSAL Android PKCE ile yetkilendirme kodu

Hizmet / daemon (arka planda çalışan)

Aşağıdaki örneklerde, Microsoft Graph API'sine kendi kimliğiyle (kullanıcı olmadan) erişen bir uygulama gösterilmektedir.

Dil/
Platforma		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama süreci Hızlı Başlangıç Kılavuz
.NET • Korumalı web API'lerine erişen .NET konsol uygulaması
• Microsoft kimlik platformu uç noktasını kullanan çok kiracılı yapı		 MSAL.NET İstemci kimlik bilgileri verme Hızlı Başlangıç Eğitim
.NET Çekirdeği • Microsoft Graph'ı arayın
• Web API'lerini çağırma
• MSGraph'ı çağırmak için yönetilen kimlik kullanma
• API çağırmak için yönetilen kimlik kullanma
• API'yi çağıran çalışan rolü		 Microsoft.Identity.Web İstemci kimlik bilgileri verme
Java • Gizli Anahtar ile Microsoft Graph'ı çağırın
• Sertifika ile Microsoft Graph'ı arayın		 MSAL Java İstemci kimlik bilgileri verme Hızlı Başlangıç
Node.js • Microsoft Graph'ı gizli anahtarla çağırma MSAL Düğümü İstemci kimlik bilgileri verme Hızlı Başlangıç Eğitim
Piton • Microsoft Graph'ı gizli anahtarla çağırma
• Sertifikayla Microsoft Graph'ı arayın		 MSAL Python İstemci kimlik bilgileri verme Hızlı Başlangıç

Tarayıcısız (Arayüzsüz)

Aşağıdaki örnekte, web tarayıcısı olmayan bir cihazda çalışan bir genel istemci uygulaması gösterilmektedir. Uygulama bir komut satırı aracı, Linux veya Mac üzerinde çalışan bir uygulama veya bir IoT uygulaması olabilir. Örnekte, başka bir cihazda (cep telefonu gibi) etkileşimli olarak oturum açan bir kullanıcı adına Microsoft Graph API'sine erişen bir uygulama bulunur. Bu istemci uygulaması Microsoft Kimlik Doğrulama Kitaplığı'nı (MSAL) kullanır.

Dil/
Platforma		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama süreci Hızlı Başlangıç Kılavuz
.NET Çekirdeği • Korumalı API'leri yalnızca metin aygıtından çağırma MSAL.NET Cihaz kodu
Java • Kullanıcılar için oturum açın ve yalnızca metinle çalışan bir cihazdan korumalı API'yi çağırın MSAL Java Cihaz kodu
Piton • Microsoft Graph'ı arayın MSAL Python Cihaz kodu

Web API'leri olarak Azure İşlevleri

Aşağıdaki örneklerde HttpTrigger kullanarak Azure İşlevi'nin nasıl korunup Microsoft kimlik platformu ile bir web API'sinin kullanıma sunılması ve web API'sinden aşağı akış API'sinin nasıl çağrılmaya çalışılması gösterilmektedir.

Dil/
Platforma		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama süreci Hızlı Başlangıç Kılavuz
Piton • Microsoft Entra Id ile güvenliği sağlanan Python Azure işlevi web API'si MSAL Python Yetki kodu

Microsoft Teams uygulamaları

Aşağıdaki örnekte, kullanıcıların oturum açtığı Microsoft Teams Sekme uygulaması gösterilmektedir. Buna ek olarak, Microsoft Kimlik Doğrulama Kitaplığı 'nı (MSAL) kullanarak kullanıcının kimliğiyle Microsoft Graph API'sini çağırmayı gösterir.

Dil/
Platforma		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama süreci Hızlı Başlangıç Kılavuz
Node.js • Teams Sekme uygulaması: çoklu oturum açma (SSO) ve Microsoft Graph'ı çağırma MSAL Düğümü Birisi Adına (OBO)

Çok Kiracılı SaaS

Uygulamanızın herhangi bir Microsoft Entra kiracısından oturum açmaları kabul edecek şekilde nasıl yapılandırılacağını aşağıdaki örnekler göstermektedir. Uygulamanızı çok kiracılı olacak şekilde yapılandırmak, birçok kuruluşa bir Hizmet Olarak Yazılım (SaaS) uygulaması sunabileceğiniz ve kullanıcılarının onay verdikten sonra uygulamanızda oturum açabilmesine olanak tanıyabileceğiniz anlamına gelir.

Dil/
Platforma		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama süreci Hızlı Başlangıç Kılavuz
ASP.NET Çekirdeği • ASP.NET Core MVC web uygulaması Microsoft Graph API'sini çağırır
• ASP.NET Core MVC web uygulaması, ASP.NET Core web API'sini çağırır		 MSAL.NET • OpenID bağlantısı
• Yetkilendirme kodu

İlgili içerik

Daha fazla örnek koda daha ayrıntılı bir şekilde göz atmak isterseniz bkz: