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

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

Нужен Баланс HTTP-туннели

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

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

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

  • HTTP-туннель и Баланс на вашем аккаунте. См. обзор единого входа.
  • Учётная запись GitHub. Чтобы зарегистрировать приложение для организации, нужен доступ к настройкам этой организации.

Шаги #

  1. Зарегистрируйте приложение OAuth на GitHub #

    Собственное руководство GitHub: Creating an OAuth app. Вкратце:

    1. На GitHub откройте меню под вашей фотографией профиля и выберите Settings, затем Developer settings, затем OAuth apps.
    2. Выберите New OAuth App. Если у вас ещё нет приложений, кнопка называется Register a new application.
    3. Заполните форму значениями ниже и выберите Register application.
    4. На странице нового приложения скопируйте Client ID, затем выберите Generate a new client secret и сразу скопируйте секрет.
    Поле GitHubЗначение
    Application nameНазвание, которое узнают ваши посетители. GitHub показывает его, когда просит их авторизовать приложение.
    Homepage URLВеб-адрес, описывающий приложение, например ваш сайт.
    Authorization callback URLhttp://auth.localtonet.com/auth/callback
    Enable Device FlowОставьте выключенным.

    Области доступа (scopes) на GitHub вы не выбираете. Их называет запрос на вход: read:user и user:email. GitHub просит посетителя одобрить их при первом входе.

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

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

    ПолеЗначение
    Название провайдераЛюбое название, например GitHub. Вы увидите его в настройках туннеля.
    Тип провайдераGitHub. При смене типа сохранённого провайдера поле Client ID очищается, поэтому введите client ID и client secret заново.
    АктивенВключено
    Client IDClient ID из GitHub.
    Client SecretClient secret из GitHub. После сохранения он больше не отображается.

    В разделе Эндпоинты и колбэк стандартные адреса GitHub подставляются автоматически. Оставьте их как есть:

    ПолеПодставленное значение
    Эндпоинт авторизацииhttps://github.com/login/oauth/authorize
    Эндпоинт токенаhttps://github.com/login/oauth/access_token
    Эндпоинт данных пользователяhttps://api.github.com/user
    Путь колбэка/auth/callback/github

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

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

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

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

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

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

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

Поддержка