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

Persona Plugin Capacitor

Lancez des vérifications d'identité Persona avec les SDK natifs iOS et Android

Installer

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

Guide

Comment utiliser Persona 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';

API en un coup d'œil

Méthode Description
acquireToken Présente le flux de connexion Microsoft et renvoie 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 Renvoie le compte Intune actuellement enrôlé, si disponible.
deRegisterAndUnenrollAccount Désenregistre le compte d'Intune et déclenche un effacement sélectif le cas échéant.
logoutOfAccount Déconnecte l'utilisateur de MSAL sans désenrôler le compte Intune.
appConfig Récupère la configuration d'application Intune distante pour un compte géré.
getPolicy Récupérez la politique de protection d'application Intune actuellement appliquée pour un compte géré.
groupName Assistant pratique qui résout la GroupName valeur de configuration de l'app si elle est présente.
sdkVersion Retourne les versions natives d'Intune et de MSAL SDK incluses dans 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ésenregistre le compte d'Intune et déclenche 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 version et de listener, 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() lorsque l'écran est démonté, ou IntuneMAM.removeAllListeners() pour supprimer chaque écouteur.

Référence complète

Continuer avec l'utilisation de @capgo/capacitor-intune

Si vous utilisez Utilisation de @capgo/capacitor-intune pour planifier l'authentification et les flux de comptes, connectez-l’à @capgo/capacitor-intune pour les détails d'implémentation dans @capgo/capacitor-intune, Premiers pas pour les détails d'implémentation dans Premiers pas, @capgo/capacitor-social-login pour le détail 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 Persona

Comment installer le plugin Persona dans une application Capacitor ?

Exécutez "bun add @capgo/capacitor-persona" (ou "npm install @capgo/capacitor-persona"), puis lancez "bunx cap sync" pour que les projets iOS et Android prennent en compte le code natif. Importez-le depuis "@capgo/capacitor-persona" dans le code de votre application.

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

Oui. Persona est un package Capacitor, il fonctionne donc avec n'importe quel framework web tournant dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

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

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

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

Oui. Le code source code est public sur GitHub à l'adresse https://github.com/Cap-go/capacitor-persona/ et le package est gratuit à installer via npm. Les rapports de bugs et les pull requests sont les bienvenus.

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

L'installation ou la mise à niveau du plugin modifie le code natif, ce qui nécessite un nouveau build pour les stores. Ensuite, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les live updates de Capgo.

Déployez les changements de Persona 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.

Commencer avec Capgo