가이드
Capacitor에서 Persona 사용 방법
@capgo/capacitor-intune 사용하기
Microsoft Intune MAM 등록, 앱 보호 정책, 앱 구성, MSAL 인증을 위한 Capacitor plugin
설치
bun add @capgo/capacitor-intune
bunx cap sync
bunx cap sync 플러그인의 네이티브 code를 네이티브 프로젝트에 복사합니다. 플러그인을 업그레이드할 때마다 다시 실행하세요.
가져오기
import { IntuneMAM } from '@capgo/capacitor-intune';
API 한눈에 보기
| 메서드 | 설명 |
|---|---|
acquireToken |
Microsoft 로그인 흐름을 실행하고 액세스 토큰과 계정 메타데이터를 반환합니다. |
acquireTokenSilent |
이전에 로그인한 사용자의 MSAL 캐시에서 토큰을 가져옵니다. |
registerAndEnrollAccount |
이전에 인증된 계정을 Intune에 등록하고 등록 절차를 시작합니다. |
loginAndEnrollAccount |
앱 토큰을 먼저 요청하지 않고 Intune에 사용자 인증 및 등록을 요청합니다. |
enrolledAccount |
현재 등록된 Intune 계정이 있으면 해당 계정을 반환합니다. |
deRegisterAndUnenrollAccount |
Intune에서 계정 등록을 해제하고 해당되는 경우 선택적 초기화를 트리거합니다. |
logoutOfAccount |
Intune 계정 등록을 해제하지 않고 MSAL에서 사용자를 로그아웃합니다. |
appConfig |
관리되는 계정의 원격 Intune 앱 구성을 가져옵니다. |
getPolicy |
관리되는 계정에 대해 현재 적용 중인 Intune 앱 보호 정책을 가져옵니다. |
groupName |
다음을 확인하는 편리한 헬퍼 함수입니다: GroupName 앱 구성 값이 있으면 해당 값을 확인합니다. |
sdkVersion |
이 플러그인에 포함된 네이티브 Intune 및 MSAL SDK 버전을 반환합니다. |
displayDiagnosticConsole |
네이티브 Intune 진단 UI를 표시합니다. |
예시
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' });
위 표에는 12개의 핵심 메서드가 나열되어 있습니다. Listener와 version 헬퍼, 각 메서드의 전체 계약은 다음 문서에 설명되어 있습니다: GitHub 리포지토리.
이벤트 수신
addListener 핸들을 반환합니다. 호출하세요 handle.remove() 화면이 언마운트될 때, 또는 IntuneMAM.removeAllListeners() 모든 리스너를 해제하려면.
전체 레퍼런스
@capgo/capacitor-intune 사용하기 단계부터 계속 진행하세요
사용 중이라면 @capgo/capacitor-intune 사용하기 인증 및 계정 흐름을 설계할 때, 이를 다음 항목과 연결하세요: @capgo/capacitor-intune @capgo/capacitor-intune의 구현 세부 사항은 시작하기 Getting Started의 구현 상세 내용은 @capgo/capacitor-social-login @capgo/capacitor-social-login의 구현 세부 사항은, @capgo/capacitor-passkey @capgo/capacitor-passkey의 구현 세부 사항과 @capgo/capacitor-native-biometric @capgo/capacitor-native-biometric.의 구현 세부 사항은