Bagikan melalui


Gambaran umum Microsoft Authentication Library (MSAL)

Microsoft Authentication Library (MSAL) memungkinkan pengembang memperoleh token keamanan dari platform identitas Microsoft untuk mengautentikasi pengguna dan mengakses API web aman. Ini dapat digunakan untuk menyediakan akses aman ke Microsoft Graph, Microsoft API lainnya, API web pihak ketiga, atau API web Anda sendiri. MSAL mendukung berbagai arsitektur dan platform aplikasi termasuk .NET, JavaScript, Java, Python, Android, dan iOS.

MSAL menyediakan beberapa cara untuk mendapatkan token keamanan, dengan API yang konsisten untuk banyak platform. Menggunakan MSAL memberi manfaat berikut:

  • Tidak perlu langsung menggunakan pustaka atau kode OAuth terhadap protokol di aplikasi Anda.
  • Dapat memperoleh token atas nama pengguna atau aplikasi (jika berlaku untuk platform).
  • Mempertahankan cache token untuk Anda dan menangani refresh token saat hampir kedaluwarsa.
  • Membantu menentukan audiens yang ingin dimasukkan ke aplikasi Anda. Audiens masuk dapat mencakup akun Microsoft pribadi, identitas sosial dengan organisasi Azure AD B2C, kantor, sekolah, atau pengguna di cloud berdaulat dan nasional.
  • Membantu Anda menyiapkan aplikasi dari file konfigurasi.
  • Membantu Anda memecahkan masalah aplikasi dengan mengekspos pengecualian, pembuatan log, dan telemetri yang dapat dilakukan.
Jenis dan skenario aplikasi Tutorial
Aplikasi halaman tunggal (JavaScript) Tutorial: Memasukkan pengguna ke aplikasi React Single-page (SPA)
Aplikasi web Tutorial: Memasukkan pengguna ke aplikasi Web ASP.NET Core
Web API Tutorial: Menerapkan titik akhir yang dilindungi ASP.NET Core API
Aplikasi seluler dan native Aplikasi seluler yang memanggil API web atas nama pengguna yang masuk secara interaktif.
Daemon dan aplikasi sisi server Aplikasi daemon desktop/layanan yang memanggil API web atas nama dirinya sendiri

Bahasa dan Kerangka Kerja MSAL

Anda dapat merujuk ke dokumentasi berikut untuk mempelajari selengkapnya tentang pustaka MSAL yang berbeda.

Dokumentasi MSAL Pustaka MSAL Platform dan kerangka kerja yang didukung
MSAL.NET MSAL.NET .NET Framework, .NET, .NET MAUI, WINUI,Xamarin Android, Xamarin iOS, Platform Windows Universal
MSAL untuk Android MSAL untuk Android Android
MSAL Angular MSAL Angular Aplikasi halaman tunggal dengan kerangka kerja Angular dan Angular.js
MSAL untuk iOS dan macOS MSAL untuk iOS dan macOS iOS dan macOS
MSAL Java MSAL Java Windows, macOS, Linux
MSAL.js MSAL.js Kerangka kerja JavaScript/TypeScript seperti Vue.js, Ember.js, atau Durandal.js
MSAL Node MSAL Node Aplikasi web dengan Express, aplikasi desktop dengan Electron, aplikasi konsol lintas platform
MSAL Python MSAL Python Windows, macOS, Linux
MSAL React MSAL React Aplikasi halaman tunggal dengan React dan pustaka berbasis React (Next.js, Gatsby.js)
MSAL Go (Pratinjau) MSAL Go (Pratinjau) Windows, macOS, Linux

Memigrasikan aplikasi yang menggunakan ADAL ke MSAL

Pustaka Autentikasi Direktori Aktif (ADAL) telah mengakhiri dukungan. Sebaiknya pelanggan memastikan aplikasi mereka dimigrasikan ke MSAL. MSAL terintegrasi dengan titik akhir platform identitas Microsoft (v2.0), yang merupakan penyatuan akun pribadi Microsoft dan akun kerja ke dalam satu sistem autentikasi. ADAL terintegrasi dengan titik akhir v1.0 yang tidak mendukung akun pribadi.

Untuk informasi selengkapnya tentang cara bermigrasi ke MSAL, lihat Memigrasikan aplikasi ke Microsoft Authentication Library (MSAL).