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