@capgo/capacitor-login-social

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

Resumen

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

Implementa:

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

También es la Capgo de migración para aplicaciones que se están moviendo de Ionic Appflow Social Login o Ionic Auth Connect.

Notas de fork y migración

Este plugin comenzó como un fork de @codetrix-studio/capacitor-google-authEl paquete original se encuentra archivado, por lo que Capgo mantiene este plugin como la reemplazo soportado.

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

Si estás migrando desde Ionic Auth Connect, utiliza el wrapper integrado para el SocialLoginAuthConnect y los nombres de proveedores: auth0, azure, cognito, okta, and onelogin nombres de proveedores:

Compatibilidad

Versión del plugin	Capacitor compatibilidad	Mantenido
v8.x	v8.x	Sí
v7.x	v7.x	A demanda
v6.x	v6.x	No
v5.x	v5.x	No

La versión mayor de este plugin sigue la versión mayor de Capacitor. Por ejemplo, utilice el plugin v8 con Capacitor 8. Solo la versión mayor más reciente se mantiene activamente.

Tutoriales de video

Mire 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 - Cerrar sesión.
isLoggedIn - IsLoggedIn.

Público API

Método	Descripción
`initialize`	Inicialice el plugin.
`login`	Inicie sesión con el proveedor seleccionado.
`logout`	Cerrar sesión.
`isLoggedIn`	IsLoggedIn.
`getAuthorizationCode`	Obtenga la autorización actual code.
`refresh`	Refresque el token de acceso.
`refreshToken`	Helper de token de actualización OAuth2 para el proveedor OAuth2 integrado.
`handleRedirectCallback`	Solo web: maneje la llamada de retorno de OAuth y devuelva el resultado analizado.
`decodeIdToken`	Desencripte un JWT (generalmente un token ID de OIDC) en sus declaraciones.
`getAccessTokenExpirationDate`	Convertir un timestamp de expiración de token de acceso (milisegundos desde epoch) a una cadena de fecha ISO.
`isAccessTokenAvailable`	Verifique si un token de acceso está disponible (no vacío).
`isAccessTokenExpired`	Verifique si un token de acceso ha expirado.
`isRefreshTokenAvailable`	Verifique si un token de actualización está disponible (no vacío).
`providerSpecificCall`	Ejecute llamadas específicas del proveedor.
`getPluginVersion`	Obtenga la versión nativa Capacitor del plugin.
`openSecureWindow`	Abre una ventana segura para la autenticación OAuth2. Para web, debes tener el code en la página redirigida para utilizar un canal de difusión para enviar la URL redirigida a la aplicación 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-social-login.

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