HandyCafe Docs
owner it-admin

Як налаштувати вхід через OAuth

Цей посібник проведе вас через налаштування соціального входу для клієнтів через Google, Facebook, Apple, X або Discord. HandyCafe використовує Device Authorization Grant (RFC 8628). Клієнти сканують QR-код телефоном для автентифікації.

Як налаштувати Google OAuth

Частина A: Створення облікових даних Google Cloud

  1. Відкрийте Google Cloud Console (https://console.cloud.google.com ).
  2. Створіть новий проект або оберіть існуючий.
  3. Перейдіть до APIs & Services > OAuth consent screen. Оберіть External.
  4. Заповніть обов'язкові поля та збережіть.
  5. Перейдіть до APIs & Services > Credentials.
  6. Натисніть Create Credentials > OAuth client ID.
  7. Тип додатку: TVs and Limited Input devices. Це критично.
  8. Скопіюйте Client ID та Client Secret.

Частина B: Налаштування HandyCafe Server

  1. Перейдіть до Налаштування > OAuth.
  2. Увімкніть головний перемикач OAuth.
  3. Увімкніть Google та вставте Client ID та Client Secret.
  4. Натисніть Зберегти.

Частина C: Тестування

  1. На клієнтському ПК натисніть кнопку входу через Google.
  2. З'являється QR-код та код користувача.
  3. Скануйте QR-код телефоном та авторизуйтесь.
  4. На сервері з'являється запит на сторінці Запитів.

Як схвалити запит на вхід

  1. При отриманні сповіщення перейдіть до Запитів.
  2. Перегляньте дані: провайдер, ім'я, email, ПК.
  3. Натисніть Схвалити.

Результат: Обліковий запис учасника створюється або прив'язується. Клієнтський сеанс починається.

Як налаштувати Facebook OAuth

  1. Відкрийте Facebook Developer Portal. Створіть додаток типу Consumer.
  2. Додайте Facebook Login for Devices.
  3. У HandyCafe: Налаштування > OAuth > Facebook > вставте App ID та App Secret. Зберегти.

Як налаштувати Discord OAuth

  1. Відкрийте Discord Developer Portal. Створіть додаток.
  2. Скопіюйте Client ID та згенеруйте Client Secret.
  3. У HandyCafe: Налаштування > OAuth > Discord > вставте дані. Зберегти.

Типові помилки

  • Неправильний тип OAuth-клієнта у Google Cloud. Потрібен "TVs and Limited Input devices".
  • Забуття увімкнити головний перемикач OAuth.
  • Не моніторити сторінку Запитів. Клієнти чекатимуть безкінечно.
  • Плутання Client ID та Client Secret.
  • Не опублікувати додаток Google (залишити у режимі Testing).