Bagikan melalui

Sampel kode platform identitas Microsoft

  • Artikel

Sampel kode ini dibuat serta dikelola oleh Microsoft guna menunjukkan penggunaan pustaka autentikasi kami dengan platform identitas Microsoft. Skenario autentikasi dan otorisasi umum diimplementasikan dalam beberapa jenis aplikasi, bahasa pengembangan, serta kerangka kerja.

  • Masukkan pengguna ke aplikasi web dan berikan akses resmi ke API web terlindungi.
  • Lindungi API web dengan memerlukan token akses untuk melakukan operasi API.

Setiap sampel kode menyertakan file README.md yang menjelaskan cara membuat proyek (jika ada) serta menjalankan aplikasi sampel. Komentar di dalam kode akan membantu Anda memahami bagaimana pustaka ini digunakan dalam aplikasi guna melakukan autentikasi serta otorisasi dengan menggunakan platform identitas.

Sampel dan panduan

Gunakan tab untuk mengurutkan sampel menurut jenis aplikasi, atau bahasa/kerangka kerja pilihan Anda.

Aplikasi satu halaman

Sampel ini menunjukkan cara menulis aplikasi satu halaman yang diamankan dengan platform identitas Microsoft. Sampel ini menggunakan salah satu rasa MSAL.js.

Bahasa /
Platform		 Sampel kode
di GitHub		 Auth
pustaka		 Aliran otorisasi Mulai Cepat Tutorial
React • Memasukkan Pengguna MSAL React Kode otorisasi dengan PKCE Mulai Cepat Tutorial
Sudut • Memasukkan Pengguna MSAL Angular Kode otorisasi dengan PKCE Mulai Cepat Tutorial
JavaScript • Memasukkan Pengguna
• Memanggil Microsoft Graph
• Memanggil API web Node.js
• Menyebarkan ke Azure Storage dan App Service		 MSAL.js Kode otorisasi dengan PKCE Mulai Cepat
Blazor WebAssembly • Memasukkan Pengguna
• Memanggil Microsoft Graph
• Menyebarkan ke Azure App Service		 MSAL.js Kode otorisasi dengan PKCE Mulai Cepat

Aplikasi web

Sampel berikut ini menggambarkan aplikasi web yang memasukkan pengguna. Beberapa sampel juga menunjukkan aplikasi yang memanggil Microsoft Graph, atau API web Anda sendiri dengan identitas pengguna.

Bahasa /Platform Sampel kode di GitHub Pustaka otorisasi Aliran otorisasi Mulai Cepat Tutorial
ASP.NET • Sampel Pelatihan Microsoft Graph
• Memasukkan pengguna dan memanggil Microsoft Graph dengan cakupan terbatas admin		 • MSAL.NET
• Microsoft.Identity.Web
• Skenario Cache Token Tingkat Lanjut		 • OpenID connect
• Kode otorisasi
• Atas Nama (OBO)		 Mulai Cepat
Inti ASP.NET • Memasukkan Pengguna
• Memanggil Microsoft Graph
• Menyesuaikan cache token
• Gunakan konteks autentikasi Akses Bersyar untuk melakukan autentikasi peningkatan
• Call Graph (multitenant)
• Memanggil REST API Azure
• Melindungi API web
• Lindungi API web multipenyewa
• Menggunakan Peran Aplikasi untuk kontrol akses
• Menggunakan Kelompok Keamanan untuk kontrol akses
• Menyebarkan ke Azure Storage dan App Service
• Layanan Federasi Direktori Aktif ke migrasi Microsoft Entra		 Microsoft.Identity.Web • OpenID connect
• Kode otorisasi
• Aliran Atas Nama (OBO)		 Mulai Cepat Tutorial
Blazor • Memasukkan Pengguna
• Memanggil Microsoft Graph
• Memanggil API web		 MSAL.NET Aliran hibrid
Java Spring • Memasukkan Pengguna
• Memanggil Microsoft Graph
• Menggunakan Peran Aplikasi untuk kontrol akses
• Menggunakan Grup untuk kontrol akses
• Melindungi API web
• Menyebarkan ke Azure App Service		 MSAL Java Kode otorisasi Tutorial
Java Servlets • Memasukkan Pengguna
• Memanggil Microsoft Graph
• Menggunakan Peran Aplikasi untuk kontrol akses
• Menggunakan Kelompok Keamanan untuk kontrol akses
• Menyebarkan ke Azure App Service		 MSAL Java Kode otorisasi Mulai Cepat
Node.js Express • Memasukkan Pengguna
• Aplikasi web ekspres yang dibangun dengan MSAL Node dan platform identitas Microsoft
• Memanggil Microsoft Graph
• Panggil Microsoft Graph melalui proksi BFF
• Menggunakan Peran Aplikasi untuk kontrol akses
• Menggunakan Kelompok Keamanan untuk kontrol akses
• Menyebarkan ke Azure App Service		 MSAL Node • Kode otorisasi
• Proksi backend-for-Frontend (BFF)		 Mulai Cepat Tutorial
Python Flask • Memasukkan Pengguna
• Templat untuk masuk ke MICROSOFT Entra ID, dan secara opsional memanggil API hilir (Microsoft Graph)
• Menyebarkan ke Azure App Service		 MSAL Python Kode otorisasi Mulai Cepat Tutorial
Python Django • Memasukkan Pengguna MSAL Python Kode otorisasi
Ruby • Memasukkan pengguna dan memanggil Microsoft Graph OmniAuth OAuth2 Kode otorisasi

