Ukázky kódu platformy Microsoft Identity Platform pro ověřování a autorizaci
Tyto ukázky kódu vytváří a udržuje Microsoft, aby demonstrovaly použití našich knihoven ověřování s platformou Microsoft Identity Platform. Běžné scénáře ověřování a autorizace se implementují v několika typech aplikací, vývojových jazycích a architekturách.
- Přihlaste se k webovým aplikacím a poskytněte autorizovaný přístup k chráněným webovým rozhraním API.
- Chraňte webové rozhraní API vyžadováním přístupového tokenu k provádění operací rozhraní API.
Každá ukázka kódu obsahuje soubor README.md popisující, jak sestavit projekt (pokud je k dispozici) a spustit ukázkovou aplikaci. Komentáře v kódu vám pomůžou pochopit, jak se tyto knihovny používají v aplikaci k ověřování a autorizaci pomocí platformy Identity Platform.
Ukázky a příručky
Pomocí karet můžete řadit ukázky podle typu aplikace nebo preferovaného jazyka nebo architektury.
Jednostrákové aplikace
Tyto ukázky ukazují, jak napsat jednostrákovou aplikaci zabezpečenou pomocí platformy Microsoft Identity Platform. Tyto ukázky používají jednu z příchutí MSAL.js.
Jazyk/ Platforma |
Vzorové kódy na GitHubu |
Autentizace/Auth knihovny |
Autentizační tok | Rychlý start | Návod |
---|---|---|---|---|---|
React | • Přihlášení uživatelů | MSAL React | Autorizační kód s PKCE | Rychlý start | Výukový program |
Angular | • Přihlášení uživatelů | MSAL Angular | Autorizační kód s PKCE | Rychlý start | Výukový program |
JavaScript | • Přihlášení uživatelů • Volání Microsoft Graphu • Volání webového rozhraní API Node.js • Nasazení do Azure Storage a App Service |
MSAL.js | Autorizační kód s PKCE | Rychlý start | |
Blazor WebAssembly | • Přihlášení uživatelů • Volání Microsoft Graphu • Nasadit do Aplikační služby Azure |
MSAL.js | Autorizační kód s PKCE | Rychlý start |
Webové aplikace
Následující ukázky znázorňují webové aplikace, které přihlašují uživatele. Některé ukázky také demonstrují aplikaci, která volá Microsoft Graph, nebo vlastní webové rozhraní API s identitou uživatele.
Webové rozhraní API
Následující ukázky ukazují, jak chránit webové rozhraní API pomocí platformy Microsoft Identity Platform a jak volat podřízené rozhraní API z webového rozhraní API.
Jazyk/ Platforma |
Vzorové kódy na GitHubu |
Auth knihovny |
Tok ověřování | Rychlý začátek | Návod |
---|---|---|---|---|---|
ASP.NET | • Volat Microsoft Graph | MSAL.NET | On-Behalf-Of (OBO) | Rychlý start | |
ASP.NET Core | • Řízení přístupu (chráněné trasy) s platformou Microsoft Identity Platform | MSAL.NET | On-Behalf-Of (OBO) | Rychlý start | Tutoriál |
Java | • Ochrana webového rozhraní API Java Spring Boot pomocí platformy Microsoft Identity Platform | MSAL Java | On-Behalf-Of (OBO) | ||
Node.js | • Ochrana webového rozhraní API Node.js | MSAL Node | Autorizační nositel |
Desktop
Následující ukázky ukazují veřejné desktopové klientské aplikace, které přistupují k rozhraní Microsoft Graph API, nebo k vašemu vlastnímu webovému API jménem uživatele. Kromě ukázky Desktopu (konzola) se správcem webového ověřování (WAM) používají všechny tyto klientské aplikace knihovnu Microsoft Authentication Library (MSAL).
Mobil
Následující ukázky ukazují mobilní aplikace veřejného klienta, které přistupuje k rozhraní Microsoft Graph API. Tyto klientské aplikace používají knihovnu MICROSOFT Authentication Library (MSAL).
Jazyk/ Platforma |
Vzorové kódy na GitHubu |
Auth knihovny |
Autentizační tok | Rychlé zprovoznění | Návod |
---|---|---|---|---|---|
.NET Core | • Volání Microsoft Graphu pomocí MAUI • Volání Microsoft Graphu pomocí MAUI se zprostředkovatelem |
MSAL.NET | Autorizační kód s PKCE | ||
iOS | • Volání nativní aplikace Microsoft Graph | MSAL iOS | Autorizační kód s PKCE | Rychlý start | Návod |
Java | • Přihlášení uživatelů a volání Microsoft Graphu | MSAL Android | Autorizační kód s PKCE | Rychlý start | Návod |
Kotlin | • Přihlášení uživatelů a volání Microsoft Graphu | MSAL Android | Autorizační kód s PKCE | ||
Xamarin | • Přihlášení uživatelů a volání Microsoft Graphu • Přihlášení uživatelů pomocí zprostředkovatele a volání Microsoft Graphu |
MSAL.NET | Autorizační kód s PKCE |
Služba / démon
Následující ukázky ukazují aplikaci, která přistupuje k rozhraní Microsoft Graph API s vlastní identitou (bez uživatele).
Jazyk/ Platforma |
Vzorové kódy na GitHubu |
Auth knihovny |
Tok ověřování | Rychlý start | Návod |
---|---|---|---|---|---|
.NET | • Konzolová aplikace .NET, která přistupuje k chráněnému webovému rozhraní API • Víceuživatelský koncový bod platformy Microsoft Identity |
MSAL.NET | Udělení přihlašovacích údajů klienta | Rychlý start | Výukový program |
.NET Core | • Volání Microsoft Graphu • Zavolejte webové API • Použití spravované identity k volání MSGraph • Použití spravované identity k volání rozhraní API • Pracovní role volající rozhraní API |
Microsoft.Identity.Web | Udělení přihlašovacích údajů klienta | ||
Java | • Volání Microsoft Graphu s tajným kódem • Volání Microsoft Graphu pomocí certifikátu |
MSAL Java | Udělení přihlašovacích údajů klienta | Rychlý start | |
Node.js | • Volání Microsoft Graphu s tajným kódem | Uzel MSAL | Udělení přihlašovacích údajů klienta | Rychlý start | Tutoriál |
Python | • Volání Microsoft Graphu s tajným kódem • Volání Microsoft Graphu pomocí certifikátu |
MSAL Python | Udělení přihlašovacích údajů klienta | Rychlý start |
Bez prohlížeče (bezobstřední)
Následující ukázka ukazuje veřejnou klientskou aplikaci spuštěnou na zařízení bez webového prohlížeče. Aplikace může být nástroj příkazového řádku, aplikace spuštěná v Linuxu nebo Macu nebo aplikace IoT. Ukázková aplikace přistupuje k rozhraní Microsoft Graph API jménem uživatele, který se interaktivně přihlašuje na jiném zařízení (například na mobilním telefonu). Tato klientská aplikace používá knihovnu MSAL (Microsoft Authentication Library).
Jazyk/ Platforma |
Vzorové kódy na GitHubu |
Auth knihovny |
Tok autentizace | Rychlý start | Výukový kurz |
---|---|---|---|---|---|
.NET Core | • Vyvolání chráněného rozhraní API z textového zařízení | MSAL.NET | Kód zařízení | ||
Java | • Přihlášení uživatelů a vyvolání chráněného rozhraní API z textového zařízení | MSAL Java | Kód zařízení | ||
Python | • Volání Microsoft Graphu | MSAL Python | Kód zařízení |
Azure Functions jako webová rozhraní API
Následující ukázky demonstrují, jak chránit funkci Azure pomocí HttpTriggeru a zveřejnit webové rozhraní API pomocí platformy Microsoft Identity, a jak volat následné rozhraní API z webového rozhraní API.
Jazyk/ Platforma |
Vzorové kódy na GitHubu |
Auth knihovny |
Autentizační tok | Rychlý start | Návod |
---|---|---|---|---|---|
Python | • Webové rozhraní API pro funkci Azure v Pythonu zabezpečené pomocí Microsoft Entra ID | MSAL Python | Autorizační kód |
Aplikace Microsoft Teams
Následující ukázka ukazuje aplikaci Microsoft Teams Tab, která přihlašuje uživatele. Kromě toho ukazuje, jak volat rozhraní Microsoft Graph API s identitou uživatele pomocí knihovny Microsoft Authentication Library (MSAL).
Jazyk/ Platforma |
Vzorové kódy na GitHubu |
Auth knihovny |
Autentizační tok | Rychlý start | Návod |
---|---|---|---|---|---|
Node.js | • Aplikace Teams Tab: jednotné přihlašování (SSO) a volání Microsoft Graphu | MSAL Node | On-Behalf-Of (OBO) |
SaaS pro více tenantů
Následující ukázky ukazují, jak nakonfigurovat aplikaci tak, aby přijímala přihlášení z libovolného tenanta Microsoft Entra. Konfigurace aplikace tak, aby byla víceklientské , znamená, že můžete nabídnout aplikaci Typu software jako služba (SaaS) mnoha organizacím, což uživatelům umožní přihlásit se k vaší aplikaci po poskytnutí souhlasu.
Jazyk/ Platforma |
Vzorové kódy na GitHubu |
Auth knihovny |
Tok autentizace | Rychlý start | Návod |
---|---|---|---|---|---|
ASP.NET Core | • Webová aplikace ASP.NET Core MVC volá rozhraní Microsoft Graph API • Webová aplikace ASP.NET Core MVC volá webové rozhraní API ASP.NET Core |
MSAL.NET | • OpenID connect (připojení) • Autorizační kód |
Související obsah
Pokud se chcete ponořit hlouběji do více vzorového kódu, podívejte se na: