Persona plugin Capacitor

Uso de @capgo/capacitor-intune

Plugin de Capacitor para registro en Microsoft Intune MAM, políticas de protección de apps, configuración de apps y autenticación MSAL.

Instalar

bun add @capgo/capacitor-intune
bunx cap sync

bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.

Importar

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

API de un vistazo

Método	Descripción
acquireToken	Muestra el flujo de inicio de sesión de Microsoft y devuelve un access token junto con los metadatos de la cuenta.
acquireTokenSilent	Obtén un token desde la caché de MSAL para un usuario que ya inició sesión.
registerAndEnrollAccount	Registra una cuenta autenticada previamente en Intune e inicia la inscripción.
loginAndEnrollAccount	Pide a Intune que autentique e inscriba a un usuario sin pedir antes un token de app.
enrolledAccount	Devuelve la cuenta de Intune actualmente inscrita, si hay una disponible.
deRegisterAndUnenrollAccount	Desregistra la cuenta de Intune y activa el borrado selectivo cuando corresponda.
logoutOfAccount	Cierra la sesión del usuario en MSAL sin desvincular la cuenta de Intune.
appConfig	Obtén la configuración remota de la app de Intune para una cuenta gestionada.
getPolicy	Obtén la política de protección de aplicaciones de Intune vigente para una cuenta gestionada.
groupName	Helper práctico que resuelve el GroupName valor de configuración de la app si está presente.
sdkVersion	Devuelve las versiones nativas de Intune y MSAL SDK incluidas en este plugin.
displayDiagnosticConsole	Muestra la interfaz de diagnóstico nativa de Intune.

Ejemplos

acquireToken()

Muestra el flujo de inicio de sesión de Microsoft y devuelve un access token junto con los metadatos de la cuenta.

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

const result = await IntuneMAM.acquireToken({ scopes: ['openid'] });
// The result holds sensitive values: use it without logging it.

acquireTokenSilent()

Obtén un token desde la caché de MSAL para un usuario que ya inició sesión.

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

Registra una cuenta autenticada previamente en Intune e inicia la inscripción.

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

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

loginAndEnrollAccount()

Pide a Intune que autentique e inscriba a un usuario sin pedir antes un token de app.

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

await IntuneMAM.loginAndEnrollAccount();

enrolledAccount()

Devuelve la cuenta de Intune actualmente inscrita, si hay una disponible.

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

const result = await IntuneMAM.enrolledAccount();
console.log(result);

deRegisterAndUnenrollAccount()

Desregistra la cuenta de Intune y activa el borrado selectivo cuando corresponda.

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

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

La tabla anterior enumera los 12 métodos principales. Los helpers de listener y de versión, y el contrato completo de cada método, están documentados en la repositorio GitHub.

Escuchar eventos

addListener devuelve un handle. Llama handle.remove() cuando la pantalla se desmonte, o IntuneMAM.removeAllListeners() para limpiar todos los listeners.

Referencia completa

• repositorio GitHub
• Documentación
• Referencia de API

Continúa desde Uso de @capgo/capacitor-intune

Si estás usando Uso de @capgo/capacitor-intune para planificar los flujos de autenticación y de cuenta, conéctalo con @capgo/capacitor-intune para el detalle de implementación en @capgo/capacitor-intune, Primeros pasos para los detalles de implementación en Primeros pasos, @capgo/capacitor-social-login para los detalles de implementación en @capgo/capacitor-social-login, @capgo/capacitor-passkey para los detalles de implementación en @capgo/capacitor-passkey, y @capgo/capacitor-native-biometric para los detalles de implementación en @capgo/capacitor-native-biometric.