@capgo/capacitor-iniciodeiniciodeiniciodeautenticaciónsocial

Inicio

@capgo/capacitor-social-login es el plugin de 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
• Iniciar sesión con Facebook con la actualización de Facebook SDK
• Twitter/X a través de OAuth 2.0
• Proveedores de OAuth2 y OIDC generales, 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 desde Ionic Appflow Social Login o Ionic Auth Connect.

Nota 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 soportado.

Si todavía estás utilizando @codetrix-studio/capacitor-google-auth, sigue las instrucciones de guía de migración de Google Auth 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 Fork and migration notes

• Section titled “Fork and migration notes”
• Guía de compatibilidad de Auth Connect
• Configuración de Keycloak

Compatibilidad

Versión del plugin	Compatibilidad de Capacitor	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 complemento sigue la versión mayor de Capacitor. Por ejemplo, utilice el complemento 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 - Inicializar el plugin.
• login - Iniciar sesión con el proveedor seleccionado.
• logout - Cerrar sesión.
• isLoggedIn - IsLoggedIn.

Público API

Método	Descripción
initialize	Inicializar el plugin.
login	Iniciar 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	Descodifique un JWT (generalmente un token ID de OIDC) en sus reclamos.
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	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 de redirección para utilizar un canal de difusión para enviar la URL de redirección 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-login-social.

Siga adelante desde @capgo/capacitor-login-social

Si estás utilizando @capgo/capacitor-login-social para planificar la autenticación y los flujos de cuenta, conecta 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 los detalles de implementación en SSO (Enterprise).