Saltar al contenido principal
@capgo/capacitor-persona Autenticación & Seguridad Fuente abierta

Persona plugin de Capacitor

Inicia consultas de verificación de identidad de Persona con SDK nativos de iOS y Android

Instalar

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

Guía

Cómo usar Persona en Capacitor

Usando @capgo/capacitor-intune

El plugin Capacitor para Microsoft Intune MAM de inscripción, políticas de protección de aplicaciones, configuración de aplicaciones y autenticación de MSAL.

Instalar

bun add @capgo/capacitor-intune
bunx cap sync

bunx cap sync Copia el plugin nativo code en tus proyectos nativos. Ejecútalo nuevamente después de cada actualización del plugin.

Importar

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

API en resumen

Método Descripción
acquireToken Presenta el flujo de inicio de sesión de Microsoft y devuelve un token de acceso junto con los metadatos de la cuenta.
acquireTokenSilent Obtener un token del caché de MSAL para un usuario que se ha registrado previamente.
registerAndEnrollAccount Registrar una cuenta autenticada previamente con Intune y comenzar con la inscripción.
loginAndEnrollAccount Preguntar a Intune que autentique y enrole a un usuario sin solicitar primero un token de aplicación.
enrolledAccount Devuelve la cuenta de Intune actualmente inscrita, si está disponible.
deRegisterAndUnenrollAccount Deshabilita la cuenta de Intune y desencadena el borrado selectivo cuando sea aplicable.
logoutOfAccount Desconecta al usuario de MSAL sin desinscribir la cuenta de Intune.
appConfig Saca la configuración de la aplicación de Intune remota para una cuenta administrada.
getPolicy Saca la política de protección de aplicaciones de Intune efectiva actualmente para una cuenta administrada.
groupName Ayuda de conveniencia que resuelve el GroupName app configuration value when present.
sdkVersion Regresa las versiones nativas de Intune y MSAL SDK empaquetadas por este plugin.
displayDiagnosticConsole Muestre la interfaz de diagnósticos nativa de Intune.

Examples

acquireToken()

Presenta el flujo de inicio de sesión de Microsoft y devuelve un token de acceso junto con los metadatos de 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 del caché de MSAL para un usuario previamente conectado.

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

Registre una cuenta previamente autenticada con Intune y comience con la inscripción.

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

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

loginAndEnrollAccount()

Pida a Intune que autentique y enrole a un usuario sin solicitar primero un token de aplicación.

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

await IntuneMAM.loginAndEnrollAccount();

enrolledAccount()

Devuelve la cuenta de Intune actualmente inscrita, si está disponible.

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

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

deRegisterAndUnenrollAccount()

Deseconecte la cuenta de Intune y active el borrado selectivo cuando sea aplicable.

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

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

La tabla anterior enumera los 12 métodos básicos. Los ayudantes de escucha y versión, así como la documentación completa de cada método, se encuentran en el repositorio de GitHub.

Escuche eventos

addListener devuelve un manejador. Llame handle.remove() cuando se desmonte la pantalla, o IntuneMAM.removeAllListeners() para eliminar todos los escuchadores.

Referencia completa

Sigue adelante desde el uso de @capgo/capacitor-intune

Si estás utilizando Usando @capgo/capacitor-intune Para planificar la autenticación y los flujos de cuenta, conecta @capgo/capacitor-intune para los detalles de implementación en @capgo/capacitor-intune Getting Started para los detalles de implementación en Inicio @capgo/capacitor-login-social para los detalles de implementación en @capgo/capacitor-login-social @capgo/capacitor-clave de acceso para la implementación detallada en @capgo/capacitor-passkey, y @capgo/capacitor-nativo-biometria para la implementación detallada en @capgo/capacitor-native-biometric.

FAQ

FAQ de plugin Persona

Cómo instalo el plugin Persona en una aplicación Capacitor?

Ejecuta "bun add @capgo/capacitor-persona" (o "npm install @capgo/capacitor-persona"), luego ejecuta "bunx cap sync" para que los proyectos iOS y Android capturen el code nativo. Importa desde "@capgo/capacitor-persona" en tu aplicación code.

¿Funciona @capgo/capacitor-persona con React, Vue y Angular?

Sí. Persona es un paquete Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-persona?

Los plugins Capgo siguen la versión mayor de Capacitor: utiliza la versión mayor del plugin que coincida con tu versión mayor de Capacitor (por ejemplo, plugin v8 con Capacitor 8). La tabla de compatibilidad en el README del GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-persona gratuito y de código abierto?

Sí. El código fuente code está público en GitHub en https://github.com/Cap-go/capacitor-persona/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de cambios.

Puedo actualizar code que utiliza Persona sin una revisión de la Tienda?

Instalar o actualizar el complemento cambia el código nativo code, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios en JavaScript, HTML y CSS que llaman al complemento pueden enviar actualizaciones en vivo con Capgo instantáneamente.

Envía cambios de Persona sin esperar a la revisión del app

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían los cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Inicia con Capgo