Aller directement au contenu principal
@capgo/capacitor-intune Authentification & Sécurité Source ouvert

Intune plugin Capacitor

Microsoft Intune MAM, politique de protection des applications, configuration d'application 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

Utilisation de @capgo/capacitor-intune

Plugin Capacitor pour l'enregistrement MAM Intune, les politiques de protection des applications, la configuration des applications et l'authentification MSAL.

Installer

bun add @capgo/capacitor-intune
bunx cap sync

bunx cap sync copie le plugin natif code dans vos projets natifs. Exécutez-l’à nouveau après chaque mise à niveau du plugin.

Importer

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

API en un coup d'œil

Méthode Description
acquireToken Présenter le flux de connexion Microsoft et retourner un jeton d'accès ainsi que les métadonnées du compte.
acquireTokenSilent Obtenir un jeton à partir de la cache MSAL pour un utilisateur déjà connecté.
registerAndEnrollAccount Enregistrer un compte précédemment authentifié avec Intune et démarrer le processus d'enregistrement.
loginAndEnrollAccount Demander à Intune de s'authentifier et d'enregistrer un utilisateur sans demander d'abord un jeton d'application.
enrolledAccount Récupérer le compte Intune actuellement inscrit, si celui-ci est disponible.
deRegisterAndUnenrollAccount Retourner le compte Intune actuellement enregistré, si l'un est disponible.
logoutOfAccount Déconnecter l'utilisateur de MSAL sans déenrôler le compte Intune.
appConfig Déconnecter l'utilisateur de MSAL sans déenregistrer le compte Intune.
getPolicy Récupérer la configuration d'application Intune distante pour un compte géré.
groupName Aide de commodité qui résout le GroupName app configuration value when present.
sdkVersion Renvoyer les versions natives d'Intune et de MSAL SDK bundlées par ce plugin.
displayDiagnosticConsole Show the native Intune diagnostics UI.

Exemples

acquireToken()

Présenter le flux de connexion Microsoft et renvoyer un jeton d'accès ainsi que les métadonnées de 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()

Acquérir un jeton à partir du cache MSAL pour un utilisateur signé précédemment.

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

Enregistrer un compte authentifié précédemment avec Intune et démarrer l'enregistrement.

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

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

loginAndEnrollAccount()

Demander à Intune d'authentifier et d'enregistrer un utilisateur sans demander d'abord un jeton d'application.

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

await IntuneMAM.loginAndEnrollAccount();

enrolledAccount()

Authentifier et enregistrer un utilisateur sans demander d'abord un jeton d'application.

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

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

deRegisterAndUnenrollAccount()

Renvoyer le compte Intune actuellement enregistré, si celui-ci est disponible.

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

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

Les méthodes ci-dessus sont listées. Les aides pour les listeners et les versions, ainsi que la pleine convention de chaque méthode, sont documentées dans le le dépôt GitHub.

Écoutez les événements

addListener renvoie un gestionnaire. Appelez handle.remove() lorsque l'écran est démonté, ou IntuneMAM.removeAllListeners() pour effacer chaque écouteur.

Référence complète

Continuez de Using @capgo/capacitor-intune

Si vous utilisez Utilisation de @capgo/capacitor-intune pour planifier l'authentification et les flux de compte, connectez-l’avec @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 Prise en main, @capgo/capacitor-connexion-social 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-biometrique 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 la commande « bun add @capgo/capacitor-intune » (ou « npm install @capgo/capacitor-intune »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en compte les natives code. Importez-l’à partir de « @capgo/capacitor-intune » dans votre application code.

Fonctionne-t-il avec React, Vue et Angular @capgo/capacitor-intune ?

Oui. Intune est un paquet Capacitor, il fonctionne donc avec tout framework web qui s'exécute à l'intérieur de Capacitor, y compris Ionic, React, Vue, Angular, Svelte et JavaScript pur.

Quelle version de Capacitor est prise en charge par @capgo/capacitor-intune ?

Capgo plugins suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple, plugin v8 avec Capacitor 8). La table de compatibilité dans le README du GitHub liste les versions maintenues.

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

Oui. Le code source code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-intune/ et le paquet est gratuit à installer depuis npm. Les rapports de bogues et les demandes de modification sont les bienvenus.

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

L'installation ou la mise à niveau du plugin modifie les natives code, il faut donc une nouvelle build de l'application. Après cela, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour live de Capgo.

Expédiez les modifications Intune sans attendre la revue de l'application

Once the plugin is in your store build, Capgo live updates push your JavaScript, HTML and CSS changes to users in minutes.

Commencez avec Capgo