Primeros pasos

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

   bun add @capgo/capacitor-intune

2. Sincronizar proyectos nativos

   bunx cap sync

3. Completa la configuración nativa de Intune Sigue las páginas Configurar iOS y Configuración de Android páginas. Intune aún requiere la configuración nativa de la host-app para brokered auth, redirect URIs, manifests, entitlements y la configuración de MSAL.

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

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

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

await IntuneMAM.registerAndEnrollAccount({ accountId: 'account-id-123' });

Errores comunes

• 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.

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 indica un límite del 19 de enero de 2026 para apps con Xcode 26, requiriendo Intune 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

Inicio de sesión y registro interactivo

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

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

Renovación de token silenciosa

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

Leer la cuenta registrada actualmente

const user = await IntuneMAM.enrolledAccount();

Cerrar sesión o borrado selectivo

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

Resumen de API

• acquireToken(options): Inicia el inicio de sesión de Microsoft y devuelve el token y los metadatos de la cuenta.
• acquireTokenSilent(options): Lee un token en caché de una cuenta existente.
• registerAndEnrollAccount(options): Registra la cuenta MSAL en Intune e inicia 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): Leer la política de protección de apps de Intune actual para la cuenta.
• groupName(user): Leer el valor común del GroupName helper de configuración cuando esté presente.
• sdkVersion(): Inspeccionar las versiones de Intune y MSAL incluidas.

Notas de la plataforma

• Web no es compatible.
• Tanto iOS como Android requieren configuración nativa además de cap sync.
• Tu registro en Azure, la asignación de políticas de Intune, los redirect URIs y los entitlements siguen siendo específicos de la app.

Continúa desde Getting Started

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.