Primeros pasos
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
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.
Instalación
Sección titulada “Instalación”Puedes usar nuestro setup asistido por IA para instalar el plugin. Añade las skills de Capgo a tu herramienta de IA con el siguiente comando:
bunx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-pluginsLuego usa el siguiente prompt:
Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-intune` plugin in my project.Si prefieres la configuración manual, instala el plugin ejecutando estos comandos y sigue las instrucciones de cada plataforma:
-
Instala el paquete
Ventana de terminal bun add @capgo/capacitor-intune -
Sincronizar proyectos nativos
Ventana de terminal bunx cap sync -
Configuración nativa completa de Intune Sigue la guía dedicada Configurar iOS y Configuración de Android páginas. Intune sigue requiriendo configuración nativa de la app host para autenticación intermediada, URIs de redirección, manifiestos, permisos y configuración de MSAL.
Inicio rápido
Sección titulada “Inicio rápido”import { IntuneMAM } from '@capgo/capacitor-intune';
const result = await IntuneMAM.acquireToken({ scopes: ['openid'] });// The result holds sensitive values: use it without logging it.Ejemplo: acquireTokenSilent
Sección titulada “Ejemplo: acquireTokenSilent”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.Ejemplo: registerAndEnrollAccount
Sección titulada “Ejemplo: registerAndEnrollAccount”import { IntuneMAM } from '@capgo/capacitor-intune';
await IntuneMAM.registerAndEnrollAccount({ accountId: 'account-id-123' });Errores comunes
Sección titulada “Errores comunes”- Listeners: elimina los handles cuando se desmonten las pantallas.
- Sync nativo: ejecuta
bunx cap synctras actualizar los plugins. - Fuente de verdad: confianza
src/definitions.tsen el repo de GitHub.
Requisitos
Sección titulada “Requisitos”- Capacitor 8+
- Android con Intune Android SDK
12.0.3 - iOS con Intune iOS SDK
21.5.1 - Target de despliegue de iOS
17.0+
La documentación de Intune de Ionic actualmente indica una fecha límite del 19 de enero de 2026 para apps compiladas con Xcode 26, que requieren Intune iOS SDK 21.1.0+. Este plugin ya utiliza 21.5.1.
Uso básico
Sección titulada “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
Sección titulada “Flujos comunes”Inicio de sesión y registro interactivo
Sección titulada “Inicio de sesión e inscripción interactivos”const auth = await IntuneMAM.acquireToken({ scopes: ['https://graph.microsoft.com/.default'],});
await IntuneMAM.registerAndEnrollAccount({ accountId: auth.accountId,});Renovación de token silenciosa
Sección titulada “Silent token refresh”const token = await IntuneMAM.acquireTokenSilent({ accountId: 'AAD_OBJECT_ID', scopes: ['https://graph.microsoft.com/.default'], forceRefresh: true,});Leer la cuenta registrada actualmente
Sección titulada «Leer la cuenta actualmente registrada»const user = await IntuneMAM.enrolledAccount();Cerrar sesión o borrado selectivo
Sección titulada «Cerrar sesión o borrar selectivamente»await IntuneMAM.logoutOfAccount({ accountId: 'AAD_OBJECT_ID' });await IntuneMAM.deRegisterAndUnenrollAccount({ accountId: 'AAD_OBJECT_ID' });Resumen de API
Sección titulada «Resumen de API»acquireToken(options): Inicia sesión con Microsoft y devuelve el token y los metadatos de la cuenta.acquireTokenSilent(options): Lee un token en caché para una cuenta existente.registerAndEnrollAccount(options): Registra la cuenta de MSAL en Intune y activa la inscripción.loginAndEnrollAccount(): Deja que Intune gestione el flujo de inicio de sesión y registro.appConfig(user): Lee los valores de configuración de la app de Intune para la cuenta.getPolicy(user): Lee la política actual de protección de apps de Intune para la cuenta.groupName(user): Lee el valor comúnGroupNamedel helper de config cuando esté presente.sdkVersion(): Inspecciona las versiones incluidas de Intune y MSAL.
Notas de la plataforma
Sección titulada “Notas de plataforma”- Web no es compatible.
- iOS y Android requieren configuración nativa del proyecto además de
cap sync. - Tu registro de Azure, la asignación de políticas de Intune, los URI de redirección y los permisos siguen siendo específicos de la app.
Continúa desde Getting Started
Sección titulada “Continúa desde Primeros pasos”Si estás usando Primeros pasos para planificar la migración y las operaciones enterprise, conéctalo con Uso de @capgo/capacitor-intune para la funcionalidad nativa en Uso de @capgo/capacitor-intune, Capgo Enterprise para el flujo de trabajo del producto en Capgo Enterprise, Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise, Alternativas a Capgo para el flujo de trabajo del producto en Alternativas a Capgo, y Consultoría de Capgo para el flujo de trabajo de productos en Capgo Consulting.