Getting Started

Instalación

Puede utilizar nuestra configuración asistida por IA para instalar el plugin. Agregue las Capgo habilidades a su herramienta de IA utilizando el siguiente comando:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Luego utilice la siguiente solicitud:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-intune` plugin in my project.

Si prefiere la configuración manual, instale el complemento ejecutando los siguientes comandos y siga las instrucciones específicas de la plataforma a continuación:

1. Instalar el paquete

   bun add @capgo/capacitor-intune

2. Sincronizar proyectos nativos

   bunx cap sync

3. Configuración nativa completa de Intune Siga las páginas dedicadas iOS setup y Configuración de Android Páginas. Intune todavía requiere configuración nativa de la aplicación host para la autenticación brokerada, URIs de redirección, manifestos, permisos y configuración de MSAL.

Requisitos

• Capacitor 8+
• Android con Intune Android SDK 12.0.3
• iOS con Intune iOS SDK 21.5.1
• Objetivo de implementación de iOS 17.0+

Los documentos de Ionic para Intune actualmente indican un límite de enero 19, 2026 para aplicaciones construidas con Xcode 26, que requieren iOS SDK 21.1.0+. Este plugin ya utiliza 21.5.1.

Uso básico

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

Flujos comunes

Ingreso interactivo y registro

const auth = await IntuneMAM.acquireToken({
  scopes: ['https://graph.microsoft.com/.default'],
});

await IntuneMAM.registerAndEnrollAccount({
  accountId: auth.accountId,
});

Actualización silenciosa de tokens

const token = await IntuneMAM.acquireTokenSilent({
  accountId: 'AAD_OBJECT_ID',
  scopes: ['https://graph.microsoft.com/.default'],
  forceRefresh: true,
});

Leer la cuenta actualmente inscrita

const user = await IntuneMAM.enrolledAccount();

Cerrar sesión o borrar selectivamente

await IntuneMAM.logoutOfAccount({ accountId: 'AAD_OBJECT_ID' });
await IntuneMAM.deRegisterAndUnenrollAccount({ accountId: 'AAD_OBJECT_ID' });

API Resumen

• acquireToken(options): Iniciar inicio de sesión de Microsoft y devolver token más metadatos de cuenta.
• acquireTokenSilent(options): Leer un token caché para una cuenta existente.
• registerAndEnrollAccount(options): Registrar la cuenta de MSAL con Intune y desencadenar la inscripción.
• loginAndEnrollAccount()Deje que Intune dirija el flujo de inicio de sesión y registro.
• appConfig(user)Lea los valores de configuración de la aplicación Intune para la cuenta.
• getPolicy(user): Lee la política de protección de la aplicación Intune actual para la cuenta.
• groupName(user): Lee el valor común GroupName : Ayuda de configuración cuando esté presente.
• sdkVersion(): Inspeccione las versiones de Intune y MSAL empaquetadas.

: Notas de la plataforma

• : No se admite el web.
• : Ambos iOS y Android requieren una configuración de proyecto nativa más allá cap sync.
• Su registro de Azure, la asignación de políticas de Intune, los URIs de redirección y los permisos permanecen específicos de la aplicación.

: Siga adelante desde Inicio

Si estás utilizando Getting Started para planificar la migración y las operaciones empresariales, conecta con Usando @capgo/capacitor-intune para la capacidad nativa en Usando @capgo/capacitor-intune, Capgo Empresas para el flujo de trabajo del producto en Capgo Enterprise, Alternativas del plugin de Ionic Enterprise para el flujo de trabajo del producto en Ionic Enterprise Plugin Alternativas, Capgo Alternativas para el flujo de trabajo del producto en Capgo Alternativas, y Capgo Consultoría para el flujo de trabajo del producto en Capgo Consultoría.