Udostępnij za pośrednictwem

Przykłady kodu platformy tożsamości firmy Microsoft na potrzeby uwierzytelniania i autoryzacji

Te przykłady kodu są tworzone i obsługiwane przez firmę Microsoft w celu zademonstrowania użycia naszych bibliotek uwierzytelniania za pomocą Platforma tożsamości Microsoft. Typowe scenariusze uwierzytelniania i autoryzacji są implementowane w kilku typach aplikacji, językach programowania i strukturach.

  • Logowanie użytkowników do aplikacji internetowych i zapewnianie autoryzowanego dostępu do chronionych internetowych interfejsów API.
  • Ochrona internetowego interfejsu API przez wymaganie tokenu dostępu do wykonywania operacji interfejsu API.

Każdy przykładowy kod zawiera plik README.md opisujący sposób kompilowania projektu (jeśli dotyczy) i uruchamiania przykładowej aplikacji. Komentarze w kodzie pomagają zrozumieć, jak te biblioteki są używane w aplikacji do przeprowadzania uwierzytelniania i autoryzacji przy użyciu platformy tożsamości.

Przykłady i przewodniki

Użyj kart, aby posortować przykłady według typu aplikacji lub preferowanego języka/platformy.

Aplikacje jednostronicowe

Te przykłady pokazują, jak napisać jednostronicową aplikację zabezpieczoną przy użyciu Platforma tożsamości Microsoft. Te przykłady używają jednej z odmian MSAL.js.

Język/
Platforma		 Przykłady kodu
w witrynie GitHub		 Auth
biblioteki		 Proces uwierzytelniania Szybki start Samouczek
Reagować • Logowanie użytkowników MSAL React Kod autoryzacji za pomocą protokołu PKCE Szybki start Samouczek
Kanciasty • Logowanie użytkowników Kątowy biblioteki MSAL Kod autoryzacji za pomocą protokołu PKCE Szybki start Samouczek
JavaScript • Logowanie użytkowników
• Wywoływanie programu Microsoft Graph
• Wywoływanie internetowego interfejsu API Node.js
• Wdrażanie w usługach Azure Storage i App Service		 MSAL.js Kod autoryzacji za pomocą protokołu PKCE Szybki start
Blazor WebAssembly • Logowanie użytkowników
• Wywoływanie programu Microsoft Graph
• Wdrażanie do usługi Azure App Service		 MSAL.js Kod autoryzacji za pomocą protokołu PKCE Szybki start

Aplikacje sieci Web

Poniższe przykłady ilustrują aplikacje internetowe, które logują użytkowników. Niektóre przykłady pokazują również aplikację wywołującą Microsoft Graph lub własny internetowy interfejs API z użyciem tożsamości użytkownika.

