시작하기

1. 패키지를 설치하세요

   bun add @capgo/capacitor-intune

2. 자연어 프로젝트 동기화

   bunx cap sync

3. 자연어 Intune 설정 완료 dedicated로 따로따로 iOS 설정 및 Android 설정 pages. Intune는 호스트 앱의 네이티브 구성이 필요합니다. brokered auth, redirect URIs, manifests, 권한, 및 MSAL config.

Requirements

• Capacitor 8+
• 안드로이드와 Intune 안드로이드 SDK 12.0.3
• iOS와 Intune iOS SDK 21.5.1
• iOS 배포 대상 17.0+

Ionic의 Intune 문서는 현재 Xcode 26로 빌드한 앱에 대한 2026년 1월 19일 마감일을 호출합니다. Intune iOS SDK 21.1.0+. 이 플러그인은 이미 21.5.1.

기본 사용 방법

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 });

일반 흐름

인터랙티브 가입 및 등록

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

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

무음 토큰 갱신

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

현재 등록된 계정 읽기

const user = await IntuneMAM.enrolledAccount();

로그아웃 또는 선택적으로 지우기

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

API 요약

• acquireToken(options)Microsoft 로그인 시작하고 토큰 및 계정 메타데이터 반환.
• acquireTokenSilent(options)기존 계정의 캐시된 토큰 읽기.
• registerAndEnrollAccount(options)MSAL 계정 Intune과 등록하고 등록을 트리거.
• loginAndEnrollAccount()Intune이 로그인 및 등록 흐름을 제어.
• appConfig(user)계정에 대한 Intune 앱 구성 값을 읽어라.
• getPolicy(user)계정에 대한 현재 Intune 앱 보호 정책을 읽어라.
• groupName(user)공통 GroupName config helper 값이 있는 경우.
• sdkVersion(): Inspect bundled Intune and MSAL versions.

플랫폼 참고 사항

• 웹은 지원되지 않습니다.
• iOS와 Android 모두 native 프로젝트 구성이 필요합니다. cap sync.
• Azure 등록, Intune 정책 assign, 리다이렉트 URI, 권한은 앱별로 유지됩니다.