@capgo/capacitor-iniciode-sesión-social

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:

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

También es el camino de migración de Capgo para aplicaciones que se están moviendo desde 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 está efectivamente archivado, por lo que Capgo mantiene este plugin como la reemplazo respaldado

Si todavía estás utilizando @codetrix-studio/capacitor-google-authsigue el guía de migración de autenticación de Google legado.

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

Compatibilidad

Versión del plugin	Capacitor compatibilidad	Mantenido
v8.x	v8.x	Sí
v7.x	v7.x	Al 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.

Paso a paso de video

Ver una demo rápida del flujo de configuración y inicio de sesión del plugin en acción.

Capacidades básicas

initialize - Inicializar el plugin.
login - Iniciar sesión con el proveedor seleccionado.
logout - Cerrar sesión.
isLoggedIn - IsLoggedIn.

API Público

Método	Descripción
`initialize`	Inicia el plugin.
`login`	Inicia sesión con el proveedor seleccionado.
`logout`	Cerrar sesión.
`isLoggedIn`	IsLoggedIn.
`getAuthorizationCode`	Obtén la autorización actual code.
`refresh`	Refresca el token de acceso.
`refreshToken`	Ayuda de refresco de token OAuth2 para el proveedor OAuth2 integrado.
`handleRedirectCallback`	Solo web: maneja la llamada de retorno de OAuth y devuelve el resultado analizado.
`decodeIdToken`	Descompone un JWT (generalmente un token ID de OIDC) en sus reclamos.
`getAccessTokenExpirationDate`	Convierte un timestamp de expiración de token de acceso (milisegundos desde epoch) en una cadena de fecha ISO.
`isAccessTokenAvailable`	Verifica si un token de acceso está disponible (no vacío).
`isAccessTokenExpired`	Verifica si un token de acceso ha expirado.
`isRefreshTokenAvailable`	Verifique si un token de refresco está disponible (no vacío).
`providerSpecificCall`	Ejecuta llamadas específicas del proveedor.
`getPluginVersion`	Obtenga la versión nativa del plugin Capacitor.
`openSecureWindow`	Abre una ventana segura para la autenticación OAuth2. Para web, debe 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, debe tener una URI de redirección que abra la aplicación, algo como: `myapp://oauth_callback/` Y asegúrese 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-social-login para planificar la autenticación y los flujos de cuenta, conecta con Usando @capgo/capacitor-social-login para la capacidad nativa en Usando @capgo/capacitor-social-login, @capgo/capacitor-passkey para el detalle de implementación en @capgo/capacitor-passkey, @capgo/capacitor-native-biometric para el detalle de implementación en @capgo/capacitor-native-biometric, Autenticación de dos factores para los detalles de implementación en la autenticación de dos factores, y SSO (Empresas) para los detalles de implementación en SSO (Empresas).