Język/platforma Przykłady kodu w witrynie GitHub Biblioteki autoryzacyjne Proces uwierzytelniania Szybki start Samouczek
ASP.NET • Przykład trenowania programu Microsoft Graph
• Logowanie użytkowników i wywoływanie programu Microsoft Graph przy użyciu ograniczonego zakresu administratora		 • MSAL.NET
• Microsoft.Identity.Web (Tożsamość Microsoftu)
• Zaawansowane scenariusze pamięci podręcznej tokenów		 • OpenID Connect
• Kod autoryzacji
• W imieniu (OBO)		 Szybki start
ASP.NET Core • Logowanie użytkowników
• Wywoływanie programu Microsoft Graph
• Dostosowywanie pamięci podręcznej tokenów
• Użyj kontekstu uwierzytelniania dostępu warunkowego do przeprowadzania uwierzytelniania podwyższonego
• Graf wywołań (wielodostępny)
• Wywoływanie interfejsów API REST platformy Azure
• Ochrona internetowego interfejsu API
• Ochrona wielodostępnych API web
• Używanie ról aplikacji do kontroli dostępu
• Używanie grup zabezpieczeń do kontroli dostępu
• Wdrażanie w usługach Azure Storage i App Service
• Migracja usług Active Directory Federation Services do firmy Microsoft		 Microsoft.Identity.Web • OpenID Connect
• Kod autoryzacji
• Przepływ w imieniu kogoś innego (OBO)		 Szybki start Samouczek
Blazor • Logowanie użytkowników
• Wywoływanie programu Microsoft Graph
• Wywołaj internetowe API		 MSAL.NET Przepływ hybrydowy
Java Spring • Logowanie użytkowników
• Wywoływanie programu Microsoft Graph
• Używanie ról aplikacji do kontroli dostępu
• Używanie grup do kontroli dostępu
• Ochrona internetowego interfejsu API
• Wdrażanie do usługi Azure App Service		 MSAL Java Kod autoryzacji Samouczek
Serwlety Java • Logowanie użytkowników
• Wywoływanie programu Microsoft Graph
• Używanie ról aplikacji do kontroli dostępu
• Używanie grup zabezpieczeń do kontroli dostępu
• Wdrażanie do usługi Azure App Service		 MSAL Java Kod autoryzacji Szybki start
Node.js Ekspres • Logowanie użytkowników
• Aplikacja internetowa Express zbudowana przy użyciu MSAL Node i Platformy tożsamości Microsoft
• Wywoływanie programu Microsoft Graph
• Wywoływanie programu Microsoft Graph za pośrednictwem serwera proxy BFF
• Używanie ról aplikacji do kontroli dostępu
• Używanie grup zabezpieczeń do kontroli dostępu
• Wdrażanie do usługi Azure App Service		 Węzeł MSAL • Kod autoryzacji
• Proxy Backend-for-Frontend (BFF)		 Szybki start Samouczek
Python Flask - framework do tworzenia aplikacji webowych w języku Python. • Logowanie użytkowników
• Szablon do zalogowania się do Microsoft Entra ID i opcjonalnie wywołania API niższego poziomu (Microsoft Graph)		 MSAL Python Kod autoryzacji Szybki start Samouczek
Python Django • Logowanie użytkowników MSAL Python Kod autoryzacji
Rubin • Logowanie użytkowników i wywoływanie programu Microsoft Graph OmniAuth OAuth2 Kod autoryzacji

Internetowe API

W poniższych przykładach pokazano, jak chronić webowy interfejs API za pomocą platformy tożsamości Microsoft oraz jak wywoływać podrzędny interfejs API z webowego interfejsu API.

Język/
Platforma		 Przykłady kodu
w witrynie GitHub		 Auth
biblioteki		 Proces uwierzytelniania Szybki start Samouczek
ASP.NET • Wywoływanie programu Microsoft Graph MSAL.NET WłBehalf-Of (OBO) Szybki start
ASP.NET Core • Kontrola dostępu (chronione trasy) z platformy tożsamości Microsoft MSAL.NET WłBehalf-Of (OBO) Szybki start Samouczek
Jawa • Ochrona internetowego interfejsu API środowiska Java Spring Boot za pomocą Platforma tożsamości Microsoft MSAL Java WłBehalf-Of (OBO)
Node.js • Ochrona internetowego interfejsu API Node.js Węzeł MSAL Token autoryzacyjny

Klasyczna

W poniższych przykładach pokazano publiczne aplikacje klienckie na komputer stacjonarny, które uzyskują dostęp do interfejsu API Microsoft Graph lub do własnego internetowego interfejsu API w imieniu użytkownika. Oprócz przykładu Desktop (Console) z programem Web Authentication Manager (WAM) wszystkie te aplikacje klienckie korzystają z biblioteki Microsoft Authentication Library (MSAL).

