Ringkasan
Judul bagian “Ringkasan”@capgo/capacitor-social-login adalah plugin autentikasi sosial semua dalam satu untuk Web, iOS, dan Android.
Mengimplementasikan:
- Google Sign-In dengan Manajer Kredensial Android
- Masuk dengan Apple, termasuk OAuth di Android
- Facebook Login dengan Facebook SDK saat ini
- 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 Ionic Appflow Social Login atau Ionic Auth Connect
Catatan Fork dan Migrasi
Bagian berjudul “Catatan Fork dan Migrasi”Plugin ini dimulai sebagai fork dari @codetrix-studio/capacitor-google-authPaket asli efektif diarsipkan, jadi Capgo mempertahankan plugin ini sebagai pengganti yang didukung
Jika Anda masih menggunakan @codetrix-studio/capacitor-google-authIkuti panduan migrasi Google Auth legacy Jika Anda beralih dari Ionic Auth Connect, gunakan wrapper bawaan untuk.
dan SocialLoginAuthConnect Jika Anda beralih dari Ionic Auth Connect, gunakan wrapper bawaan untuk auth0, azure, cognito, oktadan onelogin nama-nama penyedia:
Kompatibilitas
Bagian 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 dari plugin ini mengikuti versi utama dari Capacitor. Misalnya, gunakan plugin v8 dengan Capacitor 8. Hanya versi utama yang aktif terjaga.
Tuturan Video
Bagian berjudul “Tuturan Video”Tonton demo cepat plugin pengaturan dan alur login beraksi.
Kemampuan Utama
Bagian berjudul “Kemampuan Utama”initialize- Inisialisasi plugin.login- Login dengan penyedia yang dipilih.logout- Keluar.isLoggedIn- IsLoggedIn.
Publik API
Bagian berjudul “Publik API”| Metode | Deskripsi |
|---|---|
initialize | Inisialisasi plugin. |
login | Login dengan penyedia yang dipilih. |
logout | Keluar. |
isLoggedIn | Apakah Saya Masuk. |
getAuthorizationCode | Ambil otorisasi saat ini code. |
refresh | Refresh token akses. |
refreshToken | Bantuan refresh-token OAuth2 untuk penyedia OAuth2 bawaan. |
handleRedirectCallback | Hanya web: tangani callback redirect OAuth dan kembalikan hasil yang diparsing. |
decodeIdToken | Menguraikan JWT (biasanya token ID OIDC) menjadi klaim-klaimnya. |
getAccessTokenExpirationDate | Konversi timestamp kedaluwarsa token akses (milisecond sejak epoch) menjadi string tanggal ISO. |
isAccessTokenAvailable | Periksa jika token akses tersedia (tidak kosong). |
isAccessTokenExpired | Periksa jika token akses telah kedaluwarsa. |
isRefreshTokenAvailable | Periksa apakah token refresh tersedia (tidak kosong). |
providerSpecificCall | Jalankan panggilan spesifik penyedia. |
getPluginVersion | Dapatkan versi plugin native Capacitor. |
openSecureWindow | Buka jendela yang terlindungi untuk autentikasi OAuth2. Untuk web, Anda harus memiliki code di halaman yang diarahkan untuk menggunakan saluran siaran untuk mengirim URL yang diarahkan ke aplikasi. Seperti: 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/ Dan pastikan Anda mendaftarkannya di info.plist aplikasi: xml <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>myapp</string> </array> </dict> </array> Dan 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
Judul bagian “Sumber Kebenaran”Referensi ini disinkronkan dari src/definitions.ts di capacitor-social-login.
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 dalam Menggunakan @capgo/capacitor-login-sosial, @capgo/capacitor-passkey untuk detail implementasi dalam @capgo/capacitor-passkey, @capgo/capacitor-biometrik-asli untuk detail implementasi dalam @capgo/capacitor-biometrik-asli, Autentikasi dua faktor untuk detail implementasi di dua faktor autentikasi, dan SSO (Enterprise) untuk detail implementasi di SSO (Enterprise).