Przykłady kodu usługi Azure Active Directory (punkt końcowy w wersji 1.0)

Artykuł
07/15/2019

Ostrzeżenie

Ta zawartość dotyczy starszego punktu końcowego Azure AD w wersji 1.0. Użyj Platforma tożsamości Microsoft dla nowych projektów.

Możesz użyć usługi Azure Active Directory (Azure AD), aby dodać uwierzytelnianie i autoryzację do aplikacji internetowych i internetowych interfejsów API.

Ta sekcja zawiera linki do przykładów, których można użyć, aby dowiedzieć się więcej na temat punktu końcowego Azure AD w wersji 1.0. Te przykłady pokazują, jak to zrobić wraz z fragmentami kodu, których można używać w aplikacjach. Na przykładowej stronie kodu znajdziesz szczegółowe tematy dotyczące odczytu i mnie, które ułatwiają wymagania, instalację i konfigurację. Kod jest komentowany, aby ułatwić zrozumienie krytycznych sekcji.

Uwaga

Jeśli interesuje Cię Microsoft Entra przykłady kodu w wersji 2, zobacz Przykłady kodu w wersji 2.0 według scenariusza.

Ostrzeżenie

Obsługa biblioteki Active Directory Authentication Library (ADAL) zakończy się w grudniu 2022 r. Aplikacje korzystające z biblioteki ADAL w istniejących wersjach systemu operacyjnego będą nadal działać, ale wsparcie techniczne i aktualizacje zabezpieczeń zostaną zakończone. Bez ciągłych aktualizacji zabezpieczeń aplikacje korzystające z biblioteki ADAL staną się coraz bardziej narażone na najnowsze wzorce ataków zabezpieczeń. Aby uzyskać więcej informacji, zobacz Migrowanie aplikacji do biblioteki MSAL.

Aby zrozumieć podstawowy scenariusz dla każdego przykładowego typu, zobacz Scenariusze uwierzytelniania dla Azure AD.

Możesz również współtworzyć nasze przykłady w usłudze GitHub. Aby dowiedzieć się, jak to zrobić, zobacz przykłady i dokumentację usługi Azure Active Directory.

Aplikacje jednostronicowe

W tym przykładzie pokazano, jak napisać aplikację jednostronicową zabezpieczoną przy użyciu Azure AD.

Platforma	Wywołuje własny interfejs API	Wywołuje inny internetowy interfejs API
	javascript-singlepageapp
	angularjs-singlepageapp	angularjs-singlepageapp-cors

Aplikacje internetowe

Aplikacje internetowe logujące użytkowników, wywołując program Microsoft Graph lub internetowy interfejs API z tożsamością użytkownika

Poniższe przykłady ilustrują aplikacje internetowe podpisujące użytkowników. Niektóre z tych aplikacji wywołają również program Microsoft Graph lub własny internetowy interfejs API w nazwie zalogowanego użytkownika.

Platforma	Tylko loguje użytkowników	Wywołuje program Microsoft Graph	Wywołuje inny interfejs API sieci Web ASP.NET lub ASP.NET Core 2.0
ASP.NET Core 2.0	dotnet-webapp-openidconnect-aspnetcore	webapp-webapi-multitenant-openidconnect-aspnetcore (Azure AD Graph)	dotnet-webapp-webapi-openidconnect-aspnetcore
ASP.NET 4.5	webapp-WSFederation-dotNet dotnet-webapp-webapi-oauth2-useridentity	dotnet-webapp-multitenant-openidconnect (Azure AD Graph)
		python-webapp-graphapi
		java-webapp-openidconnect
		php-graphapi-web

Aplikacje internetowe demonstrujące kontrolę dostępu opartą na rolach (autoryzacja)

W poniższych przykładach pokazano, jak zaimplementować kontrolę dostępu opartą na rolach (RBAC). Kontrola dostępu oparta na rolach służy do ograniczania uprawnień niektórych funkcji w aplikacji internetowej określonym użytkownikom. Użytkownicy są autoryzowani w zależności od tego, czy należą do grupy Azure AD, czy mają daną rolę aplikacji.

Platforma	Sample	Opis
ASP.NET 4.5	dotnet-webapp-groupclaims dotnet-webapp-roleclaims	Aplikacja internetowa MVC platformy .NET 4.5, która używa ról Azure AD do autoryzacji

Klasyczne i mobilne publiczne aplikacje klienckie wywołujące program Microsoft Graph lub internetowy interfejs API

