Getting Started

설치 단계와 이 플러그인의 전체 마크다운 가이드가 포함된 설정 프롬프트 복사

        Set up this Capacitor plugin in the project.

Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-intune`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/intune/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.

설치

AI-Assisted Setup을 사용하여 플러그인을 설치할 수 있습니다. AI 도구에 Capgo 스킬을 추가하려면 다음 명령어를 사용하세요:

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

다음 명령어를 사용하세요:

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

Manual Setup을 사용하는 경우, 플러그인을 설치하려면 다음 명령어를 실행하고 아래의 플랫폼별 지침을 따르세요:

패키지를 설치
터미널 창
```
bun add @capgo/capacitor-intune
```
자연 프로젝트를 동기화
터미널 창
```
bunx cap sync
```
Intune 설정 완료 dedicated iOS 설정 및 Android 설정 요구 사항

__CAPGO_KEEP_0__ 8+

Capacitor 8+
Android with Intune Android SDK 12.0.3
iOS with 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): Intune MSAL 계정 등록 및 등록을 트리거하세요.
loginAndEnrollAccount(): Intune가 로그인 및 등록 흐름을 주도하세요.
appConfig(user): Intune 앱 구성 값을 계정에 읽어오세요.
getPolicy(user): 계정에 대한 현재 Intune 앱 보호 정책을 읽어오세요.
groupName(user): 공통 GroupName : config helper 값이 있는 경우 읽어오세요.
sdkVersion(): Intune 및 MSAL 버전을 패키지에 포함하여 검사하세요.

플랫폼 참고 사항

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

다음 단계로 진행하세요

이러한 기능을 사용하는 경우 Getting Started 이 기능을 사용하여 마이그레이션 및 기업 운영을 계획하고 연결하세요 Using @capgo/capacitor-intune Using @capgo/capacitor-intune Capgo Enterprise Capgo Enterprise __CAPGO_KEEP_0__ Alternatives __CAPGO_KEEP_0__ Alternatives Capgo Alternatives Capgo 제품 워크플로우에 대한 Capgo 대안 및 Capgo 컨설팅 Capgo 제품 워크플로우에 대한 Capgo 컨설팅.