Saltar al contenido

Primeros pasos

GitHub

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:

Ventana de terminal
bunx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Luego 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:

  1. Instala el paquete

    Ventana de terminal
    bun add @capgo/capacitor-intune
  2. Sincronizar proyectos nativos

    Ventana de terminal
    bunx cap sync
  3. 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.

import { IntuneMAM } from '@capgo/capacitor-intune';
const result = await IntuneMAM.acquireToken({ scopes: ['openid'] });
// The result holds sensitive values: use it without logging it.
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.
import { IntuneMAM } from '@capgo/capacitor-intune';
await IntuneMAM.registerAndEnrollAccount({ accountId: 'account-id-123' });
  • Listeners: elimina los handles cuando se desmonten las pantallas.
  • Sync nativo: ejecuta bunx cap sync tras actualizar los plugins.
  • Fuente de verdad: confianza src/definitions.ts en el repo de GitHub.
  • 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.

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 });
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,
});
const user = await IntuneMAM.enrolledAccount();
await IntuneMAM.logoutOfAccount({ accountId: 'AAD_OBJECT_ID' });
await IntuneMAM.deRegisterAndUnenrollAccount({ accountId: 'AAD_OBJECT_ID' });
  • 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ún GroupName del helper de config cuando esté presente.
  • sdkVersion(): Inspecciona las versiones incluidas de Intune y MSAL.
  • 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.

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.