Übersicht
Abschnitt mit dem Titel “Übersicht”@capgo/capacitor-social-login Es ist das umfassende Plugin für soziale Authentifizierung für Web, iOS und Android.
Es implementiert:
- Google-Anmelden mit Android-Credential-Manager
- Anmelden bei Apple, einschließlich OAuth auf Android
- Facebook Login mit dem aktuellen Facebook SDK
- Twitter/X über OAuth 2.0
- Generische OAuth2- und OIDC-Anbieter, einschließlich GitHub, Microsoft Entra ID, Auth0, Okta, Keycloak und anderer kompatibler Server
Es ist auch die Capgo-Migration für Apps, die von Ionic Appflow Social Login oder Ionic Auth Connect wechseln.
Fork- und Migrationhinweise
Abschnitt mit dem Titel “Fork- und Migrationhinweise”Dieses Plugin begann als Fork von @codetrix-studio/capacitor-google-auth. Das ursprüngliche Paket ist effektiv archiviert, daher hält Capgo dieses Plugin als unterstützten Ersatz aufrecht.
Wenn Sie noch immer @codetrix-studio/capacitor-google-authverwenden, folgen Sie den Legacy Google Auth-Migration-Anleitung.
Wenn Sie von Ionic Auth Connect migrieren, verwenden Sie die integrierte SocialLoginAuthConnect Wrapper für die auth0, azure, cognito, oktaund onelogin Anbieternamen:
Kompatibilität
Abschnitt mit dem Titel „Kompatibilität“| Pluginversion | Capacitor-Kompatibilität | Unterhalten |
|---|---|---|
| v8.x | v8.x | Ja |
| v7.x | v7.x | Zu bestimmten Zeiten |
| v6.x | v6.x | Nein |
| v5.x | v5.x | Nein |
Die Hauptversion dieses Plugins folgt der Hauptversion von Capacitor. Zum Beispiel verwenden Sie das Plugin v8 mit Capacitor 8. Nur die aktuellste Hauptversion wird aktiv gepflegt.
Video Walkthrough
Abschnitt mit dem Titel “Video Walkthrough”Blicken Sie sich in einem kurzen Demo die Einrichtung und den Login-Fluss des Plugins an.
Hauptfunktionen
Abschnitt mit dem Titel “Hauptfunktionen”initialize- Das Plugin initialisieren.login- Mit dem ausgewählten Anbieter anmelden.logout- Abmelden.isLoggedIn- Ist angemeldet.
Öffentlich API
Abschnitt mit dem Titel “Öffentlich API”| Methode | Beschreibung |
|---|---|
initialize | Initialisieren Sie das Plugin. |
login | Mit dem ausgewählten Anbieter anmelden. |
logout | Abmelden. |
isLoggedIn | IsLoggedIn. |
getAuthorizationCode | Ermitteln Sie den aktuellen Autorisierungscode code. |
refresh | Aktualisieren Sie den Zugriffstoken. |
refreshToken | OAuth2-Refresh-Token-Helfer für den eingebauten OAuth2-Anbieter. |
handleRedirectCallback | Web-only: Behandeln Sie den OAuth-Redirect-Callback und geben Sie das geparste Ergebnis zurück. |
decodeIdToken | Decodieren Sie ein JWT (typischerweise ein OIDC-ID-Token) in seine Ansprüche. |
getAccessTokenExpirationDate | Konvertieren Sie eine Zugriffstoken-Ablaufzeitstempel (Millisekunden seit der Epoche) in eine ISO-Datumszeichenkette. |
isAccessTokenAvailable | Überprüfen Sie, ob ein Zugriffstoken verfügbar ist (nicht leer). |
isAccessTokenExpired | Überprüfen Sie, ob ein Zugriffstoken abgelaufen ist. |
isRefreshTokenAvailable | Überprüfen Sie, ob ein Refresh-Token verfügbar ist (nicht leer). |
providerSpecificCall | Ausführen von Anbieter-spezifischen Aufrufen. |
getPluginVersion | Rufen Sie die native Capacitor-Pluginversion ab. |
openSecureWindow | Öffnen Sie ein sicheres Fenster für die OAuth2-Authentifizierung. Für Web sollten Sie das code in der umgeleiteten Seite haben, um über einen Broadcast-Channel die umgeleitete URL an die App zu senden. Etwas wie: 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> Für mobile, sollten Sie eine Redirect-URI haben, die die App öffnet, etwas wie: myapp://oauth_callback/ Und stellen Sie sicher, dass Sie es in der app’s info.plist eintragen: xml <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>myapp</string> </array> </dict> </array> Und in der Datei 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> . |
Quelle der Wahrheit
Sektion mit dem Titel „Quelle der Wahrheit“Diese Referenz wird von src/definitions.ts in capacitor-social-login.
Weiter mit @capgo/capacitor-social-login
Abschnitt: Weiter mit @capgo/capacitor-social-loginWenn Sie "@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-social-login" für die Planung der Authentifizierung und der Kontoflows verwenden @capgo/capacitor-social-login Verbinden Sie es mit Verwenden Sie @capgo/capacitor-social-login für die native Fähigkeit in Verwenden Sie @capgo/capacitor-social-login @capgo/capacitor-passkey für die Implementierungsdetail in @capgo/capacitor-passkey @capgo/capacitor-native-biometric für die Implementierungsdetails in @capgo/capacitor-native-biometrisch Zwei-Faktor-Authentifizierung für die Implementierungsdetails in der Zwei-Faktor-Authentifizierung und SSO (Unternehmen) für die Implementierungsdetails in SSO (Unternehmen).