@capgo/capacitor-social-login

Alle sozialen Anmeldungen in einem Plugin.

Ü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
Anmeldung bei Apple, einschließlich OAuth auf Android
Facebook-Anmeldung 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 migrieren.

Fork- und Migrationhinweise

Diese Erweiterung begann als Fork von @codetrix-studio/capacitor-google-auth. Das ursprüngliche Paket ist effektiv archiviert, daher Capgo hält diese Erweiterung als unterstützten Ersatz aufrecht.

Wenn Sie noch immer @codetrix-studio/capacitor-google-auth verwenden, folgen Sie den Anleitung zur Legacy-Google-Auth-Migration.

Wenn Sie von Ionic Auth Connect migrieren, verwenden Sie die integrierte SocialLoginAuthConnect Wrapper für die auth0, azure, cognito, oktaund onelogin Anbieternamen:

Kompatibilität

Pluginversion	Capacitor-Kompatibilität	Unterhalten
v8.x	v8.x	Ja
v7.x	v7.x	Zu den Bedürfnissen
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 unterstützt.

Video Walkthrough

Schauen Sie sich ein kurzes Demo der Plugin-Einrichtung und des Login-Flusses an.

Kernfunktionen

initialize - Das Plugin initialisieren.
login - Mit dem ausgewählten Anbieter anmelden.
logout - Abmelden.
isLoggedIn - Ist angemeldet.

Ö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 code-Autorisierungsstatus.
`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 Epoch) 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 Geräte sollten Sie eine Umleitungs-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

Diese Referenz wird von src/definitions.ts in capacitor-social-login.

Wenn Sie “@Capgo/Capgo-social-login” verwenden @capgo/capacitor-social-login Verbinden Sie @Capgo/Capgo-social-login mit Using @capgo/capacitor-social-login for the native capability in Using @capgo/capacitor-social-login, @capgo/capacitor-passkey for the implementation detail in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric für die Implementierungsdetails in @capgo/capacitor-native-biometrisch Zweifaktor-Authentifizierung für die Implementierungsdetails in der Zweifaktor-Authentifizierung und SSO (Unternehmen) für die Implementierungsdetails in SSO (Unternehmen).