Единый вход через GitHub
Нужен Баланс HTTP-туннели
На этой странице 4 раздела
Позвольте посетителям входить с учётной записью GitHub, прежде чем они смогут открыть HTTP-туннель. Вы регистрируете приложение OAuth на GitHub, добавляете его в Localtonet как провайдера, а затем включаете для туннеля.
Перед началом #
- HTTP-туннель и Баланс на вашем аккаунте. См. обзор единого входа.
- Учётная запись GitHub. Чтобы зарегистрировать приложение для организации, нужен доступ к настройкам этой организации.
Шаги #
-
Зарегистрируйте приложение OAuth на GitHub #
Собственное руководство GitHub: Creating an OAuth app. Вкратце:
- На GitHub откройте меню под вашей фотографией профиля и выберите Settings, затем Developer settings, затем OAuth apps.
- Выберите New OAuth App. Если у вас ещё нет приложений, кнопка называется Register a new application.
- Заполните форму значениями ниже и выберите Register application.
- На странице нового приложения скопируйте Client ID, затем выберите Generate a new client secret и сразу скопируйте секрет.
Поле GitHub Значение Application name Название, которое узнают ваши посетители. GitHub показывает его, когда просит их авторизовать приложение. Homepage URL Веб-адрес, описывающий приложение, например ваш сайт. Authorization callback URL http://auth.localtonet.com/auth/callbackEnable Device Flow Оставьте выключенным. Области доступа (scopes) на GitHub вы не выбираете. Их называет запрос на вход:
read:userиuser:email. GitHub просит посетителя одобрить их при первом входе. -
Добавьте провайдера в Localtonet #
Откройте Мои туннели › HTTP и выберите SSO вверху страницы. В диалоге SSO-провайдеры выберите Добавить провайдера.
Поле Значение Название провайдера Любое название, например GitHub. Вы увидите его в настройках туннеля.Тип провайдера GitHub. При смене типа сохранённого провайдера поле Client ID очищается, поэтому введите client ID и client secret заново. Активен Включено Client ID Client ID из GitHub. Client Secret Client secret из GitHub. После сохранения он больше не отображается. В разделе Эндпоинты и колбэк стандартные адреса GitHub подставляются автоматически. Оставьте их как есть:
Поле Подставленное значение Эндпоинт авторизации https://github.com/login/oauth/authorizeЭндпоинт токена https://github.com/login/oauth/access_tokenЭндпоинт данных пользователя https://api.github.com/userПуть колбэка /auth/callback/githubПри желании заполните Правила доступа по эл. почте, затем выберите Сохранить провайдера.
-
Включите его для туннеля #
В разделе Ваши туннели выберите Настройки у туннеля, затем Управлять рядом с SSO-провайдеры. В диалоге Единый вход (SSO) включите Требовать вход и переключатель вашего провайдера GitHub. Выберите Сохранить.
Учётную запись GitHub может создать любой человек. Без правила любой пользователь GitHub, знающий адрес, может открыть туннель. Заполните Кто может войти у туннеля или Разрешённые почтовые домены у провайдера. Списки описаны в обзоре.
-
Проверьте #
Откройте URL туннеля в приватном окне браузера. Localtonet показывает Sign in to continue с кнопкой для вашего провайдера. При первом входе GitHub просит вас авторизовать приложение. После этого вы возвращаетесь на туннель, и ваша служба загружается.
Устранение неполадок #
GitHub сообщает о несовпадении redirect URI
Ошибка GitHub — redirect_uri_mismatch: "The redirect_uri MUST match the registered callback URL for this application." Ни один callback URL приложения OAuth не совпадает с отправленным адресом. Укажите на GitHub в Authorization callback URL ровно http://auth.localtonet.com/auth/callback.
Посетителю отказано, хотя его адрес есть в списке
Эндпоинт данных пользователя по умолчанию, https://api.github.com/user, может не вернуть адрес электронной почты, если пользователь GitHub не указал публичный адрес в своём профиле. Попросите посетителя проверить, какой адрес указан как публичный в его профиле GitHub, и сравните его со своими списками.
«403 - Access Denied» после успешного входа в GitHub
Правило Localtonet отклонило учётную запись. Проверьте Правила доступа по эл. почте у провайдера и Кто может войти у туннеля. После исправления правила подождите минуту и перезагрузите страницу.
Вход не работает до страницы авторизации GitHub или после неё
Сверьте Client ID и Client Secret, сохранённые в Localtonet, с приложением OAuth. Вставьте Client ID заново, сгенерируйте на GitHub новый client secret, вставьте его в провайдера и выберите Сохранить провайдера.
На странице входа нет кнопки GitHub
Провайдер не включён для этого туннеля или помечен как неактивный. Проверьте оба условия.