Panduan Memulai

Instalasi

Anda bisa menggunakan AI-Assisted Setup kami untuk menginstal plugin ini. Tambahkan skill Capgo ke tool AI Anda dengan command berikut:

bunx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Lalu gunakan prompt berikut:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-intune` plugin in my project.

Jika Anda lebih memilih Manual Setup, instal plugin dengan menjalankan perintah berikut dan ikuti petunjuk khusus platform di bawah ini:

1. Instal package

   bun add @capgo/capacitor-intune

2. Sinkronkan proyek native

   bunx cap sync

3. Selesaikan setup native Intune Ikuti panduan khusus di Setup iOS dan Setup Android halaman ini. Intune tetap memerlukan konfigurasi native host-app untuk brokered auth, redirect URIs, manifest, entitlements, dan konfigurasi MSAL.

Mulai cepat

import { IntuneMAM } from '@capgo/capacitor-intune';

const result = await IntuneMAM.acquireToken({ scopes: ['openid'] });
// The result holds sensitive values: use it without logging it.

Contoh: acquireTokenSilent

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.

Contoh: registerAndEnrollAccount

import { IntuneMAM } from '@capgo/capacitor-intune';

await IntuneMAM.registerAndEnrollAccount({ accountId: 'account-id-123' });

Kesalahan umum

• Listeners: hapus handle saat screen unmount.
• Sinkronisasi Native: jalankan bunx cap sync setelah upgrade plugin.
• Sumber kebenaran tunggal: percayai src/definitions.ts di repo GitHub.

Persyaratan

• Capacitor 8+
• Android dengan Intune Android SDK 12.0.3
• iOS dengan Intune iOS SDK 21.5.1
• Target deployment iOS 17.0+

Dokumentasi Intune Ionic saat ini menyebutkan batas waktu 19 Januari 2026 untuk aplikasi yang dibangun dengan Xcode 26, yang memerlukan Intune iOS SDK 21.1.0+. Plugin ini sudah menggunakan 21.5.1.

Penggunaan Dasar

import { IntuneMAM } from '@capgo/capacitor-intune';

await IntuneMAM.addListener('appConfigChange', (result) => {
  console.log('App config changed', result.accountId);
});

await IntuneMAM.addListener('policyChange', (result) => {
  console.log('Policy changed', result.accountId);
});

const auth = await IntuneMAM.acquireToken({
  scopes: ['https://graph.microsoft.com/.default'],
  loginHint: 'alex@example.com',
});

await IntuneMAM.registerAndEnrollAccount({
  accountId: auth.accountId,
});

const appConfig = await IntuneMAM.appConfig({
  accountId: auth.accountId,
});

const policy = await IntuneMAM.getPolicy({
  accountId: auth.accountId,
});

console.log({ auth, appConfig, policy });

Alur Umum

Sign-in dan enrollment interaktif

const auth = await IntuneMAM.acquireToken({
  scopes: ['https://graph.microsoft.com/.default'],
});

await IntuneMAM.registerAndEnrollAccount({
  accountId: auth.accountId,
});

Penyegaran token secara senyap

const token = await IntuneMAM.acquireTokenSilent({
  accountId: 'AAD_OBJECT_ID',
  scopes: ['https://graph.microsoft.com/.default'],
  forceRefresh: true,
});

Baca akun yang terdaftar saat ini

const user = await IntuneMAM.enrolledAccount();

Sign out atau hapus data secara selektif

await IntuneMAM.logoutOfAccount({ accountId: 'AAD_OBJECT_ID' });
await IntuneMAM.deRegisterAndUnenrollAccount({ accountId: 'AAD_OBJECT_ID' });

Ringkasan API

• acquireToken(options): Mulai login Microsoft dan kembalikan token serta metadata akun.
• acquireTokenSilent(options): Baca token yang tersimpan untuk akun yang sudah ada.
• registerAndEnrollAccount(options): Daftarkan akun MSAL ke Intune dan jalankan proses enrollment.
• loginAndEnrollAccount(): Biarkan Intune mengelola alur login dan enrollment.
• appConfig(user): Membaca nilai konfigurasi aplikasi Intune untuk akun tersebut.
• getPolicy(user): Membaca kebijakan perlindungan aplikasi Intune saat ini untuk akun tersebut.
• groupName(user): Membaca nilai helper konfig GroupName urasi umum jika tersedia.
• sdkVersion(): Memeriksa versi Intune dan MSAL yang dibundel.

Catatan Platform

• Web tidak didukung.
• iOS dan Android sama-sama memerlukan konfigurasi proyek native selain cap sync.
• Registrasi Azure, penetapan kebijakan Intune, redirect URI, dan hak akses Anda tetap spesifik untuk aplikasi.

Lanjutkan dari Getting Started

Jika Anda menggunakan Panduan Memulai untuk merencanakan migrasi dan operasional enterprise, hubungkan dengan Menggunakan @capgo/capacitor-intune untuk kapabilitas native saat menggunakan @capgo/capacitor-intune, Capgo Enterprise untuk workflow produk di Capgo Enterprise, Alternatif Plugin Ionic Enterprise untuk workflow produk di Alternatif Plugin Ionic Enterprise, Alternatif Capgo untuk alur kerja produk di Capgo Alternatives, dan Konsultasi Capgo untuk alur kerja produk di Capgo Consulting.