Langsung ke konten
Localtonet Localtonet Dasbor

Single Sign-On untuk tunnel HTTP

Perlu Saldo Tunnel HTTP

Bantuan untuk halaman ini
Di halaman ini 10 bagian
  1. Kapan digunakan
  2. Cara kerjanya
  3. Sebelum memulai
  4. Penyedia
  5. Menyiapkannya
  6. Tambah penyedia
  7. Mengaktifkannya untuk tunnel
  8. Mengujinya
  9. Redirect URI
  10. Aturan akses
  11. Path login dan path logout
  12. Pemecahan masalah
  13. Otomatisasi

Single sign-on (SSO) menempatkan halaman login di depan tunnel HTTP. Pengunjung login dengan penyedia identitas pilihan Anda, seperti Google, GitHub, Microsoft, atau GitLab, atau dengan nama pengguna dan kata sandi yang Anda tentukan, sebelum permintaan apa pun mencapai layanan Anda.

Kapan digunakan #

Sebelum dilindungi, tunnel HTTP terbuka untuk siapa pun yang memiliki alamatnya. SSO adalah perlindungan yang tepat saat orang membuka tunnel di browser dan Anda ingin menentukan siapa mereka: panel admin, dasbor, alat internal, situs staging. Layanan Anda tidak berubah dan tidak pernah melihat kata sandi.

SSO dibuat untuk browser. Permintaan yang tidak membawa cookie login akan dialihkan ke halaman login, sehingga skrip, webhook, dan klien API tidak dapat lewat. Untuk itu, lindungi hanya sebagian path (lihat Path login) atau gunakan opsi di Kontrol akses.

Cara kerjanya #

Pengunjung membuka URL tunnel. Server Localtonet mengalihkan pengunjung ke halaman login di auth.localtonet.com, tempat pengunjung login dengan penyedia identitas. Pengunjung kemudian dikirim kembali ke URL tunnel dan permintaan diteruskan ke layanan Anda. Pengunjung Browser 1. Membuka URL tunnel Server Localtonet 2. Pengalihan Halaman login auth.localtonet.com 3. Login Penyedia Google, GitHub… 4. Sudah login, kembali ke tunnel 5. Permintaan Layanan Anda Di perangkat Anda
Proses login berlangsung di halaman login Localtonet, bukan di layanan Anda.
  1. Pengunjung membuka URL tunnel. Permintaan melalui HTTP dialihkan ke HTTPS terlebih dahulu.
  2. Pengunjung belum login, sehingga server Localtonet mengalihkan browser ke halaman login di auth.localtonet.com. Halaman tersebut berjudul Sign in to continue dan menawarkan penyedia yang Anda aktifkan untuk tunnel ini.
  3. Pengunjung memilih penyedia dan login di sana. Untuk penyedia nama pengguna dan kata sandi, formulirnya ada di halaman login itu sendiri.
  4. Localtonet memeriksa aturan akses Anda dan mengirim pengunjung kembali ke alamat yang mereka minta. Status login disimpan dalam cookie untuk nama host tunnel. Ini adalah cookie sesi browser, yang hanya dikirim melalui HTTPS.
  5. Sejak saat itu, permintaan diteruskan ke layanan Anda seperti biasa. Saat login tidak lagi valid, pengunjung dikirim ke halaman login lagi.

Pengunjung yang login tetapi tidak diizinkan oleh aturan Anda melihat 403 - Access Denied dengan teks "You do not have permission to access this tunnel."

Path di bawah /.well-known tidak pernah ditempatkan di balik login.

Sebelum memulai #

  • Tunnel HTTP. Lihat HTTP / HTTPS.
  • Saldo di akun Anda. Tanpa saldo, menyimpan penyedia atau mengaktifkan login gagal dengan "Anda perlu membeli saldo untuk menggunakan fitur ini." Lihat Paket dan Saldo dan Harga.
  • Untuk penyedia eksternal: akun di sana yang memungkinkan Anda mendaftarkan aplikasi OAuth.

SSO diatur di dasbor pribadi Anda. Tombol SSO dan pengaturan Penyedia SSO tidak ditampilkan untuk tunnel tim.

Penyedia #

Panduan berikut membahas pilihan yang paling umum langkah demi langkah:

