kod örneklerini Microsoft kimlik platformu

  • Makale

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ılıp yazılmayeceğini gösterir. Bu örnekler MSAL.js çeşitlerinden birini kullanır.

Dil/
Platform		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama akışı Hızlı Başlangıç Öğretici
React • Oturum açma kullanıcıları MSAL React PKCE ile yetkilendirme kodu Hızlı Başlangıç Öğretici
Angular • Oturum açma kullanıcıları MSAL Angular PKCE ile yetkilendirme kodu Hızlı Başlangıç Öğretici
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 kitaplıkları Kimlik doğrulama akışı Hızlı Başlangıç Öğretici
ASP.NET • Microsoft Graph Eğitim Örneği
• Kullanıcılarda oturum açın ve yönetici kısıtlı kapsamıyla Microsoft Graph'ı arayın		 • MSAL.NET
• Microsoft.Identity.Web
• Gelişmiş Belirteç Önbelleği Senaryoları		 • OpenID bağlantısı
• Yetkilendirme kodu
• Adına (OBO)		 Hızlı Başlangıç
ASP.NET Core • 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ı Grafı (ç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
• Microsoft Entra geçişi Active Directory Federasyon Hizmetleri (AD FS)		 Microsoft.Identity.Web • OpenID bağlantısı
• Yetkilendirme kodu
• Adına Akış (OBO)		 Hızlı Başlangıç Öğretici
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 Öğretici
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 Express • 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
• Ön Uç için Arka Uç (BFF) ara sunucusu		 Hızlı Başlangıç Öğretici
Python Flask • 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
• Azure Uygulaması Hizmetine dağıtma		 MSAL Python Yetki kodu Hızlı Başlangıç Öğretici
Python Django • Oturum açma kullanıcıları MSAL Python Yetki kodu
Ruby • Kullanıcıları oturum açın ve Microsoft Graph'ı arayı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/
Platform		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama akışı Hızlı Başlangıç Öğretici
ASP.NET • Microsoft Graph'ı arayın MSAL.NET Adına (OBO) Hızlı Başlangıç
ASP.NET Core • Microsoft kimlik platformu ile erişim denetimi (korumalı yollar) MSAL.NET Adına (OBO) Hızlı Başlangıç Öğretici
Java • Java Spring Boot web API'nizi Microsoft kimlik platformu ile koruyun MSAL Java 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/
Platform		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama akışı Hızlı Başlangıç Öğretici
.NET Core • 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ılara oturum açma
• Kullanıcı adı/parola kullanarak kullanıcılarda oturum açarak Microsoft Graph'ı arayın
• WinUI masaüstü uygulamasında MSAL.NET ile kullanıcıların kimliğini doğrulama		 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ıç Öğretici
Python • Oturum açma kullanıcıları MSAL Python Kaynak sahibinin parola kimlik bilgileri
Windows Presentation Foundation (WPF) • Kullanıcıları oturum açın ve Microsoft Graph'ı arayı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ıları oturum açın ve Microsoft Graph'ı arayın		 MSAL.NET PKCE ile yetkilendirme kodu Hızlı Başlangıç Öğretici

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/
Platform		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama akışı Hızlı Başlangıç Öğretici
.NET Core • MAUI kullanarak Microsoft Graph'ı arayın
• Aracı ile MAUI kullanarak Microsoft Graph'ı arayın		 MSAL.NET PKCE ile yetkilendirme kodu
iOS • Microsoft Graph'ı yerel olarak çağır MSAL iOS PKCE ile yetkilendirme kodu Hızlı Başlangıç Öğretici
Java • Kullanıcıları oturum açın ve Microsoft Graph'ı arayın MSAL Android PKCE ile yetkilendirme kodu Hızlı Başlangıç Öğretici
Kotlin • Kullanıcıları oturum açın ve Microsoft Graph'ı arayın MSAL Android PKCE ile yetkilendirme kodu
Xamarin • Kullanıcıları oturum açın ve Microsoft Graph'ı arayın
• Aracı ile kullanıcılarla oturum açın ve Microsoft Graph'ı arayın		 MSAL.NET PKCE ile yetkilendirme kodu

Hizmet / daemon

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

Dil/
Platform		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama akışı Hızlı Başlangıç Öğretici
.NET • Korumalı web API'lerine erişen .NET konsol uygulaması
• Microsoft kimlik platformu uç noktası olan çok kiracılı		 MSAL.NET İstemci kimlik bilgileri verme Hızlı Başlangıç Öğretici
.NET Core • 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 Dizi ile Microsoft Graph'ı arayın
• Sertifika ile Microsoft Graph'ı arayın		 MSAL Java İstemci kimlik bilgileri verme Hızlı Başlangıç
Node.js • Microsoft Graph'ı gizli diziyle çağırma MSAL Düğümü İstemci kimlik bilgileri verme Hızlı Başlangıç Öğretici
Python • Microsoft Graph'ı gizli diziyle çağırma
• Sertifikayla Microsoft Graph'ı arayın		 MSAL Python İstemci kimlik bilgileri verme Hızlı Başlangıç

Tarayıcısız (Başsı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/
Platform		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama akışı Hızlı Başlangıç Öğretici
.NET Core • Korumalı API'leri yalnızca metin aygıtından çağırma MSAL.NET Cihaz kodu
Java • Kullanıcılarda oturum açın ve korumalı API'ye yalnızca metin aygıtından çağrı yapın MSAL Java Cihaz kodu
Python • 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/
Platform		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama akışı Hızlı Başlangıç Öğretici
Python • 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/
Platform		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama akışı Hızlı Başlangıç Öğretici
Node.js • Teams Sekme uygulaması: çoklu oturum açma (SSO) ve Microsoft Graph'ı çağırma MSAL Düğümü Adına (OBO)

Multitenant SaaS

Aşağıdaki örneklerde, uygulamanızı herhangi bir Microsoft Entra kiracısından oturum açmaları kabul etmek üzere yapılandırma gösterilmektedir. 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/
Platform		 Kod örnekleri
GitHub'da		 Auth
kitaplıklar		 Kimlik doğrulama akışı Hızlı Başlangıç Öğretici
ASP.NET Core • ASP.NET Core MVC web uygulaması Microsoft Graph API'sini çağırır
• ASP.NET Core MVC web uygulaması çağrıları ASP.NET Core web API'si		 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: