Panduan
Cara menggunakan Persona di Capacitor
Menggunakan @capgo/capacitor-intune
Plugin Capacitor untuk pendaftaran MAM Microsoft Intune, kebijakan perlindungan aplikasi, konfigurasi aplikasi, dan autentikasi MSAL.
Instal
bun add @capgo/capacitor-intune
bunx cap sync
bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.
Impor
import { IntuneMAM } from '@capgo/capacitor-intune';
Sekilas tentang API
| Metode | Deskripsi |
|---|---|
acquireToken |
Tampilkan alur sign-in Microsoft dan kembalikan access token beserta metadata akun. |
acquireTokenSilent |
Ambil token dari cache MSAL untuk user yang sebelumnya sudah sign-in. |
registerAndEnrollAccount |
Daftarkan akun yang sudah diautentikasi sebelumnya ke Intune dan mulai enrollment. |
loginAndEnrollAccount |
Minta Intune mengautentikasi dan mendaftarkan user tanpa meminta app token terlebih dahulu. |
enrolledAccount |
Kembalikan akun Intune yang saat ini terdaftar, jika ada. |
deRegisterAndUnenrollAccount |
Hapus pendaftaran akun dari Intune dan picu selective wipe jika berlaku. |
logoutOfAccount |
Keluarkan user dari MSAL tanpa membatalkan enrollment akun Intune. |
appConfig |
Ambil konfigurasi aplikasi Intune jarak jauh untuk akun terkelola. |
getPolicy |
Ambil kebijakan perlindungan aplikasi Intune yang berlaku saat ini untuk akun terkelola. |
groupName |
Helper praktis yang mengambil GroupName nilai konfigurasi aplikasi jika tersedia. |
sdkVersion |
Mengembalikan versi native Intune dan MSAL SDK yang disertakan dalam plugin ini. |
displayDiagnosticConsole |
Tampilkan UI diagnostik native Intune. |
Contoh
acquireToken()
Tampilkan alur sign-in Microsoft dan kembalikan access token beserta metadata akun.
import { IntuneMAM } from '@capgo/capacitor-intune';
const result = await IntuneMAM.acquireToken({ scopes: ['openid'] });
// The result holds sensitive values: use it without logging it.
acquireTokenSilent()
Ambil token dari cache MSAL untuk user yang sebelumnya sudah sign-in.
import { IntuneMAM } from '@capgo/capacitor-intune';
const result = await IntuneMAM.acquireTokenSilent({
scopes: ['openid'],
accountId: 'acquireToken',
});
// The result holds sensitive values: use it without logging it.
registerAndEnrollAccount()
Daftarkan akun yang sudah diautentikasi sebelumnya ke Intune dan mulai enrollment.
import { IntuneMAM } from '@capgo/capacitor-intune';
await IntuneMAM.registerAndEnrollAccount({ accountId: 'account-id-123' });
loginAndEnrollAccount()
Minta Intune mengautentikasi dan mendaftarkan user tanpa meminta app token terlebih dahulu.
import { IntuneMAM } from '@capgo/capacitor-intune';
await IntuneMAM.loginAndEnrollAccount();
enrolledAccount()
Kembalikan akun Intune yang saat ini terdaftar, jika ada.
import { IntuneMAM } from '@capgo/capacitor-intune';
const result = await IntuneMAM.enrolledAccount();
console.log(result);
deRegisterAndUnenrollAccount()
Hapus pendaftaran akun dari Intune dan picu selective wipe jika berlaku.
import { IntuneMAM } from '@capgo/capacitor-intune';
await IntuneMAM.deRegisterAndUnenrollAccount({ accountId: 'account-id-123' });
Tabel di atas mencantumkan 12 metode inti. Dokumentasi mengenai helper Listener, version, serta kontrak lengkap dari setiap metode tersedia di repositori GitHub.
Mendengarkan event
addListener mengembalikan sebuah handle. Panggil handle.remove() saat layar di-unmount, atau IntuneMAM.removeAllListeners() untuk menghapus semua listener.
Referensi lengkap
Lanjutkan dari Menggunakan @capgo/capacitor-intune
Jika Anda menggunakan Menggunakan @capgo/capacitor-intune untuk merencanakan alur autentikasi dan akun, hubungkan dengan @capgo/capacitor-intune untuk detail implementasi di @capgo/capacitor-intune, Panduan Memulai untuk detail implementasi di Getting Started, @capgo/capacitor-social-login untuk detail implementasi di @capgo/capacitor-social-login, @capgo/capacitor-passkey untuk detail implementasi di @capgo/capacitor-passkey, dan @capgo/capacitor-native-biometric untuk detail implementasi di @capgo/capacitor-native-biometric.