Langsung ke konten
Localtonet Localtonet Dasbor

Single Sign-On dengan GitHub

Perlu Saldo Tunnel HTTP

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

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 #

  1. Mendaftarkan aplikasi OAuth di GitHub #

    Panduan resmi GitHub adalah Creating an OAuth app. Singkatnya:

    1. Di GitHub, buka menu di bawah foto profil Anda dan pilih Settings, lalu Developer settings, lalu OAuth apps.
    2. Pilih New OAuth App. Jika Anda belum memiliki aplikasi, tombolnya bertuliskan Register a new application.
    3. Isi formulir dengan nilai di bawah dan pilih Register application.
    4. Di halaman aplikasi baru, salin Client ID, lalu pilih Generate a new client secret dan segera salin secret tersebut.
    Kolom GitHubNilai
    Application nameNama yang dikenali pengunjung Anda. GitHub menampilkannya saat meminta mereka memberi otorisasi.
    Homepage URLAlamat web yang menjelaskan aplikasi, misalnya situs web Anda.
    Authorization callback URLhttp://auth.localtonet.com/auth/callback
    Enable Device FlowBiarkan nonaktif.

    Anda tidak memilih scope di GitHub. Permintaan masuk yang menyebutkannya: read:user dan user:email. GitHub meminta pengunjung menyetujuinya saat pertama kali masuk.

  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 pun, misalnya GitHub. Anda melihatnya di pengaturan tunnel.
    Jenis penyediaGitHub. Mengubah jenis penyedia yang tersimpan akan mengosongkan Client ID, jadi masukkan lagi client ID dan client secret.
    AktifAktif
    Client IDClient ID dari GitHub.
    Client secretClient secret dari GitHub. Tidak pernah ditampilkan setelah disimpan.

    Di bawah Endpoint & callback, alamat GitHub standar terisi otomatis. Biarkan apa adanya:

    KolomNilai yang terisi
    Endpoint otorisasihttps://github.com/login/oauth/authorize
    Endpoint tokenhttps://github.com/login/oauth/access_token
    Endpoint info penggunahttps://api.github.com/user
    Path callback/auth/callback/github

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

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

Dukungan