Pendahuluan
Judul bagian ini adalah “Pendahuluan”@capgo/capacitor-social-login adalah plugin autentikasi sosial semua dalam satu untuk Web, iOS, dan Android.
Itu menerapkan:
- Google Sign-In dengan Android Credential Manager
- Masuk dengan Apple, termasuk OAuth di Android
- Login Facebook dengan 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 Login Sosial 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 penyedia untuk auth0, azure, cognito, oktadan onelogin 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
Section berjudul “Video Walkthrough”Tonton demo singkat pengaturan plugin dan aliran login dalam aksi.
Kemampuan Utama
Section berjudul “Kemampuan Utama”initialize- Inisialisasi plugin.login- Masuk dengan penyedia yang dipilih.logout- Keluar.isLoggedIn- Apakah Masih Login.
Publik API
Section 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 | Decodifikasi 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 provider. |
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. Contoh 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/ Pastikan untuk 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
Bab berjudul “Sumber Kebenaran”Referensi ini disinkronkan dari src/definitions.ts masuk capacitor-login-sosial.
Teruskan dari @capgo/capacitor-login-sosial
Judul: Teruskan dari @capgo/capacitor-login-sosialJika 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, Autentikasi Dua Faktor untuk detail implementasi di Autentikasi Dua Faktor, dan SSO (Enterprise) untuk detail implementasi di SSO (Enterprise).