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:
- 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
- Iniciar 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 Capgo para aplicaciones que se están moviendo desde Ionic Appflow Social Login o Ionic Auth Connect.
Nota de fork y migración
Sección titulada “Nota de fork y migración”This plugin comenzó como una bifurcación de @codetrix-studio/capacitor-google-authEl paquete original se considera 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 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 los nombres de proveedor: onelogin Guía de migración de Ionic Auth Connect
- Guía de compatibilidad de Auth Connect
- Configuración de Keycloak
- Guía de migración de autenticación de Google
Compatibilidad
Sección titulada “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 principal de este complemento sigue la versión principal de Capacitor. Por ejemplo, utilice el complemento v8 con Capacitor 8. Solo la versión principal más reciente se mantiene activamente.
Vista previa de video
Título de la sección “Vista previa de video”Mire un demo rápido de la configuración y el flujo de inicio de sesión del complemento en acción.
Capacidades básicas
Título de la secció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
Sección titulada “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 el autorización actual code. |
refresh | Refresque el token de acceso. |
refreshToken | Ayuda de refresco de token OAuth2 para el proveedor de OAuth2 incorporado. |
handleRedirectCallback | Solo web: maneje la llamada de retorno de OAuth y devuelva el resultado analizado. |
decodeIdToken | Desencripte un JWT (generalmente un token de ID OIDC) en sus declaraciones. |
getAccessTokenExpirationDate | Convirta 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 | Abra 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, 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
Sección titulada “Fuente de Verdad”Esta referencia se sincroniza desde src/definitions.ts en capacitor-iniciación de sesión social.
Sigue adelante desde @capgo/capacitor-iniciación de sesión social
Sección titulada “Sigue adelante 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, 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 en dos factores para el detalle de implementación en Autenticación en dos factores, y SSO (Empresas) para el detalle de implementación en SSO (Empresas).