@capgo/capacitor-login sociale

Tutti i login social in un plugin.

Panoramica

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

It implements:

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
Fornitori di autenticazione OAuth2 e OIDC generici, inclusi GitHub, Microsoft Entra ID, Auth0, Okta, Keycloak e altri server conformi

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

Note di fork 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 sostituto supportato.

Se stai ancora utilizzando @codetrix-studio/capacitor-google-authseguisci la legacy Google Auth migration guide.

Se stai migrando da Ionic Auth Connect, utilizza il wrapper integrato per il SocialLoginAuthConnect wrapper per il auth0, azure, cognito, okta, and onelogin Nomi dei provider:

Compatibility

Versione del plugin	Compatibilità con Capacitor	Mantenuto
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 il plugin v8 con Capacitor 8. Solo la versione maggiore più recente è attivamente mantenuta.

Video Walkthrough

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`	Inizializza il plugin.
`login`	Accedi con il provider selezionato.
`logout`	Disconnetti.
`isLoggedIn`	IsLoggedIn.
`getAuthorizationCode`	Ottieni l'attuale autorizzazione code.
`refresh`	Rinnova il token di accesso.
`refreshToken`	Assistente per token di refresh OAuth2 per il provider OAuth2 integrato.
`handleRedirectCallback`	Web solo: gestisci la chiamata di callback di 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 epoch) in una stringa di data ISO.
`isAccessTokenAvailable`	Controlla se un token di accesso è disponibile (non vuoto).
`isAccessTokenExpired`	Controlla se un token di accesso è scaduto.
`isRefreshTokenAvailable`	Controlla se un token di refresh è disponibile (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 la web, dovresti avere il code nella pagina di destinazione per utilizzare un canale di broadcast per inviare l'URL di destinazione 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 nell'info.plist dell'app: `xml <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>myapp</string> </array> </dict> </array>` And in the 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 in capacitor-login sociale.

Se stai utilizzando @capgo/capacitor-login sociale per pianificare l'autenticazione e le flussi di account, connettilo con Utilizza @capgo/capacitor-login sociale per la capacità nativa in Utilizzo di @capgo/capacitor-login-social @capgo/capacitor-chiave di accesso 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 il dettaglio di implementazione in Autenticazione a due fattori, e SSO (aziendale) per il dettaglio di implementazione in SSO (aziendale).