Единый вход (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 Секрет этого приложения. После сохранения не отображается. Позже оставьте поле пустым, чтобы сохранить текущий секрет. Эндпоинты и колбэк Эндпоинт авторизации, Эндпоинт токена, Эндпоинт данных пользователя и Путь колбэка. Для стандартных провайдеров заполняются автоматически. Меняйте их, только если так сказано в руководстве. Правила доступа по эл. почте Разрешённые почтовые домены, Заблокированные почтовые домены и Заблокированные адреса эл. почты. Необязательно. См. Правила доступа. Пользователи для входа Имена пользователей и пароли. Только для типов Username-Password и Custom. Чтобы удалить провайдера, нажмите Удалить провайдера. Он будет удалён из вашего аккаунта и из настроек SSO ваших туннелей.
-
Включите его для туннеля #
В разделе Ваши туннели нажмите Настройки у нужного туннеля. На панели Настройки туннеля найдите SSO-провайдеры и нажмите Управлять. Откроется диалог Единый вход (SSO).
Параметр Что делает Требовать вход Включает SSO для этого туннеля. Посетители, которые не вошли, сначала попадают на страницу входа. Провайдеры По одному переключателю для каждого из ваших активных провайдеров. Включите хотя бы одного. Если включено несколько, посетитель выбирает на странице входа. Кто может войти Необязательные списки Адреса эл. почты, Почтовые домены и Имена пользователей для этого туннеля. Пути входа и выхода Необязательные Пути входа и Путь выхода. Нажмите Сохранить.
-
Проверьте #
Откройте URL туннеля в приватном окне браузера. Вы должны попасть на страницу Sign in to continue, а после входа — в ваш сервис.
URI перенаправления #
Внешний провайдер спрашивает, куда можно отправлять людей после входа. Для каждого туннеля это адрес на хосте входа Localtonet, а не адрес вашего туннеля. Зарегистрируйте именно это значение:
http://auth.localtonet.com/auth/callbackВ руководстве каждого провайдера сказано, куда его вводить.
| Значение | Куда вводить |
|---|---|
| URI перенаправления, указанный выше | У провайдера: Authorized redirect URIs (Google), Authorization callback URL (GitHub), Redirect URI (Microsoft, GitLab). |
Путь колбэка, например /auth/callback/google | В Localtonet, в разделе Эндпоинты и колбэк. Заполняется автоматически. Оставьте как есть. |
Провайдер сверяет URI перенаправления с зарегистрированным значением посимвольно, поэтому копируйте его в том виде, в каком он показан здесь.
Правила доступа #
Вход подтверждает, кто такой посетитель. Правила решают, может ли этот человек открыть туннель. Есть два уровня, и действуют оба.
| Где | Список | Что сказано в панели управления |
|---|---|---|
| Провайдер | Разрешённые почтовые домены | Оставьте пустым, чтобы не ограничивать домены. Поддержка подстановочных знаков зависит от провайдера. |
| Провайдер | Заблокированные почтовые домены | Блокировать вход с этих почтовых доменов. |
| Провайдер | Заблокированные адреса эл. почты | Блокировать эти отдельные адреса эл. почты. |
| Туннель | Адреса эл. почты, Почтовые домены, Имена пользователей | Оставьте список пустым, чтобы пропустить эту проверку. Списки действуют для всех провайдеров, включённых для туннеля. |
Вводите по одному элементу в строке или разделяйте элементы запятыми. Домен вводится без @, например 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» после входа
Вход выполнен, но аккаунт отклонило какое-то правило. Проверьте Правила доступа по эл. почте провайдера и списки Кто может войти у туннеля. После исправления правила подождите минуту и перезагрузите страницу.
Вебхук или API-клиент получает перенаправление вместо ответа
Запросы без cookie входа перенаправляются на страницу входа. Указывайте в Пути входа только страницы, предназначенные для людей, или используйте отдельный туннель для машинного трафика.
Автоматизация #
Провайдеров и настройки SSO туннелей можно также настраивать через API по адресу /api/v2/sso-providers и через MCP-сервер.