Présentation
Section intitulée « Présentation »@capgo/capacitor-social-login il s'agit du plugin d'authentification sociale omnicanal pour Web, iOS et Android.
Cela implémente :
- Google Sign-In avec le gestionnaire de crédits 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.
Notes de fork et de migration
Section intitulée “Notes de fork et de migration”Cette extension a commencé comme une 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 Auth Google legacy.
Si vous migrez de Ionic Auth Connect, utilisez la fonctionnalité intégrée SocialLoginAuthConnect wrapper pour le auth0, azure, cognito, okta, et onelogin noms des fournisseurs :
- guide de compatibilité de la migration d'Auth Connect
- guide de compatibilité d'Auth Connect
- paramétrage de Keycloak
Compatibilité
Section intitulée “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
Section intitulée « Vidéo de démonstration »Regardez une démo rapide de la configuration et du flux de connexion du plugin en action.
Capacités de base
Section intitulée « Capacités de base »initialize- Initialiser le plugin.login- Se connecter avec le fournisseur sélectionné.logout- Se déconnecter.isLoggedIn- IsLoggedIn.
Public API
Section intitulée « Public API »| Méthode | Description |
|---|---|
initialize | Initialiser le plugin. |
login | Se connecter avec le fournisseur sélectionné. |
logout | Se déconnecter. |
isLoggedIn | EstConnecté. |
getAuthorizationCode | Obtenir l'autorisation actuelle code. |
refresh | Rafraîchir le jeton d'accès. |
refreshToken | Assistant de jeton de rafraîchissement OAuth2 pour le fournisseur OAuth2 intégré. |
handleRedirectCallback | Seulement en ligne : gérer l'appel de redirection OAuth et retourner le résultat analysé. |
decodeIdToken | Décodez un JWT (généralement un jeton ID OIDC) en 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 d'enregistrer-le 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é
Section intitulée « Source De Vérité »Cette référence est synchronisée à partir de src/definitions.ts en capacitor-connexion-social.
Continuez de là @capgo/capacitor-connexion-social
Titre de la section « Continuez de là @capgo/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-mot-de-passe pour le détail d'implémentation dans @capgo/capacitor-mot-de-passe @capgo/capacitor-biométrie-native pour les détails d'implémentation dans @capgo/capacitor-authentification biométrique native, 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).