Megosztás:

Microsoft Identitásplatform-kódminták hitelesítéshez és engedélyezéshez

Ezeket a kódmintákat a Microsoft készíti és tartja karban, hogy bemutassuk a hitelesítési kódtárak használatát a Microsoft Identitásplatform. A gyakori hitelesítési és engedélyezési forgatókönyvek számos alkalmazástípusban, fejlesztési nyelven és keretrendszerben implementálhatók.

  • Jelentkezzen be a felhasználókkal a webalkalmazásba, és biztosítson engedélyezett hozzáférést a védett webes API-khoz.
  • A webes API védelméhez hozzáférési jogkivonatra van szükség az API-műveletek végrehajtásához.

Minden kódminta tartalmaz egy README.md fájlt, amely leírja, hogyan hozhatja létre a projektet (ha van ilyen), és hogyan futtathatja a mintaalkalmazást. A kód megjegyzései segítenek megérteni, hogyan használják ezeket a kódtárakat az alkalmazásban a hitelesítés és az engedélyezés végrehajtásához az identitásplatform használatával.

Minták és útmutatók

A lapok használatával alkalmazástípus vagy az ön által választott nyelv/keretrendszer szerint rendezheti a mintákat.

Egyoldalas alkalmazások

Ezek a minták bemutatják, hogyan írhat egy Microsoft Identitásplatform védett egyoldalas alkalmazást. Ezek a minták a MSAL.js egyik ízét használják.

Nyelv/
Platforma		 Kódminta(ok)
GitHubon		 Hitelesítés
könyvtárak		 Hitelesítési folyamat Gyorsútmutató Oktatóanyag
Reagálás • Felhasználók bejelentkezése MSAL React Engedélyezési kód a PKCE-vel Gyors kezdés Oktatóanyag
Szögletes • Felhasználók bejelentkezése MSAL szögletes Engedélyezési kód a PKCE-vel Gyors kezdés Oktatóanyag
JavaScript • Felhasználók bejelentkezése
• Hívja meg a Microsoft Graphot
• Node.js webes API meghívása
• Üzembe helyezés az Azure Storage-ban és az App Service-ben		 MSAL.js Engedélyezési kód a PKCE-vel Gyors kezdés
Blazor WebAssembly (egy .NET alapú keretrendszer, amely lehetővé teszi webes alkalmazások futtatását közvetlenül a böngészőben) • Felhasználók bejelentkezése
• Hívja meg a Microsoft Graphot
• Üzembe helyezés Azure-alkalmazás szolgáltatásban		 MSAL.js Engedélyezési kód a PKCE-vel Gyors kezdés

Webes alkalmazások

Az alábbi minták a felhasználókat bejelentkező webalkalmazásokat szemléltetik. Néhány példa a Microsoft Graphot hívó alkalmazást vagy a felhasználó identitásával rendelkező saját webes API-t is szemlélteti.

