Aller au contenu principal
@capgo/capacitor-intune Auth & sécurité Open source

Intune Plugin Capacitor

Microsoft Intune MAM, stratégies de protection des applications, configuration d'app et authentification MSAL pour Capacitor

Installer

bun add @capgo/capacitor-intune bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-intune
  • pnpm add @capgo/capacitor-intune
  • yarn add @capgo/capacitor-intune

Guide

Comment utiliser Intune dans Capacitor

Utiliser @capgo/capacitor-intune

Plugin Capacitor pour l'enrôlement Microsoft Intune MAM, les politiques de protection d'app, la configuration d'app et l'authentification MSAL.

Installer

bun add @capgo/capacitor-intune
bunx cap sync

bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.

Importer

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

Aperçu de API

Méthode Description
acquireToken Lance le flux de connexion Microsoft et retourne un token d'accès ainsi que les métadonnées du compte.
acquireTokenSilent Récupère un token depuis le cache MSAL pour un utilisateur déjà connecté.
registerAndEnrollAccount Enregistre un compte précédemment authentifié auprès d'Intune et lance l'enrôlement.
loginAndEnrollAccount Demander à Intune d'authentifier et d'enrôler un utilisateur sans demander de token d'application au préalable.
enrolledAccount Retourne le compte Intune actuellement enrôlé, si disponible.
deRegisterAndUnenrollAccount Désenregistrez le compte d'Intune et déclenchez un effacement sélectif le cas échéant.
logoutOfAccount Déconnectez l'utilisateur de MSAL sans désinscrire le compte Intune.
appConfig Récupérez la configuration d'application Intune distante pour un compte géré.
getPolicy Récupère la politique de protection d'application Intune en vigueur pour un compte géré.
groupName Fonction utilitaire qui résout la GroupName valeur de configuration de l'app si présente.
sdkVersion Retourne les versions natives d'Intune et de MSAL SDK embarquées par ce plugin.
displayDiagnosticConsole Affiche l'interface de diagnostic native d'Intune.

Exemples

acquireToken()

Lance le flux de connexion Microsoft et retourne un token d'accès ainsi que les métadonnées du compte.

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

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

acquireTokenSilent()

Récupère un token depuis le cache MSAL pour un utilisateur déjà connecté.

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

Enregistre un compte précédemment authentifié auprès d'Intune et lance l'enrôlement.

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

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

loginAndEnrollAccount()

Demander à Intune d'authentifier et d'enrôler un utilisateur sans demander de token d'application au préalable.

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

await IntuneMAM.loginAndEnrollAccount();

enrolledAccount()

Retourne le compte Intune actuellement enrôlé, si disponible.

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

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

deRegisterAndUnenrollAccount()

Désenregistrez le compte d'Intune et déclenchez un effacement sélectif le cas échéant.

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

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

Le tableau ci-dessus liste les 12 méthodes principales. Les helpers de listener et de version, ainsi que le contrat complet de chaque méthode, sont documentés dans la dépôt GitHub.

Écouter les événements

addListener renvoie un handle. Appelez handle.remove() lors du démontage de l'écran, ou IntuneMAM.removeAllListeners() pour supprimer tous les listeners.

Référence complète

Continuer depuis « Utiliser @capgo/capacitor-intune »

Si vous utilisez Utiliser @capgo/capacitor-intune pour planifier les flux d'authentification et de compte, le connecter à @capgo/capacitor-intune pour les détails d'implémentation dans @capgo/capacitor-intune, Prise en main pour les détails d'implémentation dans Getting Started @capgo/capacitor-social-login pour les détails d'implémentation dans @capgo/capacitor-social-login @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey, et @capgo/capacitor-native-biometric pour les détails d'implémentation dans @capgo/capacitor-native-biometric.

FAQ

FAQ du plugin Intune

Comment installer le plugin Intune dans une application Capacitor ?

Exécutez « bun add @capgo/capacitor-intune » (ou « npm install @capgo/capacitor-intune »), puis lancez « bunx cap sync » pour que les projets iOS et Android intègrent le code natif. Importez-le depuis « @capgo/capacitor-intune » dans votre code.

Est-ce que @capgo/capacitor-intune fonctionne avec React, Vue et Angular ?

Oui. Intune est un package Capacitor, il fonctionne donc avec n'importe quel framework web qui s'exécute dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version de Capacitor est supportée par @capgo/capacitor-intune ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-intune est gratuit et open source ?

Oui. Le code source est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-intune/ et le package s'installe gratuitement depuis npm. Les rapports de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code utilisant Intune sans passer par une revue de l'App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les changements Intune sans attendre la validation de l'app

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo