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 설정 페이지

요구 사항

Capacitor 8+
Intune iOS와 함께 iOS 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 프로젝트 구성이 필요합니다. Azure 등록, Intune 정책 assign, 리다이렉트 URI, 권한은 앱에 따라 달라집니다. cap sync.
Your Azure 등록, Intune 정책 assign, 리다이렉트 URI, 권한은 앱에 따라 달라집니다.

다음 단계로 진행하세요

이러한 기능을 사용하는 경우 Getting Started 기업 운영 및 이주 계획을 준비하는 경우 Using @capgo/capacitor-intune Using @capgo/capacitor-intune Capgo Enterprise for the product workflow in Capgo Enterprise, Capgo Enterprise Ionic Enterprise 플러그인 대체 Capgo Alternatives Capgo 제품 워크플로우에 대하여 Capgo 대안 및 Capgo 컨설팅 Capgo 제품 워크플로우에 대하여 Capgo 컨설팅