@capgo/capacitor-social-login

Todos los inicio de sesión sociales en un plugin.

Resumen

@capgo/capacitor-social-login es el plugin de autenticación social todo en uno para Web, iOS y Android.

Implementa:

Iniciar sesión con Google con el Administrador de credenciales de Android
Iniciar sesión con Apple, incluyendo OAuth en Android
Facebook Inicio de sesión con el Facebook actual SDK
Twitter/X a través de OAuth 2.0
Proveedores OAuth2 y OIDC generales, incluyendo GitHub, Microsoft Entra ID, Auth0, Okta, Keycloak y otros servidores compatibles

También es el camino de migración Capgo para aplicaciones que se están moviendo desde Ionic Appflow Inicio de sesión social o Ionic Auth Connect.

Apuntes de fork y migración

Este plugin comenzó como un fork de @codetrix-studio/capacitor-google-auth. El paquete original está efectivamente archivado, por lo que Capgo mantiene este plugin como la reemplazo apoyado.

Si todavía está utilizando @codetrix-studio/capacitor-google-auth, siga las instrucciones de Guía de migración de autenticación de Google legado.

Si está migrando desde Ionic Auth Connect, utilice la autenticación integrada SocialLoginAuthConnect envoltura para los auth0, azure, cognito, okta, y onelogin nombres de proveedores:

Compatibilidad

Versión del plugin	Capacitor compatibilidad	Actualizado
v8.x	v8.x	Sí
v7.x	v7.x	Al requerimiento
v6.x	v6.x	No
v5.x	v5.x	No

The major version of this plugin follows the major version of Capacitor. For example, use plugin v8 with Capacitor 8. Only the latest major version is actively maintained.

Video Walkthrough

Vea un demo rápido de la configuración y flujo de inicio de sesión del plugin en acción.

Capacidades básicas

initialize - Inicialice el plugin.
login - Inicie sesión con el proveedor seleccionado.
logout - Cierre sesión.
isLoggedIn - IsLoggedIn.

Público API

Metodo	Descripción
`initialize`	Inicializa el plugin.
`login`	Iniciar sesión con el proveedor seleccionado.
`logout`	Desconectar.
`isLoggedIn`	IsLoggedIn.
`getAuthorizationCode`	Obtén la autorización actual code.
`refresh`	Refresca el token de acceso.
`refreshToken`	Helper de token de actualización OAuth2 para el proveedor OAuth2 integrado.
`handleRedirectCallback`	Solo web: maneja la llamada de retorno de OAuth y devuelve el resultado analizado.
`decodeIdToken`	Descodifica un JWT (generalmente un token ID OIDC) en sus reclamos.
`getAccessTokenExpirationDate`	Convierte un timestamp de expiración de token de acceso (milisegundos desde la era) en una cadena de fecha ISO.
`isAccessTokenAvailable`	Verificar si un token de acceso está disponible (no vacío).
`isAccessTokenExpired`	Verificar si un token de acceso ha expirado.
`isRefreshTokenAvailable`	Verificar si un token de refresco está disponible (no vacío).
`providerSpecificCall`	Ejecutar llamadas específicas del proveedor.
`getPluginVersion`	Obtener la versión nativa del plugin Capacitor.
`openSecureWindow`	Abre una ventana segura para la autenticación OAuth2. Para web, debes tener el code en la página de redirección para utilizar un canal de difusión para enviar la URL de redirección al aplicativo. Algo como: `html <html> <head></head> <body> <script> const searchParams = new URLSearchParams(location.search) if (searchParams.has("code")) { new BroadcastChannel("my-channel-name").postMessage(location.href); window.close(); } </script> </body> </html>` Para móviles, debes tener una URI de redirección que abra la aplicación, algo como: `myapp://oauth_callback/` Y asegúrate de registrarla en el archivo info.plist de la aplicación: `xml <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>myapp</string> </array> </dict> </array>` Y en el archivo AndroidManifest.xml: `xml <activity> <intent-filter> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:host="oauth_callback" android:scheme="myapp" /> </intent-filter> </activity>` .

Fuente de Verdad.

Esta referencia se sincroniza desde src/definitions.ts en capacitor-iniciación-de-sesión-social.

Si estás utilizando @capgo/capacitor-iniciación-de-sesión-social para planificar la autenticación y los flujos de cuenta, conecta con Usando @capgo/capacitor-iniciación-de-sesión-social para la capacidad nativa en Usando @capgo/capacitor-iniciación-de-sesión-social @capgo/capacitor-clave-de-usuario para el detalle de implementación en @capgo/capacitor-clave-de-usuario @capgo/capacitor-biometría-nativa para el detalle de implementación en @capgo/capacitor-biometría nativa, Dos factor de autenticación para el detalle de implementación en la autenticación de dos factores, y SSO (Empresas) para el detalle de implementación en SSO (Empresas).