Poniższe przykłady ilustrują publiczne aplikacje klienckie (aplikacje klasyczne/mobilne), które uzyskują dostęp do programu Microsoft Graph lub internetowego interfejsu API w nazwie użytkownika. W zależności od urządzeń i platform aplikacje mogą logować użytkowników na różne sposoby (przepływy/dotacje):

Interaktywnie
Dyskretnie (ze zintegrowanym uwierzytelnianiem systemu Windows w systemie Windows lub nazwą użytkownika/hasłem)
Delegowanie logowania interakcyjnego do innego urządzenia (przepływ kodu urządzenia używany na urządzeniach, które nie udostępniają kontrolek internetowych)

Aplikacja kliencka	Przepływ/Udzielanie	Wywołuje program Microsoft Graph	Wywołuje interfejs API sieci Web ASP.NET lub ASP.NET Core 2.x
Desktop (WPF)	Interaktywne	Część elementu `dotnet-native-multitarget`	`dotnet-native-desktop` `dotnet-native-aspnetcore` `dotnet-webapi-manual-jwt-validation`
Mobile (UWP)	Interaktywne	`dotnet-native-uwp-wam` W tym przykładzie użyto wam, a nie ADAL.NET	`dotnet-windows-store` (Aplikacja platformy UWP używająca ADAL.NET do wywoływania pojedynczego interfejsu API sieci Web dzierżawy) `dotnet-webapi-multitenant-windows-store` (Aplikacja platformy UWP używająca ADAL.NET do wywoływania wielodostępnego internetowego interfejsu API)
Mobile (Android, iOS, UWP)	Interaktywne	`dotnet-native-multitarget`
Urządzenia przenośne (Android)	Interaktywne	`android`
Mobile (iOS)	Interaktywne	`nativeClient-iOS`
Pulpit (konsola)	Nazwa użytkownika/hasło Zintegrowane uwierzytelnianie systemu Windows		`dotnet-native-headless`
Pulpit (konsola)	Nazwa użytkownika/hasło		`java-native-headless`
Pulpit (konsola)	Przepływ kodu urządzenia		`dotnet-deviceprofile`

Aplikacje demona (uzyskiwanie dostępu do internetowych interfejsów API przy użyciu tożsamości aplikacji)

W poniższych przykładach pokazano aplikacje klasyczne lub internetowe, które uzyskują dostęp do programu Microsoft Graph lub internetowego interfejsu API bez użytkownika (z tożsamością aplikacji).

Aplikacja kliencka	Przepływ/Udzielanie	Wywołuje internetowy interfejs API ASP.NET lub ASP.NET Core 2.0
Aplikacja demona (konsola)	Poświadczenia klienta z wpisem tajnym aplikacji lub certyfikatem	dotnet-demon dotnet-daemon-certificate-credential
Aplikacja demona (konsola)	Poświadczenia klienta z certyfikatem	dotnetcore-daemon-certificate-credential
aplikacja internetowa ASP.NET	Poświadczenia klienta	dotnet-webapp-webapi-oauth2-appidentity

Interfejsy API sieci Web

Internetowy interfejs API chroniony przez usługę Azure Active Directory

Poniższy przykład pokazuje, jak chronić internetowy interfejs API Node.js przy użyciu Azure AD.

W poprzednich sekcjach tego artykułu można również znaleźć inne przykłady ilustrujące aplikację kliencką wywołującą ASP.NET lub ASP.NET Core internetowy interfejs API. Te przykłady nie zostały ponownie wymienione w tej sekcji, ale znajdziesz je w ostatniej kolumnie tabel powyżej lub poniżej

Platforma	Przykład
	node-webapi

Internetowy interfejs API wywołujący program Microsoft Graph lub inny internetowy interfejs API

W poniższych przykładach pokazano internetowy interfejs API, który wywołuje inny internetowy interfejs API. W drugim przykładzie pokazano, jak obsługiwać dostęp warunkowy.

Platforma	Wywołuje program Microsoft Graph	Wywołuje inny interfejs API sieci Web ASP.NET lub ASP.NET Core 2.0
ASP.NET 4.5	dotnet-webapi-onbehalfof dotnet-webapi-onbehalfof-ca	dotnet-webapi-onbehalfof dotnet-webapi-onbehalfof-ca

Inne przykłady programu Microsoft Graph

Przykłady i samouczki demonstrujące różne wzorce użycia dla interfejs Graph API firmy Microsoft, w tym uwierzytelnianie za pomocą Azure AD, zobacz Przykłady społeczności programu Microsoft Graph & Samouczki.