Daftar Jenis penyedia di dasbor berisi: Username-Password, Google, GitHub, Microsoft, OpenID Connect, Discord, Twitter (X), Custom, Facebook, Apple, LinkedIn, GitLab, Slack, Spotify, Twitch, Reddit, Bitbucket, Amazon, dan Yahoo. Untuk setiap jenis kecuali Username-Password dan Custom, endpoint sudah diisikan untuk Anda. Untuk OpenID Connect, alamat yang sudah terisi hanyalah contoh yang Anda ganti dengan endpoint penyedia Anda.

Menyiapkannya #

Ada dua bagian. Anda menambahkan penyedia sekali, lalu penyedia itu tersedia untuk semua tunnel HTTP Anda. Setelah itu Anda mengaktifkannya untuk setiap tunnel yang ingin dilindungi. Penyedia yang tersimpan tidak melindungi apa pun sampai sebuah tunnel menggunakannya.

  1. Tambah penyedia #

    Buka Tunnel Saya › HTTP dan pilih SSO di bagian atas halaman (tooltip-nya berbunyi Pengaturan Penyedia SSO). Dialog Penyedia SSO terbuka. Pilih Tambah penyedia, isi formulir, lalu pilih Simpan penyedia. Setiap penyedia disimpan secara terpisah.

    KolomApa ituCatatan
    Nama penyediaNama untuk mengenali penyedia ini di pengaturan tunnel Anda.Wajib diisi. Misalnya Company Google.
    Jenis penyediaMetode login.Penyedia baru dimulai sebagai Google. Mengubah jenis penyedia yang tersimpan akan mengosongkan Client ID, jadi masukkan lagi client ID dan client secret.
    AktifMembuat penyedia tersedia untuk tunnel.Saat Anda mengubah penyedia menjadi tidak aktif lalu menyimpan, penyedia itu juga dimatikan di setiap tunnel yang menggunakannya.
    Client IDID aplikasi yang Anda daftarkan di penyedia.Wajib untuk setiap jenis kecuali Username-Password dan Custom.
    Client secretSecret dari aplikasi tersebut.Tidak pernah ditampilkan setelah disimpan. Biarkan kosong nanti untuk mempertahankan secret yang tersimpan.
    Endpoint & callbackEndpoint otorisasi, Endpoint token, Endpoint info pengguna, dan Path callback.Terisi otomatis untuk penyedia standar. Ubah hanya jika sebuah panduan menyuruh Anda melakukannya.
    Aturan akses emailDomain email yang diizinkan, Domain email yang diblokir, dan Alamat email yang diblokir.Opsional. Lihat Aturan akses.
    Pengguna loginNama pengguna dan kata sandi.Hanya untuk jenis Username-Password dan Custom.

    Untuk menghapus penyedia, pilih Hapus penyedia. Ini menghapusnya dari akun Anda dan dari pengaturan SSO tunnel Anda.

  2. Mengaktifkannya untuk tunnel #

    Di bawah Tunnel Anda, pilih Pengaturan pada tunnel. Di panel Pengaturan tunnel, cari Penyedia SSO lalu pilih Kelola. Dialog Single sign-on terbuka.

    PengaturanFungsinya
    Wajibkan loginMengaktifkan SSO untuk tunnel ini. Pengunjung yang belum login dikirim ke halaman login lebih dulu.
    PenyediaSatu sakelar untuk setiap penyedia aktif Anda. Aktifkan setidaknya satu. Jika beberapa aktif, pengunjung memilih di halaman login.
    Siapa yang dapat loginDaftar opsional Alamat email, Domain email, dan Nama pengguna untuk tunnel ini.
    Path login dan logoutPath login dan Path logout opsional.

    Pilih Simpan.

  3. Mengujinya #

    Buka URL tunnel di jendela browser pribadi. Anda seharusnya tiba di halaman Sign in to continue, dan setelah login, di layanan Anda.

Redirect URI #

Penyedia eksternal menanyakan ke mana ia boleh mengirim orang setelah mereka login. Untuk setiap tunnel, ini adalah alamat di host login Localtonet, bukan alamat tunnel Anda. Daftarkan persis nilai ini:

Redirect URI
http://auth.localtonet.com/auth/callback

Setiap panduan penyedia memberi tahu tempat memasukkannya.

NilaiTempatnya
Redirect URI di atasDi penyedia: Authorized redirect URIs (Google), Authorization callback URL (GitHub), Redirect URI (Microsoft, GitLab).
Path callback, misalnya /auth/callback/googleDi Localtonet, di bawah Endpoint & callback. Sudah terisi untuk Anda. Biarkan apa adanya.

