Pendahuluan
Seksi berjudul “Pendahuluan”@capgo/capacitor-social-login adalah plugin autentikasi sosial semua dalam satu untuk Web, iOS, dan Android.
Itu menerapkan:
- Google Sign-In dengan Manajer Kredensial Android
- Masuk dengan Apple, termasuk OAuth di Android
- Login dengan Facebook menggunakan Facebook SDK saat ini
- Login Twitter/X melalui OAuth 2.0
- Provider OAuth2 dan OIDC umum, termasuk GitHub, Microsoft Entra ID, Auth0, Okta, Keycloak, dan server lain yang kompatibel
Juga merupakan jalur migrasi Capgo untuk aplikasi yang beralih dari Ionic Appflow Social Login atau Ionic Auth Connect
Catatan perubahan dan fork
Bab berjudul “Catatan perubahan dan fork”Plugin ini dimulai sebagai fork dari @codetrix-studio/capacitor-google-authPaket aslinya telah diarsipkan, sehingga Capgo mempertahankan plugin ini sebagai pengganti yang didukung
Jika Anda masih menggunakan @codetrix-studio/capacitor-google-authIkuti petunjuk migrasi Google Auth legacy.
Jika Anda beralih dari Ionic Auth Connect, gunakan fitur built-in SocialLoginAuthConnect penggabungan untuk auth0, azure, cognito, oktadan onelogin nama-nama penyedia:
Kompatibilitas
Bab berjudul “Kompatibilitas”| Versi Plugin | Capacitor kompatibilitas | Dipelihara |
|---|---|---|
| v8.x | v8.x | Ya |
| v7.x | v7.x | Pada permintaan |
| v6.x | v6.x | Tidak |
| v5.x | v5.x | Tidak |
The major version of this plugin follows the major version of Capacitor. For example, use plugin v8 with Capacitor 8. Only the latest major version is actively maintained.
Video Walkthrough
Bagian berjudul “Video Walkthrough”Watch a quick demo of the plugin setup and login flow in aksi.
Kemampuan Utama
Bagian berjudul “Kemampuan Utama”initialize- Inisialisasi plugin.login- Login dengan penyedia yang dipilih.logout- Keluar.isLoggedIn- Apakah Saya Masuk.
Publik API
Bagian berjudul “Publik API”| Metode | Deskripsi |
|---|---|
initialize | Inisialisasi plugin. |
login | Masuk dengan penyedia yang dipilih. |
logout | Keluar. |
isLoggedIn | Apakah Masih Masuk. |
getAuthorizationCode | Ambil otorisasi saat ini code. |
refresh | Perbarui token akses. |
refreshToken | Bantuan token refresh OAuth2 untuk penyedia OAuth2 bawaan. |
handleRedirectCallback | Hanya web: tangani callback redirect OAuth dan kembalikan hasil yang diparsing. |
decodeIdToken | Menguraikan JWT (biasanya token ID OIDC) ke klaim-klaimnya. |
getAccessTokenExpirationDate | Konversi timestamp kedaluwarsa token akses (milisecond sejak epoch) ke string tanggal ISO. |
isAccessTokenAvailable | Periksa jika token akses tersedia (tidak kosong). |
isAccessTokenExpired | Periksa jika token akses telah kedaluwarsa. |
isRefreshTokenAvailable | Periksa jika token refresh tersedia (tidak kosong). |
providerSpecificCall | Jalankan panggilan spesifik penyedia. |
getPluginVersion | Ambil versi plugin native Capacitor. |
openSecureWindow | Buka jendela yang terenkripsi untuk autentikasi OAuth2. Untuk web, Anda harus memiliki code di halaman yang diarahkan untuk menggunakan saluran siaran untuk mengirim URL yang diarahkan ke aplikasi. Contohnya: 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> Untuk mobile, Anda harus memiliki URI yang diarahkan untuk membuka aplikasi, seperti: myapp://oauth_callback/ Pastikan untuk mendaftarkannya di info.plist aplikasi: xml <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>myapp</string> </array> </dict> </array> Pastikan untuk mendaftarkannya di 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> . |
Sumber Kebenaran
Bab berjudul “Sumber Kebenaran”Referensi ini disinkronkan dari src/definitions.ts di dalam capacitor-login sosial.
Teruskan dari @capgo/capacitor-login sosial
Judul bagian “Teruskan dari @capgo/capacitor-login sosial”Jika Anda menggunakan @capgo/capacitor-login sosial untuk merencanakan autentikasi dan alur akun, hubungkannya dengan Menggunakan @capgo/capacitor-login sosial untuk kemampuan asli di Menggunakan @capgo/capacitor-login sosial, @capgo/capacitor-passkey untuk detail implementasi di @capgo/capacitor-passkey, @capgo/capacitor-biometrik asli untuk detail implementasi di @capgo/capacitor-native-biometric, Dua-Faktor Autentikasi untuk detail implementasi di Dua-Faktor Autentikasi, dan SSO (Enterprise) untuk detail implementasi di SSO (Enterprise).