Single Sign-On dengan GitLab
Perlu Saldo Tunnel HTTP
Di halaman ini 4 bagian
Biarkan pengunjung masuk dengan akun GitLab mereka sebelum dapat membuka tunnel HTTP. Cara ini bekerja dengan GitLab.com dan dengan instans GitLab yang dikelola sendiri. Anda membuat aplikasi OAuth di GitLab, menambahkannya ke Localtonet sebagai penyedia, lalu mengaktifkannya untuk tunnel.
Sebelum memulai #
- Tunnel HTTP dan Saldo di akun Anda. Lihat ringkasan Single Sign-On.
- Akun GitLab di GitLab.com atau di instans Anda sendiri.
- Untuk instans yang dikelola sendiri: alamatnya harus dapat dijangkau dari internet. Browser pengunjung Anda membuka halaman masuknya, dan host masuk Localtonet memanggil endpoint token dan penggunanya secara langsung.
Langkah #
-
Membuat aplikasi OAuth di GitLab #
Panduan GitLab sendiri adalah Configure GitLab as an OAuth 2.0 authentication identity provider. Aplikasi dapat dimiliki oleh pengguna, grup, atau seluruh instans:
Pemilik Tempat membuatnya Pengguna Anda Pilih avatar Anda, lalu Edit profile, lalu Access › Applications dan Add new application. Grup Buka grup, lalu Settings › Applications. Instans (dikelola sendiri, hanya administrator) Admin › Applications dan New application. Isi formulir dan pilih Save application:
Kolom GitLab Nilai Name Nama yang dikenali pengunjung Anda. GitLab menampilkannya saat meminta mereka memberi otorisasi. Redirect URI http://auth.localtonet.com/auth/callbackConfidential Biarkan tetap terpilih. Scopes read_userGitLab kemudian menampilkan Application ID dan Secret. Salin keduanya segera: GitLab menampilkan secret hanya tepat setelah aplikasi dibuat.
Scope
read_usermemberi akses baca ke profil pengguna yang masuk melalui endpoint/api/v4/user, yaitu Endpoint info pengguna yang diisi Localtonet. Itu satu-satunya scope yang diminta saat masuk, jadi aplikasi tidak memerlukan scope lain. -
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 saja, misalnya Company GitLab. Anda melihatnya di pengaturan tunnel.Jenis penyedia GitLab. Mengubah jenis penyedia yang sudah disimpan akan mengosongkan Client ID, jadi masukkan lagi client ID dan client secret. Aktif Aktif Client ID Application ID dari GitLab. Client secret Secret dari GitLab. Nilai ini tidak pernah ditampilkan lagi setelah disimpan. Buka Endpoint & callback. Alamat GitLab.com terisi otomatis. Untuk instans yang dikelola sendiri, ganti
gitlab.comdengan nama host instans Anda pada tiga kolom pertama.GitLab.com
Kolom Nilai yang terisi Endpoint otorisasi https://gitlab.com/oauth/authorizeEndpoint token https://gitlab.com/oauth/tokenEndpoint info pengguna https://gitlab.com/api/v4/userPath callback /auth/callback/gitlabDikelola sendiri
Kolom Nilai yang dimasukkan Endpoint otorisasi https://<YOUR_GITLAB_HOST>/oauth/authorizeEndpoint token https://<YOUR_GITLAB_HOST>/oauth/tokenEndpoint info pengguna https://<YOUR_GITLAB_HOST>/api/v4/userPath callback /auth/callback/gitlab(tidak diubah)Redirect URI pada aplikasi GitLab tetap berupa alamat Localtonet dari langkah 1. Alamat itu tidak memuat host GitLab Anda.
Jika 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 GitLab Anda. Pilih Simpan.
Di GitLab.com siapa pun dapat membuat akun. Tanpa aturan, setiap pengguna GitLab.com yang mengetahui alamatnya dapat membuka tunnel. Isi Siapa yang dapat login pada tunnel, atau Domain email yang diizinkan pada penyedia. Daftarnya dijelaskan di ringkasan.
-
Mengujinya #
Buka URL tunnel di jendela browser pribadi. Localtonet menampilkan Sign in to continue dengan tombol untuk penyedia Anda. GitLab meminta Anda memberi otorisasi aplikasi pada kali pertama. Setelah itu Anda dikembalikan ke tunnel dan layanan Anda dimuat.
Pemecahan masalah #
GitLab mengatakan redirect URI yang disertakan tidak valid
Tidak ada Redirect URI pada aplikasi GitLab yang cocok dengan alamat yang dikirim. Masukkan persis http://auth.localtonet.com/auth/callback sebagai Redirect URI aplikasi.
GitLab mengatakan scope yang diminta tidak valid, tidak dikenal, atau salah format
Scope yang diminta tidak dipilih di aplikasi GitLab. Edit aplikasi dan pilih read_user.
GitLab mengatakan autentikasi klien gagal
Client ID atau Client secret yang tersimpan di Localtonet tidak cocok dengan aplikasi GitLab. Tempel lagi Application ID dan Secret, lalu pilih Simpan penyedia. Jika Anda memperbarui secret di GitLab, aplikasi berhenti berfungsi sampai Anda menyimpan secret baru di Localtonet.
Proses masuk dengan instans yang dikelola sendiri tidak pernah selesai
Periksa ketiga endpoint dari kesalahan ketik dan pastikan instans menjawab dari internet. Jika memakai HTTPS, instans membutuhkan sertifikat yang dipercaya klien publik. Instans yang hanya dapat dijangkau di dalam jaringan Anda tidak dapat dipakai.
"403 - Access Denied" setelah masuk GitLab berhasil
Sebuah aturan Localtonet menolak akun tersebut. Periksa Aturan akses email pada penyedia dan Siapa yang dapat login pada tunnel. Setelah Anda memperbaiki aturan, tunggu semenit lalu muat ulang.
Tidak ada tombol GitLab di halaman masuk
Penyedia tidak diaktifkan untuk tunnel ini, atau diatur nonaktif. Periksa keduanya.