Единый вход через GitLab
Требуется баланс HTTP-туннели
На этой странице 4 раздела
Позвольте посетителям входить с помощью аккаунта GitLab, прежде чем они смогут открыть HTTP-туннель. Это работает с GitLab.com и с собственным экземпляром GitLab. Вы создаёте приложение OAuth в GitLab, добавляете его в Localtonet как провайдера, а затем включаете для туннеля.
Перед началом #
- HTTP-туннель и баланс на вашем аккаунте. См. обзор единого входа.
- Аккаунт GitLab на GitLab.com или на вашем собственном экземпляре.
- Для собственного экземпляра: его адрес должен быть доступен из интернета. Браузеры ваших посетителей открывают его страницу входа, а узел входа Localtonet обращается к его эндпоинтам токена и пользователя напрямую.
Шаги #
-
Создайте приложение OAuth в GitLab #
Собственное руководство GitLab — Configure GitLab as an OAuth 2.0 authentication identity provider. Приложение может принадлежать пользователю, группе или всему экземпляру:
Владелец Где создать Ваш пользователь Выберите свой аватар, затем Edit profile, затем Access › Applications и Add new application. Группа Откройте группу, затем Settings › Applications. Экземпляр (собственный, только для администраторов) Admin › Applications и New application. Заполните форму и выберите Save application:
Поле GitLab Значение Name Название, которое узнают ваши посетители. GitLab показывает его, когда просит их авторизовать приложение. Redirect URI http://auth.localtonet.com/auth/callbackConfidential Оставьте выбранным. Scopes read_userЗатем GitLab показывает Application ID и Secret. Скопируйте оба сразу: GitLab показывает секрет только сразу после создания приложения.
Область
read_userдаёт доступ на чтение к профилю вошедшего пользователя через эндпоинт/api/v4/user, который Localtonet подставляет как Эндпоинт данных пользователя. Это единственная область, которую запрашивает вход, поэтому другие области приложению не нужны. -
Добавьте провайдера в Localtonet #
Откройте Мои туннели › HTTP и выберите SSO вверху страницы. В окне SSO-провайдеры выберите Добавить провайдера.
Поле Значение Название провайдера Любое название, например Company GitLab. Вы увидите его в настройках туннеля.Тип провайдера GitLab. Смена типа сохранённого провайдера очищает Client ID, поэтому введите идентификатор клиента и секрет клиента заново. Активен Включено Client ID Application ID из GitLab. Client Secret Secret из GitLab. После сохранения он больше не отображается. Откройте Эндпоинты и колбэк. Адреса GitLab.com подставляются автоматически. Для собственного экземпляра замените
gitlab.comименем хоста вашего экземпляра в первых трёх полях.GitLab.com
Поле Подставленное значение Эндпоинт авторизации https://gitlab.com/oauth/authorizeЭндпоинт токена https://gitlab.com/oauth/tokenЭндпоинт данных пользователя https://gitlab.com/api/v4/userПуть колбэка /auth/callback/gitlabСобственный экземпляр
Поле Что ввести Эндпоинт авторизации https://<YOUR_GITLAB_HOST>/oauth/authorizeЭндпоинт токена https://<YOUR_GITLAB_HOST>/oauth/tokenЭндпоинт данных пользователя https://<YOUR_GITLAB_HOST>/api/v4/userПуть колбэка /auth/callback/gitlab(без изменений)Redirect URI в приложении GitLab остаётся адресом Localtonet из шага 1. Он не содержит вашего хоста GitLab.
При желании заполните Правила доступа по эл. почте, затем выберите Сохранить провайдера.
-
Включите его для туннеля #
В разделе Ваши туннели выберите Настройки у туннеля, затем Управлять рядом с SSO-провайдеры. В окне Единый вход (SSO) включите Требовать вход и переключатель вашего провайдера GitLab. Выберите Сохранить.
На GitLab.com аккаунт может создать любой. Без правила любой пользователь GitLab.com, знающий адрес, может открыть туннель. Заполните Кто может войти у туннеля или Разрешённые почтовые домены у провайдера. Эти списки описаны в обзоре.
-
Проверьте #
Откройте URL туннеля в приватном окне браузера. Localtonet показывает Sign in to continue с кнопкой вашего провайдера. При первом входе GitLab просит авторизовать приложение. После этого вы возвращаетесь на туннель, и ваш сервис загружается.
Устранение неполадок #
GitLab сообщает, что указанный redirect URI недопустим
Ни один Redirect URI приложения GitLab не совпадает с отправленным адресом. Введите в качестве Redirect URI приложения в точности http://auth.localtonet.com/auth/callback.
GitLab сообщает, что запрошенная область недействительна, неизвестна или неверно сформирована
Запрошенная область не выбрана в приложении GitLab. Измените приложение и выберите read_user.
GitLab сообщает, что клиентская аутентификация не удалась
Client ID или Client Secret, сохранённые в Localtonet, не соответствуют приложению GitLab. Вставьте Application ID и Secret заново и выберите Сохранить провайдера. Если вы обновите секрет в GitLab, приложение перестанет работать, пока вы не сохраните новый секрет в Localtonet.
Вход через собственный экземпляр никогда не завершается
Проверьте три эндпоинта на опечатки и убедитесь, что экземпляр отвечает из интернета. Если он использует HTTPS, ему нужен сертификат, которому доверяют публичные клиенты. Экземпляр, доступный только внутри вашей сети, использовать нельзя.
«403 - Access Denied» после успешного входа через GitLab
Правило Localtonet отклонило аккаунт. Проверьте Правила доступа по эл. почте у провайдера и Кто может войти у туннеля. После исправления правила подождите минуту и перезагрузите страницу.
На странице входа нет кнопки GitLab
Провайдер не включён для этого туннеля или помечен как неактивный. Проверьте оба варианта.