시작하기

설치

bun add @capgo/capacitor-intune
bunx cap sync

Import

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

API 개요

acquireToken

Microsoft 로그인 흐름을 보여주고 접근 토큰 및 계정 메타데이터를 반환합니다.

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

await IntuneMAM.acquireToken({} as AcquireTokenOptions);

acquireTokenSilent

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

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

await IntuneMAM.acquireTokenSilent({} as AcquireTokenSilentOptions);

registerAndEnrollAccount

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

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

await IntuneMAM.registerAndEnrollAccount({} as RegisterAndEnrollAccountOptions);

loginAndEnrollAccount

앱 토큰을 요청하지 않고도 사용자를 인증하고 등록하는 Intune을 요청합니다.

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

await IntuneMAM.loginAndEnrollAccount();

enrolledAccount

현재 등록된 Intune 계정을 반환합니다.

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

await IntuneMAM.enrolledAccount();

deRegisterAndUnenrollAccount

Intune에서 계정을 등록 해제하고 선택적 삭제를 트리거합니다.

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

await IntuneMAM.deRegisterAndUnenrollAccount({} as IntuneMAMUser);

logoutOfAccount

MSAL에서 사용자를 로그아웃합니다. Intune 계정은 등록되지 않습니다.

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

await IntuneMAM.logoutOfAccount({} as IntuneMAMUser);

appConfig

관리 계정의远程 Intune 앱 구성 정보를 가져옵니다.

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

await IntuneMAM.appConfig({} as IntuneMAMUser);

getPolicy

관리 계정의 현재 유효한 Intune 앱 보호 정책을 가져옵니다.

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

await IntuneMAM.getPolicy({} as IntuneMAMUser);

groupName

관리 계정의 app 구성 정보가 있는 경우 app 구성 정보를 해독하는 편의 함수입니다. GroupName 클립보드에 복사

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

await IntuneMAM.groupName({} as IntuneMAMUser);

sdkVersion

이 플러그인은 native Intune 및 MSAL SDK 버전을 번들로 제공합니다.

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

await IntuneMAM.sdkVersion();

displayDiagnosticConsole

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

실제 데이터 원천

이 페이지는 플러그인의 src/definitions.ts업스트림에서 pubic API이 변경되면 다시 싱크를 실행하세요.