Nyelv / Platform Kódminta(ok) a GitHubon Autentikációs könyvtárak Hitelesítési folyamat Gyorsútmutató Oktatóanyag
ASP.NET • Microsoft Graph- képzési minta
• Jelentkezzen be felhasználóként, és hívja meg a Microsoft Graphot rendszergazdai jogosultságra korlátozott hatókörrel		 • MSAL.NET
• Microsoft.Identity.Web
• Haladó token gyorsítótár forgatókönyvek		 • OpenID-csatlakozás
• Engedélyezési kód
• Nevében (OBO)		 Gyors kezdés
ASP.NET Core • Felhasználók bejelentkezése
• Hívja meg a Microsoft Graphot
• Token gyorsítótár testreszabása
• A feltételes hozzáférés hitelesítési környezetének használata a lépésenkénti hitelesítés végrehajtásához
• Call Graph (több bérlős)
• Azure REST API-k meghívása
• Webes API védelme
• Több-bérlős webes API védelme
• Alkalmazásszerepkörök használata hozzáférés-vezérléshez
• Biztonsági csoportok használata hozzáférés-vezérléshez
• Üzembe helyezés az Azure Storage-ban és az App Service-ben
• Active Directory Federációs szolgáltatások Microsoft Entra-ra történő migrálása		 Microsoft.Identity.Web • OpenID-csatlakozás
• Engedélyezési kód
• Folyamat nevében (OBO)		 Gyors kezdés Oktatóanyag
Blazor • Felhasználók bejelentkezése
• Hívja meg a Microsoft Graphot
• Webes API meghívása		 MSAL.NET Hibrid folyamat
Java Spring keretrendszer • Felhasználók bejelentkezése
• Hívja meg a Microsoft Graphot
• Alkalmazásszerepkörök használata hozzáférés-vezérléshez
• Csoportok használata hozzáférés-vezérléshez
• Webes API védelem
• Üzembe helyezés Azure-alkalmazás szolgáltatásban		 MSAL Java Engedélyezési kód Oktatóanyag
Java-servletek • Felhasználók bejelentkezése
• Hívja meg a Microsoft Graphot
• Alkalmazásszerepkörök használata hozzáférés-vezérléshez
• Biztonsági csoportok használata hozzáférés-vezérléshez
• Üzembe helyezés Azure-alkalmazás szolgáltatásban		 MSAL Java Engedélyezési kód Gyors kezdés
Node.js Express • Felhasználók bejelentkezése
• Express webalkalmazás, az MSAL Node és a Microsoft identitásplatform segítségével
• Hívja meg a Microsoft Graphot
• A Microsoft Graph meghívása BFF-proxyn keresztül
• Alkalmazásszerepkörök használata hozzáférés-vezérléshez
• Biztonsági csoportok használata hozzáférés-vezérléshez
• Üzembe helyezés Azure-alkalmazás szolgáltatásban		 MSAL csomópont • Engedélyezési kód
• Backend-for-Frontend (BFF) proxy (háttér a frontend számára)		 Gyors kezdés Oktatóanyag
Python Flask web keretrendszer • Felhasználók bejelentkezése
• Sablon a Microsoft Entra-azonosítóba való bejelentkezéshez, és opcionálisan egy alsóbb rétegbeli API meghívásához (Microsoft Graph)		 MSAL Python Engedélyezési kód Gyors kezdés Oktatóanyag
Python Django • Felhasználók bejelentkezése MSAL Python Engedélyezési kód
Rubin • Jelentkeztesse be a felhasználókat, és használja a Microsoft Graphot OmniAuth OAuth2 Engedélyezési kód

Webes API

Az alábbi minták bemutatják, hogyan védheti meg a webes API-t a Microsoft Identitásplatform, és hogyan hívhat meg egy alsóbb rétegbeli API-t a webes API-ból.

Nyelv/
Platforma		 Kódminta(ok)
GitHubon		 Hitelesítés
könyvtárak		 Hitelesítési folyamat Gyorsútmutató Oktatóanyag
ASP.NET • Hívja meg a Microsoft Graphot MSAL.NET Meghatalmazás alapján (OBO) Gyors kezdés
ASP.NET Core • Hozzáférés-ellenőrzés (védett útvonalak) a Microsoft identitásplatformmal MSAL.NET Meghatalmazás alapján (OBO) Gyors kezdés Oktatóanyag
Jáva • Védje meg Java Spring Boot webes API-ját a Microsoft identitásplatform segítségével MSAL Java Meghatalmazás alapján (OBO)
Node.js • Node.js webes API védelme MSAL csomópont Engedélyezési tulajdonos

Asztali

Az alábbi minták a Microsoft Graph API-hoz hozzáférő nyilvános asztali ügyfélalkalmazásokat vagy a felhasználó nevében a saját webes API-t mutatják be. Az asztali (konzol) Web Authentication Manager (WAM) mintán kívül ezek az ügyfélalkalmazások a Microsoft Authentication Libraryt (MSAL) használják.

