İçeriğe geç
Localtonet Localtonet Panel

HTTP tünelleri için Tek Oturum Açma (SSO)

Bakiye Gerekir HTTP tünelleri

Bu sayfa için yardım al
Bu sayfada 10 bölüm
  1. Ne zaman kullanılır
  2. Nasıl çalışır
  3. Başlamadan önce
  4. Sağlayıcılar
  5. Kurulum
  6. Sağlayıcı ekleme
  7. Bir tünel için açın
  8. Deneyin
  9. Yönlendirme URI'si
  10. Erişim kuralları
  11. Giriş yolları ve oturum kapatma yolu
  12. Sorun giderme
  13. Otomasyon

Tek oturum açma (SSO), bir HTTP tünelinin önüne bir giriş sayfası koyar. Ziyaretçiler, hizmetinize herhangi bir istek ulaşmadan önce Google, GitHub, Microsoft veya GitLab gibi seçtiğiniz bir kimlik sağlayıcıyla ya da sizin tanımladığınız kullanıcı adı ve parolayla giriş yapar.

Ne zaman kullanılır #

Siz korumadığınız sürece bir HTTP tüneli, adresini bilen herkese açıktır. İnsanlar tüneli tarayıcıda açıyorsa ve onların kim olduğuna sizin karar vermenizi istiyorsanız SSO doğru korumadır: bir yönetim paneli, bir gösterge paneli, bir dahili araç, bir staging sitesi. Hizmetiniz değişmez ve hiçbir zaman bir parola görmez.

SSO tarayıcılar için tasarlanmıştır. Giriş çerezini taşımayan bir istek giriş sayfasına yönlendirilir; bu yüzden betikler, webhook'lar ve API istemcileri geçemez. Bunlar için yalnızca bazı yolları koruyun (bkz. Giriş yolları) ya da Erişim kontrolü sayfasındaki seçenekleri kullanın.

Nasıl çalışır #

Bir ziyaretçi tünel URL'sini açar. Localtonet sunucusu ziyaretçiyi auth.localtonet.com üzerindeki giriş sayfasına yönlendirir; ziyaretçi burada bir kimlik sağlayıcıyla giriş yapar. Ardından ziyaretçi tünel URL'sine geri gönderilir ve istek hizmetinize iletilir. Ziyaretçi Tarayıcı 1. Açar Tünel URL'si Localtonet sunucusu 2. Yönlendirme Giriş sayfası auth.localtonet.com 3. Giriş yapar Sağlayıcı Google, GitHub… 4. Giriş yapıldı, tünele geri dönülür 5. İstek Hizmetiniz Cihazınızda
Giriş, hizmetinizde değil, Localtonet'in giriş sayfasında yapılır.
  1. Bir ziyaretçi tünel URL'sini açar. HTTP üzerinden gelen istek önce HTTPS'e yönlendirilir.
  2. Ziyaretçi henüz giriş yapmamıştır; bu yüzden Localtonet sunucusu tarayıcıyı auth.localtonet.com üzerindeki giriş sayfasına yönlendirir. Sayfanın başlığı Sign in to continue olup bu tünel için açtığınız sağlayıcıları sunar.
  3. Ziyaretçi bir sağlayıcı seçer ve orada giriş yapar. Kullanıcı adı ve parola sağlayıcısında form, giriş sayfasının kendisindedir.
  4. Localtonet erişim kurallarınızı denetler ve ziyaretçiyi istediği adrese geri gönderir. Giriş, tünelin ana makine adı için bir çerezde saklanır. Bu bir tarayıcı oturumu çerezidir ve yalnızca HTTPS üzerinden gönderilir.
  5. Bundan sonra istekler her zamanki gibi hizmetinize iletilir. Giriş geçerliliğini yitirdiğinde ziyaretçi yeniden giriş sayfasına gönderilir.

Giriş yapan ama kurallarınızın izin vermediği bir ziyaretçi, "You do not have permission to access this tunnel." metniyle birlikte 403 - Access Denied sayfasını görür.

/.well-known altındaki yollar hiçbir zaman girişin arkasına alınmaz.

Başlamadan önce #

  • Bir HTTP tüneli. Bkz. HTTP / HTTPS.
  • Hesabınızda bakiye. Bakiye yoksa bir sağlayıcıyı kaydetmek veya girişi açmak "Bu özelliği kullanmak için bakiye satın almanız gerekir." hatasıyla başarısız olur. Bkz. Planlar ve Bakiye ve Fiyatlandırma.
  • Harici bir sağlayıcı için: orada bir OAuth uygulaması kaydetmenize izin veren bir hesap.

SSO, kişisel panelinizde ayarlanır. SSO düğmesi ve SSO Sağlayıcıları ayarı ekip tünelleri için gösterilmez.

Sağlayıcılar #

Bu kılavuzlar en yaygın seçenekleri adım adım ele alır:

