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 Pengelola Kredensial Android
- Tanda masuk dengan Apple, termasuk OAuth pada Android
- Login Facebook dengan Facebook SDK saat ini
- Login Twitter/X melalui OAuth 2.0
- Pemasok 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 Login Sosial Ionic Appflow atau Ionic Auth Connect
Catatan perubahan kode dan migrasi
Bab berjudul “Catatan perubahan kode dan migrasi”Plugin ini dimulai sebagai perubahan kode 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 yang sudah tidak digunakan.
Jika Anda beralih dari Ionic Auth Connect, gunakan fitur __CAPGO_KEEP_0__ 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 |
Versi utama plugin ini mengikuti versi utama Capacitor. Misalnya, gunakan plugin v8 dengan Capacitor 8. Hanya versi utama yang aktif terjaga.
Video Walkthrough
Bagian berjudul “Video Walkthrough”Saksikan demo singkat pengaturan plugin dan aliran login dalam 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 | Mulai plugin ini. |
login | Masuk dengan penyedia yang dipilih. |
logout | Keluar. |
isLoggedIn | Apakah Masih Masuk. |
getAuthorizationCode | Dapatkan 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 | Decodetik JWT (biasanya token ID OIDC) ke klaim-klaimnya. |
getAccessTokenExpirationDate | Konversi timestamp kedaluwarsa token akses (milisecond sejak epoch) ke string tanggal ISO. |
isAccessTokenAvailable | Periksa apakah token akses tersedia (tidak kosong). |
isAccessTokenExpired | Periksa apakah token akses telah kedaluwarsa. |
isRefreshTokenAvailable | Periksa apakah 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 alur autentikasi dan akun, hubungkannya dengan Menggunakan @capgo/capacitor-login sosial untuk kemampuan asli di Menggunakan @capgo/capacitor-login sosial, @capgo/capacitor-kunci pas untuk detail implementasi di @capgo/capacitor-kunci pas, @capgo/capacitor-biometrik asli untuk detail implementasi di @capgo/capacitor-native-biometric, Autentikasi Dua Faktor untuk detail implementasi di Autentikasi Dua Faktor, dan SSO (Enterprise) untuk detail implementasi di SSO (Enterprise).