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

Todos los inicio de sesión sociales en una sola extensión.

Resumen

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

Implementa:

Iniciar sesión con Google, incluyendo 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 el camino de migración 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-auth, sigue las instrucciones del legacy Google Auth migración guide.

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

Compatibilidad

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

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

Habilidades 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`	Esta conectado.
`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`	Desencripta un JWT (generalmente un token ID de OIDC) en sus declaraciones.
`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 de redirección para utilizar un canal de difusión para enviar la URL de redirección 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 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-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-de-pass para el detalle de implementación en @capgo/capacitor-clave-de-pass, @capgo/capacitor-biometría-nativa para el detalle de implementación en @capgo/capacitor-biometría-nativa, La 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).