API Web

Sampel berikut menunjukkan cara melindungi API web dengan platform identitas Microsoft, dan cara memanggil API hilir dari API web.

Bahasa /
Platform		 Sampel kode
di GitHub		 Auth
pustaka		 Aliran otorisasi Mulai Cepat Tutorial
ASP.NET • Memanggil Microsoft Graph MSAL.NET On-Behalf-Of (OBO) Mulai Cepat
Inti ASP.NET • Kontrol akses (rute yang dilindungi) dengan platform identitas Microsoft MSAL.NET On-Behalf-Of (OBO) Mulai Cepat Tutorial
Java • Lindungi API web Java Spring Boot Anda dengan platform identitas Microsoft MSAL Java On-Behalf-Of (OBO)
Node.js • Melindungi API web Node.js MSAL Node Token pembawa otorisasi

Desktop

Sampel berikut memperlihatkan aplikasi desktop klien publik yang mengakses API Microsoft Graph atau API web Anda sendiri atas nama pengguna. Terlepas dari sampel Desktop (Konsol) dengan Web Authentication Manager (WAM), semua aplikasi klien ini menggunakan Microsoft Authentication Library (MSAL).

Bahasa /
Platform		 Sampel kode
di GitHub		 Auth
pustaka		 Aliran otorisasi Mulai Cepat Tutorial
.NET Core • Memanggil Microsoft Graph
• Memanggil Microsoft Graph dengan cache token
• Panggil Microsoft Graph dengan HTML UI web kustom
• Memanggil Microsoft Graph dengan browser web kustom
• Memasukkan pengguna dengan alur kode perangkat
• Panggil Microsoft Graph dengan memasukkan pengguna menggunakan nama pengguna/kata sandi
• Mengautentikasi pengguna dengan MSAL.NET dalam aplikasi desktop WinUI		 MSAL.NET • Kode otorisasi dengan PKCE
• Kode perangkat
• Info masuk kata sandi pemilik sumber daya
Java • Memanggil Microsoft Graph MSAL Java Autentikasi Windows yang terintegrasi
Node.js • Memasukkan Pengguna MSAL Node Kode otorisasi dengan PKCE Mulai Cepat Tutorial
Python • Memasukkan Pengguna MSAL Python Info Masuk Kata Sandi Pemilik Sumber Daya
Windows Presentation Foundation (WPF) • Memasukkan pengguna dan memanggil Microsoft Graph
• Masuk pengguna Windows Presentation Foundation (WPF), akses API web yang dilindungi (Microsoft Graph)
• Memasukkan pengguna dan memanggil API web ASP.NET Core
• Memasukkan pengguna dan memanggil Microsoft Graph		 MSAL.NET Kode otorisasi dengan PKCE Mulai Cepat Tutorial

Seluler

Sampel berikut menampilkan aplikasi seluler klien publik yang mengakses API Microsoft Graph. Aplikasi klien ini menggunakan Microsoft Authentication Library (MSAL).

Bahasa /
Platform		 Sampel kode
di GitHub		 Auth
pustaka		 Aliran otorisasi Mulai Cepat Tutorial
.NET Core • Panggil Microsoft Graph menggunakan MAUI
• Panggil Microsoft Graph menggunakan MAUI dengan broker		 MSAL.NET Kode otorisasi dengan PKCE
iOS • Memanggil Microsoft Graph asli MSAL iOS Kode otorisasi dengan PKCE Mulai Cepat Tutorial
Java • Memasukkan pengguna dan memanggil Microsoft Graph MSAL Android Kode otorisasi dengan PKCE Mulai Cepat Tutorial
Kotlin • Memasukkan pengguna dan memanggil Microsoft Graph MSAL Android Kode otorisasi dengan PKCE
Xamarin • Memasukkan pengguna dan memanggil Microsoft Graph
• Memasukkan pengguna dengan broker dan memanggil Microsoft Graph		 MSAL.NET Kode otorisasi dengan PKCE

