Перейти к основному содержанию
GOWA имеет два вида аутентификации:
  1. Доступ к API: кто может вызвать GOWA. Это базовая HTTP аутентификация.
  2. Соединение с WhatsApp: привязка учетной записи WhatsApp к слоту устройства, так как вы связали бы WhatsApp Web.

Доступ к API: основная аутентификация

Базовая аутентификация - единственный метод API. Ключи API или JWT для REST вызовов отсутствуют. Задайте одну или несколько пар user:password, разделённых запятыми:
Каждая запись должна содержать непустое имя пользователя и пароль. По умолчанию слушатель APP_HOST=0.0.0.0, отказывается запускать без полных учетных данных. Для локальной разработки без аутентификации привяжите APP_HOST=127.0.0.1. Если обратный прокси аутентифицирует каждого вызывающего абонента, то APP_ALLOW_UNAUTHENTICATED=true или --allow-unauthenticated=true явно разрешает слушателю без Базового Автора. Ограничивает прямой доступ к этому слушателю. Отправлять учетные данные при каждом запросе:
Пропущенные или неправильные учетные данные возвращают 401 Unauthorized.

Что не стоит за Базовой Авторизацией

Все остальное, включая панель инструментов /, /mcp и /ws, при настройке требует Базового Авторизации.

Веб-сокет

Браузеры не могут установить заголовки при соединениях WebSockt, поэтому /ws принимает учетные данные в строке запроса:
authorization это base64(user:password). Используйте TLS (wss://) и redact строку запроса в журналах прокси. WebSocket проверяет происхождение браузера на соответствие тем же доверенным источникам, которые используются при изменении состояния HTTP-запросов. Текущий хаб WebSocket транслирует события во все подключенные сокеты. Запрос device_id выбирает контекст устройства для подключения, но не изолирует доставку событий. Используйте идентификаторы устройства для фильтрации панели управления и предоставления API доступа только вызывающим, доверенным всем устройствам. Смотрите ссылка на WebSocket для кодов событий, полезных загрузок и пример клиента.

CORS

CORS разрешает любой источник по умолчанию. Ограничивает его через APP_CORS_ALLOWED_ORIGINS=https://ui.example.com (через запятую). Допустимые заголовки запросов являются Origin, Content-Type, Accept, Authorization и X-Device-Id. CORS и браузер проверки происхождения разделены. Подстановочный код CORS не разрешает смену состояния или WebSockets. GOWA доверяет собственному хосту запроса, конкретному источнику CORS, APP_TRUSTED_ORIGINS и происхождению, настроенному на URL-адрес обратного вызова OAuth и Chatwoot. Для отдельной приборной панели настройте её точное происхождение:
Недоверенная мутация браузера возвращает 403 CROSS_SITE_REQUEST_BLOCKED. Также она описывает маршруты GET, которые войдут в систему, выйти, переподключить или сбросить ссылку-приглашение. Клиенты, такие как curl, которые не посылают заголовки браузера в дальнейшем продолжают работать. Происхождение null никогда не доверяется. Сервер gowa-ui.html через HTTP или HTTPS вместо открытия его в качестве URL-адреса file://. За обратным прокси, сохраните Host, настройте доверенные прокси с помощью X-Forwarded-Host или укажите общественное происхождение в APP_TRUSTED_ORIGINS.

WhatsApp сопряжения

Каждая учётная запись WhatsApp занимает слот устройства. Сначала создайте слот, затем выполните сопряжение. Маршруты в /devices/{device_id} определяют устройство по пути. Эквивалентные маршруты /app/* используют заголовок X-Device-Id.

QR code

Откройте qr_link и отсканируйте его с телефона: Настройки → Связанные устройства → Связать устройство. Запросить новый код после qr_duration секунд. Панель инструментов / показывает QR непосредственно и обновляется в реальном времени через WebSocket.

Pairing code

Ответ содержит код results.pair_code, 8-символьный код. В телефоне выберите Связать с номером телефона и введите его. phone должен быть числом привязанного аккаунта, с кодом страны.

Пароль

Если телефон запрашивает верификацию ключа при входе QR, GOWA хранит вызов WebAuthn и транслирует файл PASSKEY_REQUEST на WebSocket. Приборная панель управляет этим потоком. Чтобы управлять им сами:
  1. GET /app/passkey возвращает вызов.
  2. POST /app/passkey/response представляет утверждение WebAuthn (формат PublicKeyCredential.toJSON()).
  3. Дождитесь PASSKEY_CONFIRMATION. Когда result.skip_handoff_ux активный QR-поток отправляет подтверждение автоматически. В противном случае сравните result.code с кодом на телефоне, затем вызовите POST /app/passkey/confirm.
Отправить X-Device-Id на все три звонка.

Проверить результат

results.is_connected и results.is_logged_in являются true после привязки аккаунта. Сессии сохраняются в storages/, поэтому перезапуск не требует подключения снова.

Выход и удаление

Учетная запись, отвязанная от телефона (привязанные устройства → Выйти) выходит таким же образом: слот остается и требует подключения снова.

Контрольный список безопасности

  • Всегда устанавливайте APP_BASIC_AUTH с надежными паролями на любое доступное из сети.
  • Завершить TLS на обратном прокси; Базовые учетные данные Auth кодируются только в base64.
  • Ограничить APP_CORS_ALLOWED_ORIGINS при вызове интерфейса браузера.
  • Генерируйте стабильный WHATSAPP_WEBHOOK_SECRET с помощью openssl rand -hex 32. Пустые или опубликованные примеры секретов заменяются случайным ключом каждого процесса, который меняется при перезапуске.
  • Считайте storages/ чувствительным. Он содержит все привязанные ключи сессии. Новые файлы SQLite используют права владельца и созданные для них каталоги используют 0700. Защищайте резервные копии с той же осторожностью.