@capgo/capacitor-social-login

Tout les logins sociaux en un seul plugin.

Présentation

@capgo/capacitor-social-login est le plugin d'authentification sociale omnicanal pour Web, iOS et Android.

Cela implémente :

Google Sign-In avec le gestionnaire de crédentiels Android
Se connecter avec Apple, y compris OAuth sur Android
Facebook Login avec le Facebook actuel SDK
Twitter/X via OAuth 2.0
Fournisseurs OAuth2 et OIDC génériques, y compris GitHub, Microsoft Entra ID, Auth0, Okta, Keycloak et autres serveurs conformes

C'est également la voie de migration Capgo pour les applications en train de passer de Ionic Appflow Social Login ou Ionic Auth Connect.

Fork et notes de migration

Cette extension a commencé comme un fork de @codetrix-studio/capacitor-google-auth. Le package original est effectivement archivé, donc Capgo maintient cette extension comme la remplaçante prise en charge.

Si vous utilisez toujours @codetrix-studio/capacitor-google-auth, suivez les guide de migration Google Auth legacy.

Si vous migrez de Ionic Auth Connect, utilisez la prise en charge intégrée SocialLoginAuthConnect wrapper pour le auth0, azure, cognito, okta, et onelogin noms des fournisseurs :

Compatibilité

Version du plugin	Capacitor compatibilité	Entretenu
v8.x	v8.x	Oui
v7.x	v7.x	Sur demande
v6.x	v6.x	Non
v5.x	v5.x	Non

La version majeure de ce plugin suit la version majeure de Capacitor. Par exemple, utilisez le plugin v8 avec Capacitor 8. Seule la dernière version majeure est activement maintenue.

Vidéo de démonstration

Regardez une démo rapide de la configuration et du flux de connexion du plugin en action.

Fonctionnalités de base

initialize - Initialiser le plugin.
login - Se connecter avec le fournisseur sélectionné.
logout - Se déconnecter.
isLoggedIn - IsLoggedIn.

Public API

Methodes	Description
`initialize`	Initialiser le plugin.
`login`	Se connecter avec le fournisseur sélectionné.
`logout`	Se déconnecter.
`isLoggedIn`	EstConnecte.
`getAuthorizationCode`	Obtenir l'autorisation actuelle code.
`refresh`	Rafraîchir le jeton d'accès.
`refreshToken`	Aideur de rafraîchissement de jeton OAuth2 pour le fournisseur OAuth2 intégré.
`handleRedirectCallback`	Seul pour le Web : gérer l'appel de rappel de redirection OAuth et retourner le résultat analysé.
`decodeIdToken`	Décodez un JWT (généralement un jeton ID OIDC) dans ses revendications.
`getAccessTokenExpirationDate`	Convertir un timestamp d'expiration de jeton d'accès (millisecondes depuis l'époque) en une chaîne de date ISO.
`isAccessTokenAvailable`	Vérifiez si un jeton d'accès est disponible (non vide).
`isAccessTokenExpired`	Vérifiez si un jeton d'accès est expiré.
`isRefreshTokenAvailable`	Vérifiez si un jeton de renouvellement est disponible (non vide).
`providerSpecificCall`	Exécutez des appels spécifiques au fournisseur.
`getPluginVersion`	Obtenez la version native du plugin Capacitor.
`openSecureWindow`	Ouvrez une fenêtre sécurisée pour l'authentification OAuth2. Pour le web, vous devez avoir le code dans la page redirigée pour utiliser un canal de diffusion pour envoyer l'URL redirigée vers l'application. Quelque chose comme : `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>` Pour les appareils mobiles, vous devez avoir une URI de redirection qui ouvre l'application, quelque chose comme : `myapp://oauth_callback/` Et assurez-vous de l'enregistrer dans le fichier info.plist de l'application : `xml <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>myapp</string> </array> </dict> </array>` Et dans le fichier 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>` .

Source De Vérité

Cette référence est synchronisée depuis src/definitions.ts en capacitor-connexion-social.

Si vous utilisez @capgo/capacitor-connexion-social pour planifier l'authentification et les flux de compte, connectez-l’avec Utilisez @capgo/capacitor-connexion-social pour la capacité native dans Utilisez @capgo/capacitor-connexion-social, @capgo/capacitor-passkey pour le détail d'implémentation dans @capgo/capacitor-passkey, @capgo/capacitor-biométrie-native pour les détails d'implémentation dans @capgo/capacitor-native-biometric Authentification à deux facteurs pour les détails d'implémentation dans l'authentification à deux facteurs, et SSO (Entreprise) pour les détails d'implémentation dans SSO (Entreprise).