Langsung ke konten
Localtonet Localtonet Dasbor

Single Sign-On dengan GitLab

Perlu Saldo Tunnel HTTP

Bantuan untuk halaman ini
Di halaman ini 4 bagian
  1. Sebelum memulai
  2. Langkah
  3. Membuat aplikasi OAuth di GitLab
  4. Menambahkan penyedia di Localtonet
  5. Mengaktifkannya untuk tunnel
  6. Mengujinya
  7. Pemecahan masalah
  8. Halaman terkait

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 #

  1. 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:

    PemilikTempat membuatnya
    Pengguna AndaPilih avatar Anda, lalu Edit profile, lalu Access › Applications dan Add new application.
    GrupBuka grup, lalu Settings › Applications.
    Instans (dikelola sendiri, hanya administrator)Admin › Applications dan New application.

    Isi formulir dan pilih Save application:

    Kolom GitLabNilai
    NameNama yang dikenali pengunjung Anda. GitLab menampilkannya saat meminta mereka memberi otorisasi.
    Redirect URIhttp://auth.localtonet.com/auth/callback
    ConfidentialBiarkan tetap terpilih.
    Scopesread_user

    GitLab kemudian menampilkan Application ID dan Secret. Salin keduanya segera: GitLab menampilkan secret hanya tepat setelah aplikasi dibuat.

    Scope read_user memberi 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.

  2. Menambahkan penyedia di Localtonet #

    Buka Tunnel Saya › HTTP dan pilih SSO di bagian atas halaman. Di dialog Penyedia SSO, pilih Tambah penyedia.

    KolomNilai
    Nama penyediaNama apa saja, misalnya Company GitLab. Anda melihatnya di pengaturan tunnel.
    Jenis penyediaGitLab. Mengubah jenis penyedia yang sudah disimpan akan mengosongkan Client ID, jadi masukkan lagi client ID dan client secret.
    AktifAktif
    Client IDApplication ID dari GitLab.
    Client secretSecret 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.com dengan nama host instans Anda pada tiga kolom pertama.

    GitLab.com

    KolomNilai yang terisi
    Endpoint otorisasihttps://gitlab.com/oauth/authorize
    Endpoint tokenhttps://gitlab.com/oauth/token
    Endpoint info penggunahttps://gitlab.com/api/v4/user
    Path callback/auth/callback/gitlab

    Dikelola sendiri

    KolomNilai yang dimasukkan
    Endpoint otorisasihttps://<YOUR_GITLAB_HOST>/oauth/authorize
    Endpoint tokenhttps://<YOUR_GITLAB_HOST>/oauth/token
    Endpoint info penggunahttps://<YOUR_GITLAB_HOST>/api/v4/user
    Path 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.

  3. 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.

  4. 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.

Dukungan