Single Sign-On dengan GitHub
Perlu Saldo Tunnel HTTP
Di halaman ini 4 bagian
Biarkan pengunjung masuk dengan akun GitHub mereka sebelum dapat membuka tunnel HTTP. Anda mendaftarkan aplikasi OAuth di GitHub, menambahkannya ke Localtonet sebagai penyedia, lalu mengaktifkannya untuk tunnel.
Sebelum memulai #
- Tunnel HTTP dan Saldo di akun Anda. Lihat ikhtisar Single Sign-On.
- Akun GitHub. Untuk mendaftarkan aplikasi atas nama organisasi, Anda memerlukan akses ke pengaturan organisasi tersebut.
Langkah-langkah #
-
Mendaftarkan aplikasi OAuth di GitHub #
Panduan resmi GitHub adalah Creating an OAuth app. Singkatnya:
- Di GitHub, buka menu di bawah foto profil Anda dan pilih Settings, lalu Developer settings, lalu OAuth apps.
- Pilih New OAuth App. Jika Anda belum memiliki aplikasi, tombolnya bertuliskan Register a new application.
- Isi formulir dengan nilai di bawah dan pilih Register application.
- Di halaman aplikasi baru, salin Client ID, lalu pilih Generate a new client secret dan segera salin secret tersebut.
Kolom GitHub Nilai Application name Nama yang dikenali pengunjung Anda. GitHub menampilkannya saat meminta mereka memberi otorisasi. Homepage URL Alamat web yang menjelaskan aplikasi, misalnya situs web Anda. Authorization callback URL http://auth.localtonet.com/auth/callbackEnable Device Flow Biarkan nonaktif. Anda tidak memilih scope di GitHub. Permintaan masuk yang menyebutkannya:
read:userdanuser:email. GitHub meminta pengunjung menyetujuinya saat pertama kali masuk. -
Menambahkan penyedia di Localtonet #
Buka Tunnel Saya › HTTP dan pilih SSO di bagian atas halaman. Di dialog Penyedia SSO, pilih Tambah penyedia.
Kolom Nilai Nama penyedia Nama apa pun, misalnya GitHub. Anda melihatnya di pengaturan tunnel.Jenis penyedia GitHub. Mengubah jenis penyedia yang tersimpan akan mengosongkan Client ID, jadi masukkan lagi client ID dan client secret. Aktif Aktif Client ID Client ID dari GitHub. Client secret Client secret dari GitHub. Tidak pernah ditampilkan setelah disimpan. Di bawah Endpoint & callback, alamat GitHub standar terisi otomatis. Biarkan apa adanya:
Kolom Nilai yang terisi Endpoint otorisasi https://github.com/login/oauth/authorizeEndpoint token https://github.com/login/oauth/access_tokenEndpoint info pengguna https://api.github.com/userPath callback /auth/callback/githubJika perlu, isi Aturan akses email, lalu pilih Simpan penyedia.
-
Mengaktifkannya untuk tunnel #
Di bawah Tunnel Anda, pilih Pengaturan pada tunnel, lalu Kelola di samping Penyedia SSO. Di dialog Single sign-on, aktifkan Wajibkan login dan sakelar penyedia GitHub Anda. Pilih Simpan.
Siapa pun dapat membuat akun GitHub. Tanpa aturan, setiap pengguna GitHub yang mengetahui alamatnya dapat membuka tunnel. Isi Siapa yang dapat login pada tunnel, atau Domain email yang diizinkan pada penyedia. Daftar tersebut dijelaskan di ikhtisar.
-
Mengujinya #
Buka URL tunnel di jendela browser pribadi. Localtonet menampilkan Sign in to continue dengan tombol untuk penyedia Anda. GitHub meminta Anda memberi otorisasi pada aplikasi saat pertama kali. Setelah itu Anda dikembalikan ke tunnel dan layanan Anda dimuat.
Pemecahan masalah #
GitHub melaporkan redirect URI tidak cocok
Error GitHub adalah redirect_uri_mismatch: "The redirect_uri MUST match the registered callback URL for this application." Tidak ada callback URL pada aplikasi OAuth yang cocok dengan alamat yang dikirim. Atur Authorization callback URL di GitHub persis ke http://auth.localtonet.com/auth/callback.
Pengunjung ditolak meskipun alamatnya ada dalam daftar
Endpoint info pengguna default, https://api.github.com/user, mungkin tidak mengembalikan alamat email jika pengguna GitHub belum menetapkan email publik di profilnya. Minta pengunjung memeriksa alamat mana yang ditetapkan sebagai email publik di profil GitHub mereka, lalu bandingkan dengan daftar Anda.
“403 - Access Denied” setelah berhasil masuk di GitHub
Aturan Localtonet menolak akun tersebut. Periksa Aturan akses email pada penyedia dan Siapa yang dapat login pada tunnel. Setelah memperbaiki aturan, tunggu semenit lalu muat ulang.
Proses masuk gagal sebelum atau sesudah halaman otorisasi GitHub
Periksa Client ID dan Client secret yang tersimpan di Localtonet terhadap aplikasi OAuth. Tempel ulang Client ID, buat client secret baru di GitHub, tempel ke penyedia, lalu pilih Simpan penyedia.
Tidak ada tombol GitHub di halaman masuk
Penyedia tidak diaktifkan untuk tunnel ini, atau diatur nonaktif. Periksa keduanya.