Єдиний вхід (SSO) через GitLab
Потрібен баланс HTTP-тунелі
На цій сторінці 4 розділи
Дозвольте відвідувачам входити за допомогою облікового запису GitLab, перш ніж вони зможуть відкрити HTTP-тунель. Це працює з GitLab.com і з власним екземпляром GitLab. Ви створюєте застосунок OAuth у GitLab, додаєте його в Localtonet як провайдера, а потім вмикаєте для тунелю.
Перш ніж почати #
- HTTP-тунель і баланс на вашому обліковому записі. Див. огляд єдиного входу (SSO).
- Обліковий запис 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. Після збереження він ніколи не відображається. Відкрийте Ендпоінти й 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, потім виберіть Зберегти провайдера.
-
Увімкніть його для тунелю #
У розділі Ваші тунелі виберіть Налаштування тунелю, потім Керувати біля SSO-провайдери. У діалозі Єдиний вхід (SSO) увімкніть Вимагати вхід і перемикач вашого провайдера GitLab. Виберіть Зберегти.
На GitLab.com обліковий запис може створити будь-хто. Без правила кожен користувач GitLab.com, який знає адресу, може відкрити тунель. Заповніть Хто може входити для тунелю або Дозволені домени email для провайдера. Списки пояснено в огляді.
-
Перевірте #
Відкрийте 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
Провайдера не ввімкнено для цього тунелю, або його встановлено як неактивного. Перевірте обидва варіанти.