Paneldeki Sağlayıcı türü listesi şunları içerir: Username-Password, Google, GitHub, Microsoft, OpenID Connect, Discord, Twitter (X), Custom, Facebook, Apple, LinkedIn, GitLab, Slack, Spotify, Twitch, Reddit, Bitbucket, Amazon ve Yahoo. Username-Password ve Custom dışındaki her tür için uç noktalar sizin yerinize doldurulur. OpenID Connect için doldurulan adresler örnektir; bunları sağlayıcınızın uç noktalarıyla değiştirirsiniz.

Kurulum #

İki bölümden oluşur. Bir sağlayıcıyı bir kez eklersiniz ve bu sağlayıcı tüm HTTP tünellerinizde kullanılabilir olur. Ardından korumak istediğiniz her tünel için onu açarsınız. Kaydedilmiş bir sağlayıcı, bir tünel onu kullanana kadar hiçbir şeyi korumaz.

  1. Sağlayıcı ekleme #

    Tünellerim › HTTP sayfasını açın ve sayfanın üstündeki SSO düğmesini seçin (ipucu metni SSO Sağlayıcı Ayarları şeklindedir). SSO sağlayıcıları iletişim kutusu açılır. Sağlayıcı ekle düğmesini seçin, formu doldurun ve Sağlayıcıyı kaydet düğmesini seçin. Her sağlayıcı ayrı ayrı kaydedilir.

    AlanNe olduğuNotlar
    Sağlayıcı adıBu sağlayıcıyı tünel ayarlarınızda tanımlayan bir ad.Zorunlu. Örneğin Company Google.
    Sağlayıcı türüGiriş yöntemi.Yeni bir sağlayıcı Google olarak başlar. Kaydedilmiş bir sağlayıcının türünü değiştirmek Client ID alanını boşaltır; bu yüzden client ID'yi ve client secret'ı yeniden girin.
    AktifSağlayıcıyı tünellerde kullanılabilir yapar.Bir sağlayıcıyı pasife alıp kaydettiğinizde, onu kullanan her tünelde de kapatılır.
    Client IDSağlayıcıda kaydettiğiniz uygulamanın kimliği.Username-Password ve Custom dışındaki her tür için zorunludur.
    Client SecretO uygulamanın gizli anahtarı.Kaydedildikten sonra asla gösterilmez. Kayıtlı gizli anahtarı korumak için daha sonra boş bırakın.
    Uç noktalar ve callbackYetkilendirme uç noktası, Token uç noktası, Kullanıcı bilgisi uç noktası ve Callback yolu.Standart sağlayıcılar için otomatik doldurulur. Bunları yalnızca bir kılavuz söylediğinde değiştirin.
    E-posta erişim kurallarıİzin verilen e-posta alan adları, Engellenen e-posta alan adları ve Engellenen e-posta adresleri.İsteğe bağlı. Bkz. Erişim kuralları.
    Giriş yapabilen kullanıcılarKullanıcı adları ve parolalar.Yalnızca Username-Password ve Custom türleri için.

    Bir sağlayıcıyı kaldırmak için Sağlayıcıyı sil düğmesini seçin. Bu işlem sağlayıcıyı hesabınızdan ve tünellerinizin SSO ayarlarından kaldırır.

  2. Bir tünel için açın #

    Tünelleriniz altında, tünelin Ayarlar düğmesini seçin. Tünel ayarları panelinde SSO Sağlayıcıları satırını bulun ve Yönet düğmesini seçin. Tek oturum açma (SSO) iletişim kutusu açılır.

    AyarNe yapar
    Girişi zorunlu kılBu tünel için SSO'yu açar. Giriş yapmamış ziyaretçiler önce giriş sayfasına gönderilir.
    SağlayıcılarAktif her sağlayıcınız için bir anahtar. En az birini açın. Birden fazlası açıksa ziyaretçi giriş sayfasında seçim yapar.
    Kimler giriş yapabilirBu tünel için isteğe bağlı E-posta adresleri, E-posta alan adları ve Kullanıcı adları listeleri.
    Giriş ve çıkış yollarıİsteğe bağlı Giriş yolları ve bir Oturum kapatma yolu.

    Kaydet düğmesini seçin.

  3. Deneyin #

    Tünel URL'sini özel bir tarayıcı penceresinde açın. Sign in to continue sayfasına ulaşmalı ve giriş yaptıktan sonra hizmetinize geçmelisiniz.

Yönlendirme URI'si #

Harici bir sağlayıcı, insanları giriş yaptıktan sonra nereye gönderebileceğini sorar. Her tünel için bu, tünelinizin adresi değil, Localtonet'in giriş sunucusundaki bir adrestir. Tam olarak bu değeri kaydedin:

Yönlendirme URI'si
http://auth.localtonet.com/auth/callback

Her sağlayıcı kılavuzu, bunu nereye gireceğinizi söyler.

DeğerNereye girilir
Yukarıdaki yönlendirme URI'siSağlayıcıda: Authorized redirect URIs (Google), Authorization callback URL (GitHub), Redirect URI (Microsoft, GitLab).
Callback yolu, örneğin /auth/callback/googleLocaltonet'te Uç noktalar ve callback altında. Sizin için doldurulur. Olduğu gibi bırakın.