Nyelv/
Platforma		 Kódminta(ok)
GitHubon		 Hitelesítés
könyvtárak		 Hitelesítési folyamat Gyorsútmutató Oktatóanyag
.NET Core • Hívja meg a Microsoft Graphot
• A Microsoft Graph hívása jogkivonat gyorsítótárának használatával
• A Microsoft Graph meghívása egyéni webes felhasználói felület HTML-jével
• A Microsoft Graph meghívása egyéni webböngészővel
• Felhasználók bejelentkezése eszközkód-folyamattal
• A Microsoft Graph meghívása a felhasználók felhasználónévvel/jelszóval történő bejelentkezésével		 MSAL.NET • Engedélyezési kód PKCE-vel
• Eszközkód
• Erőforrás-tulajdonosi jelszó hitelesítő adatai
Jáva • Hívja meg a Microsoft Graphot MSAL Java Integrált Windows-hitelesítés
Node.js • Felhasználók bejelentkezése MSAL csomópont Engedélyezési kód a PKCE-vel Gyors kezdés Oktatóanyag
Piton • Felhasználók bejelentkezése MSAL Python Erőforrás tulajdonosának jelszava
Windows Presentation Foundation (WPF) • Jelentkeztesse be a felhasználókat, és használja a Microsoft Graphot
• Windows megjelenítési alaprendszer (WPF) felhasználói bejelentkezés, védett webes API-hozzáférés (Microsoft Graph)
• Jelentkezzen be felhasználóként, és hívja az ASP.NET Core web API-t
• Jelentkeztesse be a felhasználókat, és használja a Microsoft Graphot		 MSAL.NET Engedélyezési kód a PKCE-vel Gyors kezdés Oktatóanyag

Mobil

Az alábbi minták a Microsoft Graph API-t elérő nyilvános ügyfél-mobilalkalmazásokat mutatják be. Ezek az ügyfélalkalmazások a Microsoft Authentication Libraryt (MSAL) használják.

Nyelv/
Platforma		 Kódminta(ok)
GitHubon		 Hitelesítés
könyvtárak		 Hitelesítési folyamat Gyorsútmutató Oktatóanyag
.NET Core • A Microsoft Graph meghívása a MAUI használatával
• Microsoft Graph meghívása MAUI és közvetítő használatával		 MSAL.NET Engedélyezési kód a PKCE-vel
Ios • Microsoft Graph natív módon történő meghívása MSAL iOS Engedélyezési kód a PKCE-vel Gyors kezdés Oktatóanyag
Jáva • Jelentkeztesse be a felhasználókat, és használja a Microsoft Graphot MSAL Android Engedélyezési kód a PKCE-vel Gyors kezdés Oktatóanyag
Kotlin • Jelentkeztesse be a felhasználókat, és használja a Microsoft Graphot MSAL Android Engedélyezési kód a PKCE-vel

Szolgáltatás / démon

Az alábbi minták egy olyan alkalmazást mutatnak be, amely saját identitással (felhasználó nélkül) fér hozzá a Microsoft Graph API-hoz.

Nyelv/
Platforma		 Kódminta(ok)
GitHubon		 Hitelesítés
könyvtárak		 Hitelesítési folyamat Gyorsútmutató Oktatóanyag
.HÁLÓ • Védett webes API-t elérő .NET-konzolalkalmazás
• Több-bérlős Microsoft identitásplatform végpont		 MSAL.NET Ügyfél hitelesítő adatainak megadása Gyors kezdés Oktatóanyag
.NET Core • Hívja meg a Microsoft Graphot
• Webes API meghívása
• Felügyelt identitás használata az MSGraph meghívásához
• Felügyelt identitás használata API meghívásához
• Feldolgozói szerepkör API-t hív meg		 Microsoft.Identity.Web Ügyfél hitelesítő adatainak megadása
Jáva • A Microsoft Graph meghívása titkos kóddal
• Tanúsítvánnyal hívja meg a Microsoft Graphot		 MSAL Java Ügyfél hitelesítő adatainak megadása Gyors kezdés
Node.js • A Microsoft Graph meghívása titkos kóddal MSAL csomópont Ügyfél hitelesítő adatainak megadása Gyors kezdés Oktatóanyag
Piton • A Microsoft Graph meghívása titkos kóddal
• Hívja meg a Microsoft Graphot tanúsítvánnyal		 MSAL Python Ügyfél hitelesítő adatainak megadása Gyors kezdés