Język/
Platforma		 Przykłady kodu
w witrynie GitHub		 Auth
biblioteki		 Proces uwierzytelniania Szybki start Samouczek
.NET Core • Wywoływanie programu Microsoft Graph
• Wywoływanie programu Microsoft Graph za pomocą pamięci podręcznej tokenów
• Wywoływanie programu Microsoft Graph przy użyciu niestandardowego kodu HTML interfejsu użytkownika sieci Web
• Wywoływanie programu Microsoft Graph za pomocą niestandardowej przeglądarki internetowej
• Logowanie użytkowników przy użyciu przepływu kodu urządzenia
• Wywołaj program Microsoft Graph, logując użytkowników przy użyciu nazwy użytkownika/hasła		 MSAL.NET • Kod autoryzacji za pomocą PKCE
• Kod urządzenia
• Poświadczenia hasłowe właściciela zasobu
Jawa • Wywoływanie programu Microsoft Graph MSAL Java Zintegrowane uwierzytelnianie systemu Windows
Node.js • Logowanie użytkowników Węzeł MSAL Kod autoryzacji za pomocą protokołu PKCE Szybki start Samouczek
Pyton • Logowanie użytkowników MSAL Python Poświadczenia właściciela zasobu: hasło
Windows Presentation Foundation (WPF) • Logowanie użytkowników i wywoływanie programu Microsoft Graph
• Logowanie użytkownika aplikacji Windows Presentation Foundation (WPF), chroniony dostęp do internetowego interfejsu API (Microsoft Graph)
• Logowanie użytkowników i wywoływanie internetowego interfejsu API platformy ASP.NET Core
• Logowanie użytkowników i wywoływanie programu Microsoft Graph		 MSAL.NET Kod autoryzacji za pomocą protokołu PKCE Szybki start Samouczek

Aplikacje mobilne

W poniższych przykładach pokazano publiczne aplikacje mobilne klienckie, które uzyskują dostęp do interfejsu API programu Microsoft Graph. Te aplikacje klienckie używają biblioteki Microsoft Authentication Library (MSAL).

Język/
Platforma		 Przykłady kodu
w witrynie GitHub		 Auth
biblioteki		 Proces uwierzytelniania Szybki start Samouczek
.NET Core • Wywoływanie programu Microsoft Graph przy użyciu interfejsu MAUI
• Wywoływanie programu Microsoft Graph przy użyciu MAUI z brokerem		 MSAL.NET Kod autoryzacji za pomocą protokołu PKCE
Ios • Wywoływanie natywnej aplikacji Microsoft Graph Biblioteka MSAL dla systemu iOS Kod autoryzacji za pomocą protokołu PKCE Szybki start Samouczek
Jawa • Logowanie użytkowników i wywoływanie programu Microsoft Graph MSAL Android Kod autoryzacji za pomocą protokołu PKCE Szybki start Samouczek
Kotlin powiedział: • Logowanie użytkowników i wywoływanie programu Microsoft Graph MSAL Android Kod autoryzacji za pomocą protokołu PKCE

Usługa/proces

W poniższych przykładach pokazano aplikację, która uzyskuje dostęp do interfejsu API programu Microsoft Graph przy użyciu własnej tożsamości (bez użytkownika).

Język/
Platforma		 Przykłady kodu
w witrynie GitHub		 Auth
biblioteki		 Proces uwierzytelniania Szybki start Samouczek
.SIEĆ • Aplikacja konsolowa platformy .NET, która uzyskuje dostęp do chronionego internetowego interfejsu API
• Wielodostępność z punktem końcowym Platformy tożsamości Microsoft		 MSAL.NET Udzielanie poświadczeń klienta Szybki start Samouczek
.NET Core • Wywoływanie programu Microsoft Graph
• Wywołaj internetowe API
• Używanie tożsamości zarządzanej do wywoływania usługi MSGraph
• Używanie tożsamości zarządzanej do wywoływania interfejsu API
• Rola pracownika wywołująca interfejs API		 Microsoft.Identity.Web Udzielanie poświadczeń klienta
Jawa • Wywoływanie Microsoft Graph za pomocą sekretu
• Wywoływanie programu Microsoft Graph za pomocą certyfikatu		 MSAL Java Udzielanie poświadczeń klienta Szybki start
Node.js • Wywoływanie programu Microsoft Graph za pomocą tajemnicy Węzeł MSAL Udzielanie poświadczeń klienta Szybki start Samouczek
Pyton • Wywoływanie programu Microsoft Graph za pomocą tajemnicy
• Wywoływanie programu Microsoft Graph przy użyciu certyfikatu		 MSAL Python Udzielanie poświadczeń klienta Szybki start

Bez przeglądarki (bezgłówkowy)

Poniższy przykład przedstawia publiczną aplikację kliencką działającą na urządzeniu bez przeglądarki internetowej. Aplikacja może być narzędziem wiersza polecenia, aplikacją działającą w systemie Linux lub Mac albo aplikacją IoT. Przykład przedstawia aplikację, która uzyskuje dostęp do interfejsu API programu Microsoft Graph w imieniu użytkownika, który loguje się interaktywnie na innym urządzeniu (takim jak telefon komórkowy). Ta aplikacja kliencka używa biblioteki Microsoft Authentication Library (MSAL).

Język/
Platforma		 Przykłady kodu
w witrynie GitHub		 Auth
biblioteki		 Proces uwierzytelniania Szybki start Samouczek
.NET Core • Wywołać chroniony interfejs API z urządzenia wyłącznie tekstowego MSAL.NET Kod urządzenia
Jawa • Logowanie się użytkowników i wywoływanie chronionego interfejsu API z urządzenia obsługującego tylko tekst MSAL Java Kod urządzenia
Pyton • Wywoływanie programu Microsoft Graph MSAL Python Kod urządzenia

Usługa Azure Functions jako internetowe interfejsy API

W poniższych przykładach pokazano, jak chronić funkcję platformy Azure przy użyciu HttpTrigger i udostępniać internetowy interfejs API za pomocą platformy tożsamości Microsoft oraz jak wywoływać podrzędny interfejs API z poziomu internetowego interfejsu API.

Język/
Platforma		 Przykłady kodu
w witrynie GitHub		 Auth
biblioteki		 Proces uwierzytelniania Szybki start Samouczek
Pyton • Funkcja Python w Azure jako web API zabezpieczona przez Microsoft Entra ID MSAL Python Kod autoryzacji

Aplikacje microsoft Teams

Poniższy przykład ilustruje aplikację zakładki Microsoft Teams, logującą użytkowników. Ponadto przedstawiono sposób wywoływania interfejsu API programu Microsoft Graph przy użyciu tożsamości użytkownika przy użyciu biblioteki Microsoft Authentication Library (MSAL).

Język/
Platforma		 Przykłady kodu
w witrynie GitHub		 Auth
biblioteki		 Proces uwierzytelniania Szybki start Samouczek
Node.js • Aplikacja karty Teams: logowanie jednokrotne (SSO) i wywoływanie programu Microsoft Graph Węzeł MSAL WłBehalf-Of (OBO)

Wielodostępna usługa SaaS

W poniższych przykładach pokazano, jak skonfigurować aplikację tak, aby akceptowała loginy z dowolnej dzierżawy Microsoft Entra. Skonfigurowanie aplikacji jako wielodostępnej oznacza, że można zaoferować aplikację oprogramowania jako usługi (SaaS) wielu organizacjom, umożliwiając użytkownikom logowanie się do aplikacji po udzieleniu zgody.

Język/
Platforma		 Przykłady kodu
w witrynie GitHub		 Auth
biblioteki		 Proces uwierzytelniania Szybki start Samouczek
ASP.NET Core • aplikacja internetowa ASP.NET Core MVC wywołuje interfejs API programu Microsoft Graph
• Aplikacja internetowa ASP.NET Core MVC wywołuje interfejs API sieciowej ASP.NET Core		 MSAL.NET • OpenID Connect
• Kod autoryzacji

Powiązana zawartość

Jeśli chcesz zagłębić się w bardziej przykładowy kod, zobacz: