Перейти к содержимому
Localtonet Localtonet Панель управления

Единый вход через GitLab

Требуется баланс HTTP-туннели

Помощь по этой странице
На этой странице 4 раздела
  1. Перед началом
  2. Шаги
  3. Создайте приложение OAuth в GitLab
  4. Добавьте провайдера в Localtonet
  5. Включите его для туннеля
  6. Проверьте
  7. Устранение неполадок
  8. Связанные страницы

Позвольте посетителям входить с помощью аккаунта GitLab, прежде чем они смогут открыть HTTP-туннель. Это работает с GitLab.com и с собственным экземпляром GitLab. Вы создаёте приложение OAuth в GitLab, добавляете его в Localtonet как провайдера, а затем включаете для туннеля.

Перед началом #

  • HTTP-туннель и баланс на вашем аккаунте. См. обзор единого входа.
  • Аккаунт GitLab на GitLab.com или на вашем собственном экземпляре.
  • Для собственного экземпляра: его адрес должен быть доступен из интернета. Браузеры ваших посетителей открывают его страницу входа, а узел входа Localtonet обращается к его эндпоинтам токена и пользователя напрямую.

Шаги #

  1. Создайте приложение 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 URIhttp://auth.localtonet.com/auth/callback
    ConfidentialОставьте выбранным.
    Scopesread_user

    Затем GitLab показывает Application ID и Secret. Скопируйте оба сразу: GitLab показывает секрет только сразу после создания приложения.

    Область read_user даёт доступ на чтение к профилю вошедшего пользователя через эндпоинт /api/v4/user, который Localtonet подставляет как Эндпоинт данных пользователя. Это единственная область, которую запрашивает вход, поэтому другие области приложению не нужны.

  2. Добавьте провайдера в Localtonet #

    Откройте Мои туннели › HTTP и выберите SSO вверху страницы. В окне SSO-провайдеры выберите Добавить провайдера.

    ПолеЗначение
    Название провайдераЛюбое название, например Company GitLab. Вы увидите его в настройках туннеля.
    Тип провайдераGitLab. Смена типа сохранённого провайдера очищает Client ID, поэтому введите идентификатор клиента и секрет клиента заново.
    АктивенВключено
    Client IDApplication ID из GitLab.
    Client SecretSecret из 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.

    При желании заполните Правила доступа по эл. почте, затем выберите Сохранить провайдера.

  3. Включите его для туннеля #

    В разделе Ваши туннели выберите Настройки у туннеля, затем Управлять рядом с SSO-провайдеры. В окне Единый вход (SSO) включите Требовать вход и переключатель вашего провайдера GitLab. Выберите Сохранить.

    На GitLab.com аккаунт может создать любой. Без правила любой пользователь GitLab.com, знающий адрес, может открыть туннель. Заполните Кто может войти у туннеля или Разрешённые почтовые домены у провайдера. Эти списки описаны в обзоре.

  4. Проверьте #

    Откройте 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

Провайдер не включён для этого туннеля или помечен как неактивный. Проверьте оба варианта.

Поддержка