HTTP tünelleri için Tek Oturum Açma (SSO)
Bakiye Gerekir HTTP tünelleri
Bu sayfada 10 bölüm
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. HTTP üzerinden gelen istek önce HTTPS'e yönlendirilir.
- 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. - 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.
- 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.
- 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.
-
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.
Alan Ne olduğu Notlar 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. Aktif Sağ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 ID Sağlayıcıda kaydettiğiniz uygulamanın kimliği. Username-Password ve Custom dışındaki her tür için zorunludur. Client Secret O 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 callback Yetkilendirme 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ılar Kullanı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.
-
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.
Ayar Ne yapar Girişi zorunlu kıl Bu tünel için SSO'yu açar. Giriş yapmamış ziyaretçiler önce giriş sayfasına gönderilir. Sağlayıcılar Aktif 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ş yapabilir Bu 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.
-
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:
http://auth.localtonet.com/auth/callbackHer sağlayıcı kılavuzu, bunu nereye gireceğinizi söyler.
| Değer | Nereye girilir |
|---|---|
| Yukarıdaki yönlendirme URI'si | Sağlayıcıda: Authorized redirect URIs (Google), Authorization callback URL (GitHub), Redirect URI (Microsoft, GitLab). |
Callback yolu, örneğin /auth/callback/google | Localtonet'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.
| Nerede | Liste | Panelde 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 adresleri | Bu tekil e-posta adreslerini engelleyin. |
| Tünel | E-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 #
| Ayar | Davranış | Ö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 yolu | Açı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.