Єдиний вхід (SSO) для HTTP-тунелів
Потрібен баланс HTTP-тунелі
На цій сторінці 10 розділів
Єдиний вхід (SSO) ставить сторінку входу перед HTTP-тунелем. Відвідувачі входять через обраного вами провайдера ідентифікації, як-от Google, GitHub, Microsoft або GitLab, або за ім’ям користувача й паролем, які ви визначили, ще до того, як будь-який запит дійде до вашого сервісу.
Коли це використовувати #
Поки ви його не захистили, HTTP-тунель відкритий для будь-кого, хто знає його адресу. SSO — слушний захист, коли люди відкривають тунель у браузері, а ви хочете вирішувати, хто саме має доступ: панель адміністратора, дашборд, внутрішній інструмент, тестовий сайт. Ваш сервіс не змінюється й ніколи не бачить пароля.
SSO створено для браузерів. Запит без cookie входу перенаправляється на сторінку входу, тож скрипти, вебхуки й API-клієнти пройти не можуть. Для них захищайте лише окремі шляхи (див. Шляхи входу) або скористайтеся параметрами з розділу Контроль доступу.
Як це працює #
- Відвідувач відкриває URL тунелю. Запит через HTTP спершу перенаправляється на HTTPS.
- Відвідувач ще не ввійшов, тому сервер Localtonet перенаправляє браузер на сторінку входу на
auth.localtonet.com. Сторінка має заголовок Sign in to continue і пропонує провайдерів, яких ви ввімкнули для цього тунелю. - Відвідувач обирає провайдера та входить там. Для провайдера «ім’я користувача й пароль» форма розташована на самій сторінці входу.
- Localtonet перевіряє ваші правила доступу та повертає відвідувача на адресу, яку він запитував. Вхід зберігається в cookie для імені хоста тунелю. Це cookie сеансу браузера, яке надсилається лише через HTTPS.
- Відтоді запити передаються вашому сервісу як зазвичай. Коли вхід більше не дійсний, відвідувача знову відправляють на сторінку входу.
Відвідувач, який увійшов, але якого ваші правила не допускають, бачить 403 - Access Denied з текстом "You do not have permission to access this tunnel."
Шляхи під /.well-known ніколи не закриваються входом.
Перш ніж почати #
- HTTP-тунель. Див. HTTP / HTTPS.
- Баланс на вашому обліковому записі. Без нього збереження провайдера або ввімкнення входу завершується повідомленням «Щоб користуватися цією функцією, поповніть баланс.» Див. Тарифи та баланс і Ціни.
- Для зовнішнього провайдера: обліковий запис у нього, який дозволяє зареєструвати OAuth-застосунок.
SSO налаштовується в особистій панелі керування. Кнопка SSO і налаштування SSO-провайдери не показуються для тунелів команди.
Провайдери #
Ці посібники крок за кроком охоплюють найпоширеніші варіанти:
Список Тип провайдера у панелі керування містить: Username-Password, Google, GitHub, Microsoft, OpenID Connect, Discord, Twitter (X), Custom, Facebook, Apple, LinkedIn, GitLab, Slack, Spotify, Twitch, Reddit, Bitbucket, Amazon і Yahoo. Для кожного типу, крім Username-Password і Custom, ендпоінти заповнюються автоматично. Для OpenID Connect заповнені адреси — це приклади, які ви заміняєте ендпоінтами свого провайдера.
Налаштування #
Є дві частини. Ви один раз додаєте провайдера, і він стає доступним для всіх ваших HTTP-тунелів. Після цього ви вмикаєте його для кожного тунелю, який хочете захистити. Збережений провайдер нічого не захищає, доки його не використовує тунель.
-
Додавання провайдера #
Відкрийте Мої тунелі › HTTP і натисніть SSO угорі сторінки (підказка до неї — Налаштування SSO-провайдера). Відкриється діалог SSO-провайдери. Натисніть Додати провайдера, заповніть форму й натисніть Зберегти провайдера. Кожен провайдер зберігається окремо.
Поле Що це Примітки Назва провайдера Назва, за якою ви впізнаєте цього провайдера в налаштуваннях тунелю. Обов’язкове. Наприклад, Company Google.Тип провайдера Спосіб входу. Новий провайдер за замовчуванням має тип Google. Якщо змінити тип збереженого провайдера, поле Client ID очищається, тож введіть client ID і client secret знову. Активний Робить провайдера доступним для тунелів. Якщо ви переведете провайдера в неактивний стан і збережете, його також буде вимкнено на кожному тунелі, який його використовував. Client ID Ідентифікатор застосунку, який ви зареєстрували в провайдера. Обов’язкове для кожного типу, крім Username-Password і Custom. Client secret Секрет цього застосунку. Після збереження ніколи не показується. Залишивши поле порожнім пізніше, ви збережете наявний секрет. Ендпоінти й callback Ендпоінт авторизації, Ендпоінт токена, Ендпоінт даних користувача і Шлях callback. Для стандартних провайдерів заповнюються автоматично. Змінюйте їх, лише коли так радить посібник. Правила доступу за email Дозволені домени email, Заблоковані домени email і Заблоковані адреси email. Необов’язково. Див. Правила доступу. Користувачі для входу Імена користувачів і паролі. Лише для типів Username-Password і Custom. Щоб видалити провайдера, натисніть Видалити провайдера. Його буде видалено з вашого облікового запису та з налаштувань SSO ваших тунелів.
-
Увімкніть його для тунелю #
У розділі Ваші тунелі натисніть Налаштування біля тунелю. На панелі Налаштування тунелю знайдіть SSO-провайдери і натисніть Керувати. Відкриється діалог Єдиний вхід (SSO).
Налаштування Що робить Вимагати вхід Вмикає SSO для цього тунелю. Відвідувачів, які не ввійшли, спершу відправляють на сторінку входу. Провайдери По одному перемикачу для кожного вашого активного провайдера. Увімкніть принаймні один. Якщо ввімкнено кілька, відвідувач обирає на сторінці входу. Хто може входити Необов’язкові списки Адреси email, Домени email та Імена користувачів для цього тунелю. Шляхи входу та виходу Необов’язкові Шляхи входу і Шлях виходу. Натисніть Зберегти.
-
Перевірте #
Відкрийте URL тунелю в приватному вікні браузера. Ви маєте потрапити на сторінку Sign in to continue, а після входу — на свій сервіс.
Redirect URI #
Зовнішній провайдер запитує, куди він може надсилати людей після входу. Для кожного тунелю це адреса на хості входу Localtonet, а не адреса вашого тунелю. Зареєструйте саме це значення:
http://auth.localtonet.com/auth/callbackКожен посібник для провайдера підказує, де його ввести.
| Значення | Куди його вводити |
|---|---|
| Redirect URI, наведений вище | У провайдера: Authorized redirect URIs (Google), Authorization callback URL (GitHub), Redirect URI (Microsoft, GitLab). |
Шлях callback, наприклад /auth/callback/google | У Localtonet, у розділі Ендпоінти й callback. Його заповнено за вас. Залиште як є. |
Провайдер порівнює redirect URI із зареєстрованим значенням точно, тому копіюйте його так, як воно показано тут.
Правила доступу #
Вхід доводить, хто такий відвідувач. Правила вирішують, чи може ця людина відкрити тунель. Є два рівні, і діють обидва.
| Де | Список | Що каже панель керування |
|---|---|---|
| Провайдер | Дозволені домени email | Залиште порожнім, щоб не обмежувати домени. Підтримка шаблонів залежить від провайдера. |
| Провайдер | Заблоковані домени email | Блокувати вхід із цих доменів email. |
| Провайдер | Заблоковані адреси email | Блокувати ці окремі адреси email. |
| Тунель | Адреси email, Домени email, Імена користувачів | Залиште список порожнім, щоб пропустити цю перевірку. Списки діють для всіх провайдерів, ввімкнених для тунелю. |
Вводьте по одному елементу в рядок або розділяйте елементи комами. Домен вводиться без @, наприклад example.com.
Після зміни правила відвідувач, якого вже пустили, може зберігати доступ до п’яти хвилин. Відвідувача, якому відмовили, перевіряють знову через одну хвилину.
Шляхи входу та шлях виходу #
| Налаштування | Поведінка | Приклад |
|---|---|---|
| Шляхи входу | Порожньо: вхід потрібен для кожного шляху тунелю. Заповнено: вхід потрібен лише для запитів, шлях яких починається з одного із записів. | /admin охоплює /admin і /admin/users, але не /administrator. |
| Шлях виходу | Відкриття цього шляху скасовує вхід для цього тунелю та відправляє відвідувача на початкову сторінку тунелю або на адресу із запиту returnUrl. | /sso/logout |
Шляхи починаються зі скісної риски. Регістр літер не має значення.
Заповнений список «Шляхи входу» відкриває все інше. Якщо в списку є /admin, захищено лише /admin, а всі інші шляхи доступні без входу. Залиште список порожнім, щоб захистити весь тунель.
Шлях виходу виводить відвідувача лише з тунелю. Він не виводить його з Google, GitHub чи іншого провайдера ідентифікації.
Усунення несправностей #
«Щоб користуватися цією функцією, поповніть баланс.»
SSO потребує балансу. Поповніть баланс і збережіть знову. Без балансу ви все одно можете відкрити діалог і вимкнути Вимагати вхід.
«Додайте провайдера, перш ніж вмикати вхід.»
У вас ще немає активного провайдера. Натисніть Додати провайдера у діалозі або скористайтеся кнопкою SSO угорі сторінки HTTP.
«Увімкніть принаймні одного провайдера або вимкніть вхід.»
Вимагати вхід увімкнено, але жоден перемикач провайдера не ввімкнено. Провайдер, якого ви зробили неактивним, вимикається на своїх тунелях і більше не показується в списку.
Сторінка входу показує «No authentication providers are currently configured for this tunnel.»
Вхід обов’язковий, але для цього тунелю не ввімкнено жодного провайдера. Відкрийте SSO-провайдери › Керувати на тунелі й ввімкніть одного.
Тунель відкривається без запиту на вхід
Переконайтеся, що Вимагати вхід увімкнено й збережено. Якщо заповнено Шляхи входу, захищено лише ці шляхи. Також перевіряйте в приватному вікні: ваш власний браузер може бути вже авторизований.
«403 - Access Denied» після входу
Вхід вдався, але правило відмовило обліковому запису. Перевірте Правила доступу за email провайдера та списки Хто може входити тунелю. Виправивши правило, зачекайте хвилину й перезавантажте сторінку.
Вебхук або API-клієнт отримує перенаправлення замість відповіді
Запити без cookie входу перенаправляються на сторінку входу. Вказуйте в Шляхи входу лише сторінки, призначені для людей, або використовуйте окремий тунель для машинного трафіку.
Автоматизація #
Провайдерами та налаштуваннями SSO тунелю також можна керувати через API, за адресою /api/v2/sso-providers, і через MCP-сервер.