Layanan / daemon

Sampel berikut menunjukkan aplikasi yang mengakses API Microsoft Graph dengan identitasnya sendiri (tanpa pengguna).

Bahasa /
Platform		 Sampel kode
di GitHub		 Auth
pustaka		 Aliran otorisasi Mulai Cepat Tutorial
.NET • Aplikasi konsol .NET yang mengakses API web yang dilindungi
• Multipenyewa dengan titik akhir platform identitas Microsoft		 MSAL.NET Pemberian kredensial klien Mulai Cepat Tutorial
.NET Core • Memanggil Microsoft Graph
• Memanggil API web
• Menggunakan identitas terkelola untuk memanggil MSGraph
• Menggunakan identitas terkelola untuk memanggil API
• Peran pekerja memanggil API		 Microsoft.Identity.Web Pemberian kredensial klien
Java • Memanggil Microsoft Graph dengan Rahasia
• Memanggil Microsoft Graph dengan Sertifikat		 MSAL Java Pemberian kredensial klien Mulai Cepat
Node.js • Memanggil Microsoft Graph secara rahasia MSAL Node Pemberian kredensial klien Mulai Cepat Tutorial
Python • Memanggil Microsoft Graph secara rahasia
• Memanggil Microsoft Graph dengan sertifikat		 MSAL Python Pemberian kredensial klien Mulai Cepat

Browserless (Headless)

Contoh berikut menunjukkan aplikasi klien publik yang berjalan di perangkat tanpa browser web. Aplikasi ini dapat menjadi alat baris perintah, aplikasi yang berjalan di Linux atau Mac, atau aplikasi IoT. Sampel ini menampilkan aplikasi yang mengakses Microsoft Graph API, atas nama pengguna yang masuk secara interaktif di perangkat lain (seperti ponsel). Aplikasi klien ini menggunakan Microsoft Authentication Library (MSAL).

Bahasa /
Platform		 Sampel kode
di GitHub		 Auth
pustaka		 Aliran otorisasi Mulai Cepat Tutorial
.NET Core • Panggil API yang dilindungi dari perangkat teks saja MSAL.NET Kode perangkat
Java • Memasukkan pengguna dan memanggil API yang dilindungi dari perangkat khusus teks MSAL Java Kode perangkat
Python • Memanggil Microsoft Graph MSAL Python Kode perangkat

Azure Functions sebagai API web

Sampel berikut menunjukkan cara melindungi Azure Function dengan HttpTrigger dan mengekspos API web dengan platform identitas Microsoft, dan cara memanggil API hilir dari API web.

Bahasa /
Platform		 Sampel kode
di GitHub		 Auth
pustaka		 Aliran otorisasi Mulai Cepat Tutorial
Python • API web fungsi Python Azure yang diamankan oleh ID Microsoft Entra MSAL Python Kode otorisasi

Aplikasi Teams Microsoft

Sampel berikut mengilustrasikan aplikasi Teams Tab Microsoft yang memasukkan pengguna. Selain itu, aplikasi ini menunjukkan cara memanggil Microsoft Graph API dengan identitas pengguna menggunakan Microsoft Authentication Library (MSAL).

Bahasa /
Platform		 Sampel kode
di GitHub		 Auth
pustaka		 Aliran otorisasi Mulai Cepat Tutorial
Node.js • Aplikasi Tab Teams: akses menyeluruh (SSO) dan panggil Microsoft Graph MSAL Node On-Behalf-Of (OBO)

SaaS Multipenyewa

Sampel berikut menunjukkan cara mengonfigurasi aplikasi Anda untuk menerima rincian masuk dari penyewa Microsoft Entra mana pun. Mengonfigurasi aplikasi Anda menjadi multipenyewa berarti Anda dapat menawarkan aplikasi Software as a Service (SaaS) ke banyak organisasi, memungkinkan pengguna mereka untuk dapat masuk ke aplikasi Anda setelah memberikan persetujuan.

Bahasa /
Platform		 Sampel kode
di GitHub		 Auth
pustaka		 Aliran otorisasi Mulai Cepat Tutorial
Inti ASP.NET • ASP.NET aplikasi web Core MVC memanggil Microsoft Graph API
• ASP.NET panggilan aplikasi web Core MVC ASP.NET CORE web API		 MSAL.NET • OpenID connect
• Kode otorisasi

Konten terkait

Jika Anda ingin menggali lebih banyak sampel kode lebih dalam, lihat: