시작하기

설치

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

bunx 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

가져오기

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

빠른 시작

import { Persona } from '@capgo/capacitor-persona';

await Persona.startInquiry({});

자주 하는 실수

• 리스너: 화면이 언마운트될 때 핸들을 제거합니다.
• 네이티브 동기화: 실행 bunx cap sync 플러그인 업그레이드 후.
• 신뢰할 수 있는 소스: 신뢰 src/definitions.ts GitHub 레포지토리에서.

API 개요

acquireToken

Microsoft 로그인 흐름을 실행하고 액세스 토큰과 계정 메타데이터를 반환합니다.

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

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

acquireTokenSilent

이전에 로그인한 사용자의 MSAL 캐시에서 토큰을 가져옵니다.

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.

registerAndEnrollAccount

이전에 인증된 계정을 Intune에 등록하고 등록 절차를 시작합니다.

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

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

loginAndEnrollAccount

앱 토큰을 먼저 요청하지 않고 Intune에 사용자 인증 및 등록을 요청합니다.

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

await IntuneMAM.loginAndEnrollAccount();

enrolledAccount

현재 등록된 Intune 계정이 있으면 해당 계정을 반환합니다.

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

const result = await IntuneMAM.enrolledAccount();
console.log(result);

deRegisterAndUnenrollAccount

Intune에서 계정 등록을 해제하고 해당되는 경우 선택적 초기화를 트리거합니다.

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

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

logoutOfAccount

Intune 계정 등록을 해제하지 않고 MSAL에서 사용자를 로그아웃합니다.

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

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

appConfig

관리되는 계정의 원격 Intune 앱 구성을 가져옵니다.

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

const result = await IntuneMAM.appConfig({ accountId: 'account-id-123' });
console.log(result);

getPolicy

관리되는 계정에 대해 현재 적용 중인 Intune 앱 보호 정책을 가져옵니다.

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

const result = await IntuneMAM.getPolicy({ accountId: 'account-id-123' });
console.log(result);

groupName

다음을 확인하는 편리한 헬퍼 함수입니다: GroupName 앱 구성 값이 있으면 해당 값을 확인합니다.

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

const result = await IntuneMAM.groupName({ accountId: 'account-id-123' });
console.log(result);

sdkVersion

이 플러그인에 포함된 네이티브 Intune 및 MSAL SDK 버전을 반환합니다.

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

const result = await IntuneMAM.sdkVersion();
console.log(result);

displayDiagnosticConsole

네이티브 Intune 진단 UI를 표시합니다.

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

await IntuneMAM.displayDiagnosticConsole();

타입 레퍼런스

AcquireTokenOptions

대화형 토큰 획득 옵션.

export interface AcquireTokenOptions {
  /**
   * Scopes to request, for example `https://graph.microsoft.com/.default`.
   */
  scopes: string[];

  /**
   * When true, always show the Microsoft account picker or sign-in UI.
   *
   * @default false
   */
  forcePrompt?: boolean;

  /**
   * Optional login hint for the interactive sign-in flow.
   */
  loginHint?: string;
}

IntuneMAMAcquireToken

export interface IntuneMAMAcquireToken {
  accountId: string;
  accessToken: string;
  accountIdentifier: string;
  idToken?: string;
  username?: string;
  tenantId?: string;
  authority?: string;
}

AcquireTokenSilentOptions

비대화형 토큰 획득 옵션.

export interface AcquireTokenSilentOptions {
  /**
   * Scopes to request, for example `https://graph.microsoft.com/.default`.
   */
  scopes: string[];

  /**
   * Microsoft Entra object ID returned by `acquireToken` or `enrolledAccount`.
   */
  accountId: string;

  /**
   * When true, bypass the cached access token and request a fresh one.
   *
   * @default false
   */
  forceRefresh?: boolean;
}

RegisterAndEnrollAccountOptions

export interface RegisterAndEnrollAccountOptions {
  /**
   * Microsoft Entra object ID returned by `acquireToken`.
   */
  accountId: string;
}

IntuneMAMUser

export interface IntuneMAMUser {
  accountId: string;
  accountIdentifier?: string;
  username?: string;
  tenantId?: string;
  authority?: string;
}

IntuneMAMAppConfig

export interface IntuneMAMAppConfig {
  accountId: string;
  fullData: Record<string, string>[];
  values: Record<string, string>;
  conflicts: string[];
}

IntuneMAMPolicy

export interface IntuneMAMPolicy {
  accountId: string;
  isPinRequired?: boolean;
  isManagedBrowserRequired?: boolean;
  isScreenCaptureAllowed?: boolean;
  isContactSyncAllowed?: boolean;
  isAppSharingAllowed?: boolean;
  isFileEncryptionRequired?: boolean;
  notificationPolicy?: string;
}

IntuneMAMGroupName

export interface IntuneMAMGroupName {
  accountId: string;
  groupName?: string;
}

IntuneMAMVersionInfo

export interface IntuneMAMVersionInfo {
  platform: 'ios' | 'android';
  intuneSdkVersion: string;
  msalVersion?: string;
}

IntuneMAMChangeEvent

export interface IntuneMAMChangeEvent {
  accountId?: string;
}

Source of Truth

이 페이지는 플러그인의 src/definitions.tsupstream에서 public API가 변경되면 sync를 다시 실행하세요.

시작하기 다음 단계

사용 중이라면 시작하기 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 @capgo/capacitor-intune 사용하기 @capgo/capacitor-intune 사용 시 네이티브 기능을 위해, API 개요 구현 세부 사항은 API 개요에서 소개 구현 세부 사항은 소개에서 API 키 API Keys의 구현 세부 사항은, 기기 Devices의 구현 세부 사항은.