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

Єдиний вхід (SSO) через GitLab

Потрібен баланс HTTP-тунелі

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

Дозвольте відвідувачам входити за допомогою облікового запису GitLab, перш ніж вони зможуть відкрити HTTP-тунель. Це працює з GitLab.com і з власним екземпляром GitLab. Ви створюєте застосунок OAuth у GitLab, додаєте його в Localtonet як провайдера, а потім вмикаєте для тунелю.

Перш ніж почати #

  • HTTP-тунель і баланс на вашому обліковому записі. Див. огляд єдиного входу (SSO).
  • Обліковий запис 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. Після збереження він ніколи не відображається.

    Відкрийте Ендпоінти й callback. Адреси GitLab.com заповнюються автоматично. Для власного екземпляра замініть gitlab.com іменем хоста вашого екземпляра в перших трьох полях.

    GitLab.com

    ПолеАвтоматично заповнене значення
    Ендпоінт авторизаціїhttps://gitlab.com/oauth/authorize
    Ендпоінт токенаhttps://gitlab.com/oauth/token
    Ендпоінт даних користувачаhttps://gitlab.com/api/v4/user
    Шлях callback/auth/callback/gitlab

    Власний екземпляр

    ПолеЗначення для введення
    Ендпоінт авторизаціїhttps://<YOUR_GITLAB_HOST>/oauth/authorize
    Ендпоінт токенаhttps://<YOUR_GITLAB_HOST>/oauth/token
    Ендпоінт даних користувачаhttps://<YOUR_GITLAB_HOST>/api/v4/user
    Шлях callback/auth/callback/gitlab (без змін)

    Redirect URI у застосунку GitLab залишається адресою Localtonet із кроку 1. Вона не містить вашого хоста GitLab.

    За бажанням заповніть Правила доступу за email, потім виберіть Зберегти провайдера.

  3. Увімкніть його для тунелю #

    У розділі Ваші тунелі виберіть Налаштування тунелю, потім Керувати біля SSO-провайдери. У діалозі Єдиний вхід (SSO) увімкніть Вимагати вхід і перемикач вашого провайдера GitLab. Виберіть Зберегти.

    На GitLab.com обліковий запис може створити будь-хто. Без правила кожен користувач GitLab.com, який знає адресу, може відкрити тунель. Заповніть Хто може входити для тунелю або Дозволені домени email для провайдера. Списки пояснено в огляді.

  4. Перевірте #

    Відкрийте URL-адресу тунелю в приватному вікні браузера. Localtonet показує Sign in to continue із кнопкою для вашого провайдера. Під час першого входу GitLab просить вас надати дозвіл застосунку. Після цього вас повертає до тунелю, і ваш сервіс завантажується.

Усунення несправностей #

GitLab каже, що вказаний redirect URI недійсний

Жоден Redirect URI застосунку GitLab не збігається з надісланою адресою. Введіть точно http://auth.localtonet.com/auth/callback як Redirect URI застосунку.

GitLab каже, що запитана область недійсна, невідома або має неправильний формат

Запитану область не вибрано в застосунку GitLab. Відредагуйте застосунок і виберіть read_user.

GitLab каже, що автентифікація клієнта не вдалася

Client ID або Client secret, збережені в Localtonet, не збігаються із застосунком GitLab. Вставте Application ID і Secret ще раз і виберіть Зберегти провайдера. Якщо ви оновите секрет у GitLab, застосунок перестане працювати, доки ви не збережете новий секрет у Localtonet.

Вхід через власний екземпляр ніколи не завершується

Перевірте три ендпоінти на помилки введення й переконайтеся, що екземпляр відповідає з інтернету. Якщо він використовує HTTPS, йому потрібен сертифікат, якому довіряють публічні клієнти. Екземпляр, доступний лише всередині вашої мережі, використати не можна.

«403 - Access Denied» після успішного входу через GitLab

Обліковий запис відхилило правило Localtonet. Перевірте Правила доступу за email для провайдера та Хто може входити для тунелю. Після виправлення правила зачекайте хвилину й перезавантажте сторінку.

На сторінці входу немає кнопки GitLab

Провайдера не ввімкнено для цього тунелю, або його встановлено як неактивного. Перевірте обидва варіанти.

Підтримка