Перейти до вмісту
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. Після збереження він ніколи не відображається.

    У розділі Ендпоінти й callback стандартні адреси GitHub заповнюються автоматично. Залиште їх без змін:

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

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

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

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

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

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

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

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

GitHub повідомляє про невідповідність URI переспрямування

Помилка GitHub — redirect_uri_mismatch: «The redirect_uri MUST match the registered callback URL for this application.» Жодна callback URL застосунку OAuth не збігається з надісланою адресою. Задайте Authorization callback URL на GitHub точно як http://auth.localtonet.com/auth/callback.

Відвідувачу відмовляють, хоча його адреса є в списку

Стандартний Ендпоінт даних користувача, https://api.github.com/user, може не повернути адресу електронної пошти, якщо користувач GitHub не вказав публічну пошту у своєму профілі. Попросіть відвідувача перевірити, яку адресу вказано як публічну пошту в його профілі GitHub, і порівняйте її зі своїми списками.

«403 - Access Denied» після успішного входу в GitHub

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

Вхід не вдається до або після сторінки авторизації GitHub

Звірте Client ID і Client secret, збережені в Localtonet, із застосунком OAuth. Вставте Client ID ще раз, згенеруйте новий client secret на GitHub, вставте його в провайдера й натисніть Зберегти провайдера.

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

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

Підтримка