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.

만들기 설정을 선호하시면, 다음 명령어를 실행하여 플러그인을 설치하고 아래에 설명된 플랫폼별 지침을 따르십시오.

패키지 설치
터미널 창
```
bun add @capgo/capacitor-intune
```
자연어 프로젝트 동기화
터미널 창
```
bunx cap sync
```
자연어 Intune 설정 완료 dedicated에 따라 iOS 설정 그리고 Android 설정 Intune는 호스트 앱의 네이티브 구성이 필요합니다. brokered auth, redirect URI, manifests, 권한, MSAL 구성.

요구 사항

Capacitor 8+
Android Intune Android 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,
});

silent token refresh

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 __CAPGO_KEEP_0__
sdkVersion(): __CAPGO_KEEP_0__와 __CAPGO_KEEP_1__ 버전을 검사합니다.

플랫폼 참고 사항

웹은 지원되지 않습니다.
iOS와 Android 모두 네이티브 프로젝트 구성이 필요합니다. cap sync.
앱이 특정되면 Azure 등록, Intune 정책 assign, 리다이렉트 URI, 권한이 남아 있습니다.

Getting Started에서 계속하세요.

이러한 경우, __CAPGO_KEEP_0__-intune을 사용하여 enterprise 운영 및 마이그레이션 계획을 만드세요. Getting Started __CAPGO_KEEP_0__-intune을 사용하여 enterprise 운영 및 마이그레이션 계획을 만드세요. Using @capgo/capacitor-intune capgo native 기능을 사용하는 @capacitor/capgo-intune에 대해 Capgo Enterprise Capgo Enterprise 제품 워크플로에 대해 Ionic Enterprise 플러그인 대체 __CAPGO_KEEP_0__ 제품 워크플로에 대해 Ionic Enterprise 플러그인 대체 Capgo 대체 Capgo 제품 워크플로에 대해 대체 Capgo 컨설팅 Capgo 제품 워크플로에 대해 컨설팅