- Доступ к API: кто может вызвать GOWA. Это базовая HTTP аутентификация.
- Соединение с 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. Приборная панель управляет этим потоком. Чтобы управлять им сами:
GET /app/passkeyвозвращает вызов.POST /app/passkey/responseпредставляет утверждение WebAuthn (форматPublicKeyCredential.toJSON()).- Дождитесь
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. Защищайте резервные копии с той же осторожностью.
