@capgo/capacitor-login-sosial

Semua login sosial dalam satu plugin.

Ringkasan

@capgo/capacitor-social-login adalah plugin autentikasi sosial semua-in-one 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
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 Fork dan Migrasi

Plugin ini dimulai sebagai fork dari @codetrix-studio/capacitor-google-authPaket aslinya secara efektif diarsipkan, sehingga Capgo mempertahankan plugin ini sebagai pengganti yang didukung

Jika Anda masih menggunakan @codetrix-studio/capacitor-google-auth, ikuti panduan migrasi Google Auth legacy.

Jika Anda beralih dari Ionic Auth Connect, gunakan wrapper bawaan untuk SocialLoginAuthConnect , dan auth0, azure, cognito, okta__CAPGO_KEEP_0__ onelogin nama penyedia layanan:

Kompatibilitas

Versi Plugin	Kompatibilitas Capacitor	Dipertahankan
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.

Panduan Video

Tonton demo cepat pengaturan dan aliran login plugin dalam aksi.

Kemampuan Utama

initialize - Inisialisasi plugin.
login - Login dengan penyedia yang dipilih.
logout - Keluar.
isLoggedIn - IsLoggedIn.

Publik API

Metode	Deskripsi
`initialize`	Inisialisasi plugin.
`login`	Masuk dengan penyedia yang dipilih.
`logout`	Keluar.
`isLoggedIn`	Apakah Saya Masuk.
`getAuthorizationCode`	Ambil otorisasi saat ini code.
`refresh`	Perbarui token akses.
`refreshToken`	Bantuan token refresh OAuth2 untuk penyedia OAuth2 bawaan.
`handleRedirectCallback`	Hanya web: tangani panggilan balik 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`	Cek 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/` 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

Referensi ini disinkronkan dari src/definitions.ts di capacitor-social-login.

Jika Anda menggunakan @capgo/capacitor-social-login untuk merencanakan autentikasi dan alur akun, hubungkannya dengan Menggunakan @capgo/capacitor-social-login untuk kemampuan asli dalam Menggunakan @capgo/capacitor-social-login, @capgo/capacitor-passkey untuk detail implementasi dalam @capgo/capacitor-passkey, @capgo/capacitor-native-biometric untuk detail implementasi dalam @capgo/capacitor-native-biometric, Autentikasi Dua Faktor untuk detail implementasi di dua faktor autentikasi, dan SSO (Enterprise) untuk detail implementasi di SSO (Enterprise).