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

Persona plugin Capacitor

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

Utilisation de @capgo/capacitor-intune

plugin Capacitor pour l'enregistrement Microsoft Intune MAM, les politiques de protection d'applications, la configuration d'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 à jour 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 authentifié précédemment avec Intune et démarrer l'enregistrement.
loginAndEnrollAccount Demander à Intune d'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 Renvoyer 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 Se déconnecter de MSAL sans déenregistrer le compte Intune.
getPolicy Récupérez la politique de protection d'application Intune actuellement en vigueur pour un compte géré.
groupName Aide de commodité qui résout le GroupName app configuration value when present.
sdkVersion Renvoyez les versions natives Intune et MSAL SDK empaquetées par ce plugin.
displayDiagnosticConsole Show the native Intune diagnostics UI.

Exemples

acquireToken()

Présentez le flux de connexion Microsoft et renvoyez 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()

Obtenir un jeton à partir de la 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()

Inscrivez un compte précédemment authentifié auprès d'Intune et démarrez l'enregistrement.

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

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

loginAndEnrollAccount()

Demandez à Intune de s'authentifier et d'enregistrer un utilisateur sans demander d'abord un jeton d'application.

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

await IntuneMAM.loginAndEnrollAccount();

enrolledAccount()

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

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

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

deRegisterAndUnenrollAccount()

Désinscrivez le compte d'Intune et déclenchez la suppression sélective lorsque cela est applicable.

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

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

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

Écoutez les événements

addListener renvoie un gestionnaire. Appelez handle.remove() lorsque l'écran est démonté, ou IntuneMAM.removeAllListeners() pour supprimer tous les listeners.

Référence complète

Continuez à partir de l'utilisation de @capgo/capacitor-intune

Si vous utilisez Utiliser @capgo/capacitor-intune pour planifier l'authentification et les flux de compte, le connecter avec @capgo/capacitor-intune pour les détails d'implémentation dans @capgo/capacitor-intune, Pour commencer pour les détails d'implémentation dans Pour commencer, @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 Persona

How puis-je installer le plugin Persona dans une application Capacitor?

Exécutez « bun add @capgo/capacitor-persona » (ou « npm install @capgo/capacitor-persona »), puis exécutez « bunx cap sync » afin que les projets iOS et Android prennent en charge les natives code. Importez-l’à partir de « @capgo/capacitor-persona » dans votre application code.

Le plugin @capgo/capacitor-persona fonctionne-t-il avec React, Vue et Angular ?

Oui. Le plugin Persona 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-persona ?

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, plugin v8 avec Capacitor 8). La table de compatibilité dans le README du GitHub liste les versions maintenues.

Le plugin @capgo/capacitor-persona est-il gratuit et open source ?

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

Puis-je mettre à jour code qui utilise Persona 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. Une fois cela fait, les modifications JavaScript, HTML et CSS qui appellent le plugin peuvent être déployées instantanément avec les mises à jour Capgo.

Envoyez les modifications de Persona sans attendre la revue de l'application

Une fois le plugin dans votre magasin de build, Capgo les mises à jour en temps réel déclenchent vos modifications JavaScript, HTML et CSS chez les utilisateurs en quelques minutes.

Démarrer avec Capgo