Panoramica
Sezione intitolata “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 generali, 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
Sezione intitolata “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-authsegui le istruzioni del guida di migrazione Auth Google legacy.
Se stai migrando da Ionic Auth Connect, utilizza il wrapper integrato per il SocialLoginAuthConnect e segui le istruzioni del auth0, azure, cognito, oktaguida di migrazione Auth Google legacy onelogin provider nomi:
- Migrazione di Ionic Auth Connect
- Guida alla compatibilità di Auth Connect
- Configurazione di Keycloak
Compatibilità
Sezione intitolata “Compatibilità”| Versione del plugin | Compatibilità Capacitor | Mantenne |
|---|---|---|
| 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.
Guida video
Sezione intitolata “Guida video”Guarda un demo veloce della configurazione e del flusso di accesso del plugin in azione.
Capacità di base
Sottosezione intitolata “Capacità di base”initialize- Inizializza il plugin.login- Accedi con il provider selezionato.logout- Esci.isLoggedIn- IsLoggedIn.
API Pubblico
Sottosezione intitolata “API Pubblico”| Metodo | Descrizione |
|---|---|
initialize | Inizializza il plugin. |
login | Accedi con il provider selezionato. |
logout | Disconnetti. |
isLoggedIn | Esegui il login. |
getAuthorizationCode | Ottieni l'autorizzazione corrente code. |
refresh | Rinnova il token di accesso. |
refreshToken | Aiuto per il rinnovo del token OAuth2 per il provider OAuth2 integrato. |
handleRedirectCallback | Solo web: gestisci la chiamata di callback di OAuth e restituisci il risultato elaborato. |
decodeIdToken | Decodifica un JWT (tipicamente un token ID OIDC) nelle sue dichiarazioni. |
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 | Controlla se è disponibile un token di aggiornamento (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à
Sottosezione intitolata “Fonte di Verità”Questa referenza è sincronizzata da src/definitions.ts in capacitor-social-login.
Continua da @capgo/capacitor-social-login
Sezione intitolata “Continua da @capgo/capacitor-social-login”Se stai utilizzando @capgo/capacitor-social-login per pianificare l'autenticazione e le flussi di account, connettilo con Utilizzando @capgo/capacitor-social-login per la capacità nativa in Utilizzando @capgo/capacitor-social-login, @capgo/capacitor-passkey per il dettaglio di implementazione in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric per il dettaglio di implementazione in @capgo/capacitor-native-biometric, L'autenticazione a due fattori per i dettagli di implementazione in due fattori di autenticazione, e SSO (azienda) per i dettagli di implementazione in SSO (azienda).