Böngésző nélküli (fej nélküli)

Az alábbi minta egy webböngésző nélküli eszközön futó nyilvános ügyfélalkalmazást mutat be. Az alkalmazás lehet parancssori eszköz, Linuxon vagy Macen futó alkalmazás vagy IoT-alkalmazás. A minta egy, a Microsoft Graph API-hoz hozzáférő alkalmazást tartalmaz egy olyan felhasználó nevében, aki interaktív módon jelentkezik be egy másik eszközön (például mobiltelefonon). Ez az ügyfélalkalmazás a Microsoft Authentication Libraryt (MSAL) használja.

Nyelv/
Platforma		 Kódminta(ok)
GitHubon		 Hitelesítés
könyvtárak		 Hitelesítési folyamat Gyorsútmutató Oktatóanyag
.NET Core • Védett API meghívása csak szöveges felülettel rendelkező eszközről MSAL.NET Eszközkód
Jáva • Jelentkezzen be felhasználóként, és érje el a védett API-t szöveg alapú eszközről MSAL Java Eszközkód
Piton • Hívja meg a Microsoft Graphot MSAL Python Eszközkód

Azure Functions web API-ként

Az alábbi minták bemutatják, hogyan védhet meg egy Azure Function-t a HttpTrigger használatával, hogyan tehet elérhetővé egy webes API-t a Microsoft identitásplatform segítségével, és hogyan hívhat meg egy alsóbb szintű API-t a webes API-ból.

Nyelv/
Platforma		 Kódminta(ok)
GitHubon		 Hitelesítés
könyvtárak		 Hitelesítési folyamat Gyorsútmutató Oktatóanyag
Piton • A Microsoft Entra személyazonosság által védett Python Azure-függvény webes API-ja MSAL Python Engedélyezési kód

Microsoft Teams-alkalmazások

Az alábbi minta a felhasználókat bejelentkező Microsoft Teams Tab alkalmazást mutatja be. Emellett bemutatja, hogyan hívhatja meg a Microsoft Graph API-t a felhasználó identitásával a Microsoft Authentication Library (MSAL) használatával.

Nyelv/
Platforma		 Kódminta(ok)
GitHubon		 Hitelesítés
könyvtárak		 Hitelesítési folyamat Gyorsútmutató Oktatóanyag
Node.js • Teams Tab alkalmazás: egyszeri bejelentkezés (SSO) és a Microsoft Graph meghívása MSAL csomópont Meghatalmazás alapján (OBO)

Többfelhasználós SaaS

Az alábbi minták bemutatják, hogyan konfigurálhatja az alkalmazást úgy, hogy bármely Microsoft Entra-bérlőről fogadjon bejelentkezéseket. Ha az alkalmazását több bérlő számára konfigurálja, az azt jelenti, hogy számos szervezet számára kínálhat szoftver mint szolgáltatás (SaaS) alkalmazást, így a felhasználók a hozzájárulás megadása után bejelentkezhetnek az alkalmazásba.

Nyelv/
Platforma		 Kódminta(ok)
GitHubon		 Hitelesítés
könyvtárak		 Hitelesítési folyamat Gyorsútmutató Oktatóanyag
ASP.NET Core • ASP.NET Core MVC-webalkalmazás meghívja a Microsoft Graph API-t
• ASP.NET Core MVC-webalkalmazás meghívja ASP.NET Core webes API-t		 MSAL.NET • OpenID-csatlakozás
• Engedélyezési kód

Kapcsolódó tartalom

Ha részletesebben szeretne megismerkedni a mintakóddal, tekintse meg a következőt:

  • Last updated on