@capgo/capacitor-login-social

Tutti i login social in un 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
Twitter/X attraverso OAuth 2.0
Provideri OAuth2 e OIDC generici, inclusi GitHub, Microsoft Entra ID, Auth0, Okta, Keycloak e altri server conformi

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

Nota sulla forchetta e sulla migrazione

Questo plugin è iniziato come una forchetta di @codetrix-studio/capacitor-google-authIl pacchetto originale è effettivamente archiviato, quindi Capgo mantiene questo plugin come sostituto supportato.

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

Se stai migrando da Ionic Auth Connect, utilizza il wrapper integrato per il SocialLoginAuthConnect e auth0, azure, cognito, oktaSe stai migrando da Ionic Appflow Social Login, utilizza il wrapper integrato per il onelogin provider names:

Compatibilità

Versione del plugin	Compatibilità Capacitor	Mantentuto
v8.x	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 - Disconnetti.
isLoggedIn - IsLoggedIn.

Pubblico API

Metodo	Descrizione
`initialize`	Avvia il plugin.
`login`	Accedi con il provider selezionato.
`logout`	Esci.
`isLoggedIn`	È effettuata l'accesso.
`getAuthorizationCode`	Ottieni l'autorizzazione corrente code.
`refresh`	Rinnova il token di accesso.
`refreshToken`	Aiuto per il rinnovo del token di accesso OAuth2 per il provider OAuth2 integrato.
`handleRedirectCallback`	Web solo: gestisci la chiamata di callback OAuth e restituisci il risultato elaborato.
`decodeIdToken`	Decodifica un JWT (tipicamente un token ID OIDC) nelle sue affermazioni.
`getAccessTokenExpirationDate`	Converti un timestamp di scadenza del token di accesso (millisecondi dal momento di inizio dell'era attuale) in una stringa di data ISO.
`isAccessTokenAvailable`	Controlla se è disponibile un token di accesso (non vuoto).
`isAccessTokenExpired`	Controlla se un token di accesso è scaduto.
`isRefreshTokenAvailable`	Verifica se è disponibile un token di aggiornamento (non vuoto).
`providerSpecificCall`	Esegui chiamate specifiche del provider.
`getPluginVersion`	Ottieni la versione nativa del plugin Capacitor.
`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>` Per il web, dovresti avere il __CAPGO_KEEP_0__ nella pagina di reindirizzamento per utilizzare un canale di trasmissione per inviare l'URL di reindirizzamento all'app. Qualcosa come: `myapp://oauth_callback/` Per i dispositivi mobili, dovresti avere un URI di reindirizzamento che apre l'app, qualcosa come: `xml <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>myapp</string> </array> </dict> </array>` E assicurati di registrarlo nell'info.plist dell'app: `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>` .

E nel file AndroidManifest.xml:

Sottosezione intitolata “Fonte di Verità” src/definitions.ts Questa referenza è sincronizzata da capacitor-social-login.

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-passkey per il dettaglio di implementazione in @capgo/capacitor-passkey, @capgo/capacitor-biometric-nativo per il dettaglio di implementazione in @capgo/capacitor-biometric-nativo, Autenticazione a due fattori per i dettagli di implementazione in due fattori di autenticazione, e SSO (aziendale) per i dettagli di implementazione in SSO (aziendale).