Resumen
Sección titulada “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 Login con el Facebook actual SDK
- 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 Capgo para aplicaciones que se están moviendo desde Ionic Appflow Social Login o Ionic Auth Connect.
Apuntes de fork y migración
Sección titulada “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 respaldado.
Si todavía estás utilizando @codetrix-studio/capacitor-google-auth, sigue las instrucciones de legacy Google Auth migración guide.
Si estás migrando desde Ionic Auth Connect, utiliza la autenticación integrada SocialLoginAuthConnect envoltura para los auth0, azure, cognito, okta, y onelogin nombres de proveedores:
Compatibilidad
Sección titulada “Compatibilidad”| Versión del plugin | Capacitor compatibilidad | Actualizado |
|---|---|---|
| v8.x | v8.x | Sí |
| v7.x | v7.x | A medida que se necesite |
| 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.
Video Walkthrough
Sección titulada “Video Walkthrough”Vea un demostración rápida de la configuración y flujo de inicio de sesión del plugin en acción.
Capacidades básicas
Sección titulada “Capacidades básicas”initialize- Inicialice el plugin.login- Inicie sesión con el proveedor seleccionado.logout- Cierre sesión.isLoggedIn- IsLoggedIn.
Público API
Sección titulada “Público API”| Metodo | Descripción |
|---|---|
initialize | Inicializar el plugin. |
login | Iniciar sesión con el proveedor seleccionado. |
logout | Desconectar. |
isLoggedIn | IsLoggedIn. |
getAuthorizationCode | Obtener la autorización actual code. |
refresh | Refrescar el token de acceso. |
refreshToken | Helper de token de refresco OAuth2 para el proveedor OAuth2 integrado. |
handleRedirectCallback | Web solo: manejar la llamada de retorno de OAuth y devolver el resultado analizado. |
decodeIdToken | Descomprimir 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) en 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 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 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, debe tener una URI de redirección que abre el aplicativo, algo como: myapp://oauth_callback/ Y asegúrese de registrarla en el archivo info.plist del aplicativo: 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.
Título de la sección ‘Fuente de Verdad’.Esta referencia se sincroniza desde src/definitions.ts en capacitor-iniciación-de-sesión-social.
Continúa desde @capgo/capacitor-iniciación-de-sesión-social
Título de la sección “Continúa desde @capgo/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-pasaje para el detalle de implementación en @capgo/capacitor-clave-de-pasaje @capgo/capacitor-biometría-nativa para el detalle de implementación en @capgo/capacitor-autenticación-biográfica-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).