kod örneklerini Microsoft kimlik platformu

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ışı
Angular Oturum açma kullanıcıları
Oturum açma kullanıcıları (B2C)
Microsoft Graph'ı arayın
ASP.NET Core web API'lerini çağırma
ASP.NET Core web API'lerini (B2C) çağır
OBO 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 Depolama ve App Service'e dağıtma
MSAL Angular • PKCE ile yetkilendirme kodu
• Adına (OBO)
• Sürekli Erişim Değerlendirmesi (CAE)
Blazor WebAssembly Oturum açma kullanıcıları
Oturum açma kullanıcıları (B2C)
Microsoft Graph'ı arayın
Azure Uygulaması Hizmetine dağıtma
MSAL.js Örtük Akış
JavaScript Oturum açma kullanıcıları
Oturum açma kullanıcıları (B2C)
Microsoft Graph'ı arayın
Node.js web API'lerini çağırma
Arama Node.js web API'si (B2C)
Azure Depolama ve App Service'e dağıtma
MSAL.js • PKCE ile yetkilendirme kodu
React Oturum açma kullanıcıları
Oturum açma kullanıcıları (B2C)
Hem sunucu hem de istemci tarafı uygulamalarında oturum açma kullanıcıları
Microsoft Graph'ı arayın
Azure REST API'sini ve Azure Depolama çağırma
Node.js web API'lerini çağırma
Arama Node.js web API'si (B2C)
OBO 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 Static Web Apps'e dağıtma
Node.js web API'sini çağırmak için adım adım kimlik doğrulamasını kullanma
MSAL React • PKCE ile yetkilendirme kodu
• Adına (OBO)
• Koşullu Erişim
• Koşullu Erişim Kimlik Doğrulama Bağlamı (acrs)
• Sürekli Erişim Değerlendirmesi (CAE)

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
Kod örnekleri
GitHub'da
Auth
kitaplıklar
Kimlik doğrulama akışı
ASP.NET Core ASP.NET Core Serisi
Oturum açma kullanıcıları
Oturum açma kullanıcıları (B2C)
Microsoft Graph'ı arayın
Belirteç önbelleğini özelleştirme
Çağrı Grafı (çok kiracılı)
Azure REST API'lerini çağırma
Web API'lerini koruma
Web API'lerini koruma (B2C)
Ç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.Identity.Web • OpenID bağlantısı
• Yetkilendirme kodu
• Adına
Blazor Blazor Sunucu Serisi
Oturum açma kullanıcıları
Oturum açma kullanıcıları (B2C)
Microsoft Graph'ı arayın
Web API'lerini çağırma
Web API'lerini (B2C) çağırma
MSAL.NET Karma akış
ASP.NET Core Gelişmiş Belirteç Önbelleği Senaryoları Microsoft.Identity.Web Adına (OBO)
ASP.NET Core Adım adım kimlik doğrulaması gerçekleştirmek için Koşullu Erişim kimlik doğrulaması bağlamını kullanma Microsoft.Identity.Web Yetki kodu
ASP.NET Core Microsoft Entra geçişi Active Directory Federasyon Hizmetleri (AD FS) MSAL.NET •SAML
• OpenID bağlantısı
ASP.NET Microsoft Graph Eğitim Örneği
Kullanıcıları oturum açın ve Microsoft Graph'ı arayın
Kullanıcılarda oturum açın ve yönetici kısıtlı kapsamıyla Microsoft Graph'ı arayın
Hızlı Başlangıç: Kullanıcılarda oturum açma
MSAL.NET • OpenID bağlantısı
• Yetkilendirme kodu
Java

Spring
Microsoft Entra Spring Boot Başlangıç Serisi
Oturum açma kullanıcıları
Oturum açma kullanıcıları (B2C)
Microsoft Graph'ı arayın
Erişim denetimi için Uygulama Rollerini kullanma
Erişim denetimi için Grupları kullanma
Azure Uygulaması Hizmetine dağıtma
Web API'lerini koruma
MSAL Java
• Microsoft Entra Id Boot Starter
Yetki kodu
Java

Servlet
Spring-less Servlet Serisi
Oturum açma kullanıcıları
Oturum açma kullanıcıları (B2C)
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
Node.js

Express
Express web uygulaması serisi
Hızlı Başlangıç: kullanıcılarda oturum açma
Oturum açma kullanıcıları
Oturum açma kullanıcıları (B2C)
Microsoft Graph'ı arayın
BFF ara sunucusu aracılığıyla Microsoft Graph'ı arayın
Azure Uygulaması Hizmetine dağıtma
Erişim denetimi için Uygulama Rollerini kullanma
Erişim denetimi için Güvenlik Gruplarını kullanma
MSAL Düğümü • Yetkilendirme kodu
• Ön Uç için Arka Uç (BFF) ara sunucusu
Python

