@capgo/capacitor-login sosial

Tunjukkan semua login sosial dalam satu plugin.

Overview

@capgo/capacitor-social-login adalah plugin autentikasi sosial semua dalam satu untuk Web, iOS, dan Android.

Mengimplementasikan:

Login Google dengan Pengelola Kredensial Android
Google Sign-In dengan Pengelola Kredensial Android
Facebook Login with the current Facebook SDK
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 migrasi

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

Jika Anda masih menggunakan @codetrix-studio/capacitor-google-authIkuti langkah-langkah di bawah ini Petunjuk Migrasi Google Auth Legacy.

Jika Anda sedang melakukan migrasi dari Ionic Auth Connect, gunakan fitur yang sudah tersedia SocialLoginAuthConnect __CAPGO_KEEP_0__ auth0, azure, cognito, okta, dan onelogin nama penyedia layanan:

Kompatibilitas

Versi plugin	Capacitor kompatibilitas	Ditunjang
v8.x	v8.x	Ya
v7.x	v7.x	Pemesanan
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 Panduan

Tonton demo singkat pengaturan plugin dan alur login dalam aksi.

Kemampuan Utama

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

Publik API

Metode	Deskripsi
`initialize`	Mulai plugin ini.
`login`	Masuk dengan penyedia yang dipilih.
`logout`	Keluar.
`isLoggedIn`	IsLoggedIn.
`getAuthorizationCode`	Dapatkan 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`	Decodetik 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`	Eksekusi panggilan spesifik provider.
`getPluginVersion`	Ambil versi plugin native Capacitor.
`openSecureWindow`	Buka jendela 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. 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/` Daftarkan juga di info.plist aplikasi. `xml <key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>myapp</string> </array> </dict> </array>` Dalam 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-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-kunci pas untuk detail implementasi di @capgo/capacitor-kunci pas, @capgo/capacitor-biometrik asli untuk detail implementasi di @capgo/capacitor-biometrik asli, Autentikasi Dua Faktor untuk detail implementasi di Autentikasi Dua Faktor, dan SSO (Perusahaan) untuk detail implementasi di SSO (Perusahaan).