Penyedia membandingkan redirect URI dengan nilai terdaftar secara persis, jadi salin seperti yang ditampilkan di sini.

Aturan akses #

Login membuktikan siapa pengunjung itu. Aturan menentukan apakah orang tersebut boleh membuka tunnel. Ada dua tingkat, dan keduanya berlaku.

LokasiDaftarYang dikatakan dasbor
PenyediaDomain email yang diizinkanBiarkan kosong agar tidak ada pembatasan domain. Wildcard bergantung pada penyedia.
PenyediaDomain email yang diblokirBlokir login dari domain email ini.
PenyediaAlamat email yang diblokirBlokir masing-masing alamat email ini.
TunnelAlamat email, Domain email, Nama penggunaBiarkan daftar kosong untuk melewati pemeriksaan tersebut. Daftar berlaku untuk semua penyedia yang diaktifkan pada tunnel.

Masukkan satu item per baris, atau pisahkan item dengan koma. Domain dimasukkan tanpa @, misalnya example.com.

Setelah Anda mengubah aturan, pengunjung yang sudah diizinkan masuk dapat mempertahankan akses hingga lima menit. Pengunjung yang ditolak diperiksa lagi setelah satu menit.

Path login dan path logout #

PengaturanPerilakuContoh
Path loginKosong: setiap path tunnel memerlukan login. Terisi: hanya permintaan yang path-nya diawali salah satu entri yang memerlukan login./admin mencakup /admin dan /admin/users, bukan /administrator.
Path logoutMembukanya menghapus login untuk tunnel ini dan mengirim pengunjung ke halaman awal tunnel, atau ke alamat dalam nilai query returnUrl./sso/logout

Path diawali dengan garis miring. Huruf besar dan kecil tidak berpengaruh.

Daftar Path login yang terisi membuka semua yang lain. Dengan /admin di daftar, hanya /admin yang dilindungi dan semua path lain dapat dijangkau tanpa login. Biarkan daftar kosong untuk melindungi seluruh tunnel.

Path logout hanya mengeluarkan pengunjung dari tunnel. Path ini tidak mengeluarkan mereka dari Google, GitHub, atau penyedia identitas lain.

Pemecahan masalah #

"Anda perlu membeli saldo untuk menggunakan fitur ini."

SSO memerlukan Saldo. Tambahkan Saldo, lalu simpan lagi. Tanpa Saldo, Anda tetap dapat membuka dialog dan mematikan Wajibkan login.

"Tambahkan penyedia sebelum Anda mengaktifkan login."

Anda belum memiliki penyedia aktif. Pilih Tambah penyedia di dialog, atau gunakan tombol SSO di bagian atas halaman HTTP.

"Aktifkan setidaknya satu penyedia, atau nonaktifkan login."

Wajibkan login aktif tetapi tidak ada sakelar penyedia yang aktif. Penyedia yang Anda atur menjadi tidak aktif dimatikan pada tunnel-nya dan tidak lagi tercantum.

Halaman login menampilkan "No authentication providers are currently configured for this tunnel."

Login diwajibkan, tetapi tidak ada penyedia yang diaktifkan untuk tunnel ini. Buka Penyedia SSO › Kelola pada tunnel lalu aktifkan salah satu.

Tunnel terbuka tanpa meminta login

Pastikan Wajibkan login aktif dan tersimpan. Jika Path login terisi, hanya path tersebut yang dilindungi. Uji juga di jendela pribadi: browser Anda sendiri mungkin masih dalam keadaan login.

"403 - Access Denied" setelah login

Login berhasil, tetapi sebuah aturan menolak akun tersebut. Periksa Aturan akses email milik penyedia dan daftar Siapa yang dapat login milik tunnel. Setelah Anda memperbaiki aturan, tunggu semenit lalu muat ulang.

Webhook atau klien API mendapat pengalihan, bukan jawaban

Permintaan tanpa cookie login dialihkan ke halaman login. Masukkan hanya halaman yang ditujukan bagi manusia ke Path login, atau gunakan tunnel terpisah untuk lalu lintas mesin.

Otomatisasi #

Penyedia dan pengaturan SSO tunnel juga dapat dikelola melalui API, di bawah /api/v2/sso-providers, dan melalui server MCP.

Dukungan