Flask
Flask Serisi
Oturum açma kullanıcıları
Oturum açma kullanıcıları (B2C)
Microsoft Entra Id veya B2C kullanıcılarında oturum açmak ve isteğe bağlı olarak aşağı akış API'si (Microsoft Graph) çağırmak için bir şablon
Microsoft Graph'ı arayın
Azure Uygulaması Hizmetine dağıtma
MSAL Python Yetki kodu
Python

Django
Django Serisi
Oturum açma kullanıcıları
Oturum açma kullanıcıları (B2C)
Microsoft Graph'ı arayın
Azure Uygulaması Hizmetine dağıtma
MSAL Python Yetki kodu
Ruby Graph Eğitimi
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ışı
ASP.NET Microsoft Graph'ı arayın MSAL.NET Adına (OBO)
ASP.NET Core Kullanıcılarda oturum açma ve Microsoft Graph'ı arama MSAL.NET Adına (OBO)
Java Oturum açma kullanıcıları MSAL Java Adına (OBO)
Node.js Node.js web API'lerini koruma
Azure AD B2C ile 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ışı
.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
WinUI masaüstü uygulamasında MSAL.NET ile kullanıcıların kimliğini doğrulama
MSAL.NET • PKCE ile yetkilendirme kodu
• Cihaz kodu
.NET Tümleşik Windows kimlik doğrulaması ile korumalı API'leri çağırma MSAL.NET Tümleşik Windows kimlik doğrulaması
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
.NET Core Kullanıcı adı/parola kullanarak kullanıcılarda oturum açarak Microsoft Graph'ı arayın MSAL.NET Kaynak sahibinin parola kimlik bilgileri
Python Oturum açma kullanıcıları MSAL Python Kaynak sahibinin parola kimlik bilgileri
Evrensel Pencere Platformu (UWP) Microsoft Graph'ı arayın MSAL.NET Web hesabı yöneticisi
Windows Presentation Foundation (WPF) Kullanıcılarda oturum açma ve Microsoft Graph'ı arama MSAL.NET PKCE ile yetkilendirme kodu
Windows Presentation Foundation (WPF) 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

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.

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ışı
.NET Core Microsoft Graph'ı arayın
Web API'lerini çağırma
Yönetilen kimlik ve Azure Key Vault kullanma
MSAL.NET İstemci kimlik bilgileri verme
ASP.NET Microsoft kimlik platformu uç noktası olan çok kiracılı MSAL.NET İstemci kimlik bilgileri verme
Java Gizli Dizi ile Microsoft Graph'ı arayın
Sertifika ile Microsoft Graph'ı arayın
MSAL Java İstemci kimlik bilgileri verme
Node.js Microsoft Graph'ı gizli diziyle çağırma MSAL Düğümü İstemci kimlik bilgileri verme
Python Microsoft Graph'ı gizli diziyle çağırma
Sertifikayla Microsoft Graph'ı arayın
MSAL Python İstemci kimlik bilgileri verme

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ışı
.NET Microsoft Entra Id ile güvenliği sağlanan .NET Azure işlevi web API'si MSAL.NET Yetki kodu
Python Microsoft Entra Id ile güvenliği sağlanan Python Azure işlevi web API'si MSAL Python Yetki kodu

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ışı
.NET Core Korumalı API'leri yalnızca metin aygıtından çağırma MSAL.NET Cihaz kodu
Java Kullanıcılarda oturum açma ve korumalı API'nin yalnızca metin cihazdan çağrılma MSAL Java Cihaz kodu
Python Microsoft Graph'ı arayın MSAL Python Cihaz 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ışı
Node.js Teams Sekme uygulaması: çoklu oturum açma (SSO) ve Microsoft Graph'ı çağırma MSAL Düğümü Adına (OBO)

Çok kiracılı 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 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ışı
ASP.NET Core ASP.NET Core MVC web uygulaması Microsoft Graph API'sini çağırır MSAL.NET OpenID Connect
ASP.NET Core ASP.NET Core MVC web uygulaması ASP.NET Core web API'lerini çağırır MSAL.NET Yetki kodu
Angular Angular tek sayfalı uygulama ASP.NET Core web API'lerini çağırır MSAL Angular Yetki kodu

Sonraki adımlar

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