@capgo/capacitor-social-login

All sozialen Logins in einer Plugin.

Übersicht

@capgo/capacitor-social-login ist das umfassende Plugin für soziale Authentifizierung für Web, iOS und Android.

Es implementiert:

Google-Anmeldung mit Android-Kreditmanager
Mit Apple anmelden, 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 der Capgo Migrationsweg für Apps, die von Ionic Appflow Social Login oder Ionic Auth Connect wechseln.

Fork und Migrationshinweise

Dieses Plugin begann als ein Fork von @codetrix-studio/capacitor-google-authDas 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-auth, folgen Sie der.

legacy Google Auth Migrationanleitung SocialLoginAuthConnect Wenn Sie von Ionic Auth Connect migrieren, verwenden Sie die integrierte auth0, azure, cognito, oktaWrapper für die onelogin , und

Kompatibilität

Pluginversion	Capacitor-Kompatibilität	Unterhalten
v8.x	v8.x	Ja
v7.x	v7.x	Nach Bedarf
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

Blicken Sie sich einen schnellen Demo-Blick auf die Plugin-Einrichtung und -Anmeldeablauf an.

Kernfunktionen

initialize - Initialisieren Sie das Plugin.
login - Mithilfe des ausgewählten Providers anmelden.
logout - Abmelden.
isLoggedIn - IsLoggedIn.

Öffentlich API

Methode	Beschreibung
`initialize`	Das Plugin initialisieren.
`login`	Mit dem ausgewählten Anbieter anmelden.
`logout`	Abmelden.
`isLoggedIn`	Angemeldet.
`getAuthorizationCode`	Ermitteln Sie den aktuellen code-Autorisierungscode.
`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 Epochenzeit) 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`	Ermitteln Sie die native Capacitor-Pluginversion.
`openSecureWindow`	Opens a secured window for OAuth2 authentication. For web, you should have the code in the redirected page to use a broadcast channel to send the redirected url to the app Something like: `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>` Bei Web-Anwendungen sollten Sie das __CAPGO_KEEP_0__-Plugin in der umgeleiteten Seite haben, um über einen Broadcast-Channel die umgeleitete URL an die App zu senden. Etwas wie: `myapp://oauth_callback/` Bei mobilen Anwendungen sollten Sie eine Umleitungs-URI haben, die die App öffnet, etwas wie: `xml <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>myapp</string> </array> </dict> </array>` Und stellen Sie sicher, dass Sie es in der app’s info.plist eintragen: `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>` .

Und in der Datei AndroidManifest.xml:

Abschnitt mit dem Titel „Quelle der Wahrheit“ src/definitions.ts Diese Referenz wird von capacitor-social-login.

Wenn Sie "@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-social-login" verwenden @capgo/capacitor-social-login um die Authentifizierung und die Kontenflüsse zu planen, verbinden Sie es mit Verwenden Sie @capgo/capacitor-social-login für die native Fähigkeit in Verwendung von @capgo/capacitor-social-login @capgo/capacitor-passkey für die Implementierungsdetail in @capgo/capacitor-passkey @capgo/capacitor-native-biometric für die Implementierungsdetail in @capgo/capacitor-native-biometric Zwei-Faktor-Authentifizierung für die Implementierungsdetail in Zwei-Faktor-Authentifizierung Einbindung (Unternehmen) für die Implementierungsdetails in Einbindung (Unternehmen).