Sağlayıcı, yönlendirme URI'sini kayıtlı değerle birebir karşılaştırır; bu yüzden burada gösterildiği gibi kopyalayın.

Erişim kuralları #

Giriş yapmak bir ziyaretçinin kim olduğunu kanıtlar. Kurallar ise o kişinin tüneli açıp açamayacağına karar verir. İki düzey vardır ve ikisi de geçerlidir.

NeredeListePanelde yazan
Sağlayıcıİzin verilen e-posta alan adlarıAlan adı kısıtlaması istemiyorsanız boş bırakın. Joker karakterler sağlayıcıya bağlıdır.
SağlayıcıEngellenen e-posta alan adlarıBu e-posta alan adlarından gelen girişleri engelleyin.
SağlayıcıEngellenen e-posta adresleriBu tekil e-posta adreslerini engelleyin.
TünelE-posta adresleri, E-posta alan adları, Kullanıcı adlarıO denetimi atlamak için listeyi boş bırakın. Listeler, tünel için açılan tüm sağlayıcılara uygulanır.

Her satıra bir öğe girin veya öğeleri virgülle ayırın. Alan adı @ olmadan girilir, örneğin example.com.

Bir kuralı değiştirdikten sonra, daha önce içeri alınmış bir ziyaretçi beş dakikaya kadar erişimini sürdürebilir. Reddedilen bir ziyaretçi bir dakika sonra yeniden denetlenir.

Giriş yolları ve oturum kapatma yolu #

AyarDavranışÖrnek
Giriş yollarıBoşsa: tünelin her yolu giriş gerektirir. Doluysa: yalnızca yolu girdilerden biriyle başlayan istekler giriş gerektirir./admin, /admin ve /admin/users yollarını kapsar; /administrator yolunu kapsamaz.
Oturum kapatma yoluAçıldığında bu tünel için girişi kaldırır ve ziyaretçiyi tünelin başlangıç sayfasına ya da returnUrl sorgu değerindeki adrese gönderir./sso/logout

Yollar bir eğik çizgiyle başlar. Büyük ve küçük harf fark etmez.

Dolu bir Giriş yolları listesi geri kalan her şeyi açık bırakır. Listede /admin varsa yalnızca /admin korunur; diğer tüm yollara giriş yapmadan ulaşılabilir. Tüm tüneli korumak için listeyi boş bırakın.

Oturum kapatma yolu, ziyaretçinin oturumunu yalnızca tünelden kapatır. Google, GitHub veya başka bir kimlik sağlayıcıdan çıkış yaptırmaz.

Sorun giderme #

"Bu özelliği kullanmak için bakiye satın almanız gerekir."

SSO için Bakiye gerekir. Bakiye ekleyin, sonra yeniden kaydedin. Bakiye olmadan da iletişim kutusunu açabilir ve Girişi zorunlu kıl seçeneğini kapatabilirsiniz.

"Girişi zorunlu kılmadan önce bir sağlayıcı ekleyin."

Henüz aktif bir sağlayıcınız yok. İletişim kutusunda Sağlayıcı ekle düğmesini seçin ya da HTTP sayfasının üstündeki SSO düğmesini kullanın.

"En az bir sağlayıcıyı açın veya girişi zorunlu kılmayı kapatın."

Girişi zorunlu kıl açık ama hiçbir sağlayıcı anahtarı açık değil. Pasif yaptığınız bir sağlayıcı kendi tünellerinde kapatılır ve artık listelenmez.

Giriş sayfasında "No authentication providers are currently configured for this tunnel." yazıyor.

Giriş zorunlu ama bu tünel için hiçbir sağlayıcı açık değil. Tünelde SSO Sağlayıcıları › Yönet seçeneğini açın ve birini açın.

Tünel, giriş istemeden açılıyor

Girişi zorunlu kıl seçeneğinin açık ve kayıtlı olduğundan emin olun. Giriş yolları doluysa yalnızca o yollar korunur. Ayrıca özel bir pencerede deneyin: kendi tarayıcınızda hâlâ giriş yapılmış olabilir.

Giriş yaptıktan sonra "403 - Access Denied"

Giriş çalıştı ama bir kural hesabı reddetti. Sağlayıcının E-posta erişim kuralları ayarlarını ve tünelin Kimler giriş yapabilir listelerini kontrol edin. Bir kuralı düzelttikten sonra bir dakika bekleyip sayfayı yeniden yükleyin.

Bir webhook veya API istemcisi yanıt yerine yönlendirme alıyor

Giriş çerezi olmayan istekler giriş sayfasına yönlendirilir. Giriş yolları alanına yalnızca insanlara yönelik sayfaları koyun ya da makine trafiği için ayrı bir tünel kullanın.

Otomasyon #

Sağlayıcılar ve tünel SSO ayarları, /api/v2/sso-providers altındaki API ile ve MCP sunucusu üzerinden de yönetilebilir.

Bu sayfa için yardıma mı ihtiyacınız var? Topluluğa sorun veya bir destek talebi açın.

Destek