@capgo/capacitor-login-social

Tutti i login social in un unico plugin.

Panoramica

@capgo/capacitor-social-login è il plugin di autenticazione sociale tuttofare per Web, iOS e Android.

Esegue:

Google Sign-In con Android Credential Manager
Accedi con Apple, incluso OAuth su Android
Facebook Login con il corrente Facebook SDK
Login Twitter/X tramite OAuth 2.0
Provider OAuth2 e OIDC generici, inclusi GitHub, Microsoft Entra ID, Auth0, Okta, Keycloak e altri server conformi

È anche il Capgo percorso di migrazione per le app che passano da Ionic Appflow Social Login o Ionic Auth Connect.

Note di forking e migrazione

Questo plugin è iniziato come un fork di @codetrix-studio/capacitor-google-auth. Il pacchetto originale è effettivamente archiviato, quindi Capgo mantiene questo plugin come sostituzione supportata.

Se stai ancora utilizzando @codetrix-studio/capacitor-google-auth, segui le istruzioni del guida di migrazione dell'autenticazione Google legacy.

Se stai migrando da Ionic Auth Connect, utilizza la funzionalità integrata SocialLoginAuthConnect wrapper per il auth0, azure, cognito, okta, e onelogin nomi dei provider:

Sezione intitolata “Compatibilità”

__CAPGO_KEEP_0__ compatibilità	Capacitor compatibility	v8.x
Plugin version	v8.x	Sì
v7.x	v7.x	A richiesta
v6.x	v6.x	No
v5.x	v5.x	No

La versione maggiore di questo plugin segue la versione maggiore di Capacitor. Ad esempio, utilizzare plugin v8 con Capacitor 8. Solo la versione maggiore più recente è attivamente mantenuta.

Video Guida Passo Dopo Passo

Guarda un demo veloce della configurazione e del flusso di accesso del plugin in azione.

Capacità di Base

initialize - Inizializza il plugin.
login - Accedi con il provider selezionato.
logout - Esci.
isLoggedIn - IsLoggedIn.

Pubblico API

Metodo	Descrizione
`initialize`	Avvia il plugin.
`login`	Accedi con il provider selezionato.
`logout`	Disconnetti.
`isLoggedIn`	IsLoggedIn.
`getAuthorizationCode`	Ottieni l'autorizzazione corrente code.
`refresh`	Aggiorna il token di accesso.
`refreshToken`	Assistente per il token di refresh OAuth2 per il provider OAuth2 integrato.
`handleRedirectCallback`	Solo web: gestisci la chiamata di callback OAuth e restituisci il risultato elaborato.
`decodeIdToken`	Decodifica un JWT (tipicamente un token ID OIDC) nei suoi claim.
`getAccessTokenExpirationDate`	Converti un timestamp di scadenza del token di accesso (millisecondi dal epoch) in una stringa di data ISO.
`isAccessTokenAvailable`	Verifica se è disponibile un token di accesso (non vuoto).
`isAccessTokenExpired`	Verifica se un token di accesso è scaduto.
`isRefreshTokenAvailable`	Verifica se è disponibile un token di refresh (non vuoto).
`providerSpecificCall`	Esegui chiamate specifiche del provider.
`getPluginVersion`	Ottieni la versione nativa del plugin Capacitor.
`openSecureWindow`	Apre una finestra protetta per l'autenticazione OAuth2. Per il web, dovresti avere il code nella pagina di reindirizzamento per utilizzare un canale di broadcast per inviare l'URL di reindirizzamento all'app. Qualcosa come: `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>` Per i dispositivi mobili, dovresti avere un URI di reindirizzamento che apre l'app, qualcosa come: `myapp://oauth_callback/` E assicurati di registrarlo nel file info.plist dell'app: `xml <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>myapp</string> </array> </dict> </array>` E nel file 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>` .

Fonte di Verità

Questa referenza è sincronizzata da src/definitions.ts Inizia capacitor-login-social.

Se stai utilizzando @capgo/capacitor-login-social per pianificare l'autenticazione e le flussi di account, connettilo con Utilizza @capgo/capacitor-login-social per la capacità nativa in Utilizza @capgo/capacitor-login-social @capgo/capacitor-chiave-pass per il dettaglio di implementazione in @capgo/capacitor-chiave-pass @capgo/capacitor-biometria-nativa per i dettagli di implementazione in @capgo/capacitor-autenticazione biometrica nativa, Autenticazione a due fattori per i dettagli di implementazione in Autenticazione a due fattori, e SSO (aziendale) per i dettagli di implementazione in SSO (aziendale).