feat(push): Web Push — VAPID, подписки устройств и отправка (AGENT.md 7.16)
Уведомления в браузере и на телефоне: сервер сам решает, кому их слать, и подписывает запрос VAPID-ключом, поэтому уведомление приходит, даже когда клиент закрыт. Сервер: - миграция 00021: `push_subscriptions` (эндпоинт уникален, ключи, счётчик неудач, время последней доставки); - `internal/push` — VAPID-ключи (приватный PKCS#8 из конфига, публичный выводится из него), правила уведомлений повторяют `web/src/lib/desktopNotifications.ts` (упоминания и личные беседы, без своих и системных сообщений), очередь доставки, TTL 12 часов, Topic по комнате; - 404/410 от push-сервиса удаляют подписку сразу, 5 неудач подряд — тоже, иначе копились бы мёртвые эндпоинты; retention чистит «молчащие» подписки; - `internal/httpx/safeurl.go` — общий запрет внутренних адресов с проверкой адреса в момент подключения (DNS rebinding): эндпоинт подписки приходит от клиента, и без проверки сервер сам себе организует SSRF; - `internal/gateway/presence.go` — `IsUserOnline`: если получатель в клиенте, уведомление покажет клиент, дублировать на телефон не нужно; - ручки `GET /push/config`, `GET|POST|DELETE /push/subscriptions`, лимиты 10 подписок и 20 уведомлений в минуту; ключ p256dh проверяется как настоящая точка P-256; - установщик генерирует `VAPID_PRIVATE_KEY` (openssl, PKCS#8 DER в base64) и `VAPID_SUBJECT`, ключ переиспользуется при переустановке; для ручной установки есть `glchat vapid-keys`; `features.web_push_enabled` виден в `/meta`. Тесты: правила и VAPID, доставка с поддельным push-эндпоинтом (шифрование, заголовки VAPID/TTL/Topic, очистка мёртвых подписок), ручки и лимиты, отправка при личном сообщении и упоминании, пропуск онлайн-получателей, миграция на чистой БД.
This commit is contained in:
@@ -45,6 +45,7 @@ glchat — управление инстансом
|
||||
glchat profile [tier] показать/применить профиль производительности
|
||||
glchat security-check аудит: SSH, fail2ban, порты, лимиты
|
||||
glchat reindex пересобрать индекс поиска (FTS5)
|
||||
glchat vapid-keys сгенерировать пару VAPID-ключей для Web Push
|
||||
glchat cleanup чистка: сессии, аудит, файлы без ссылок
|
||||
glchat create-user создать аккаунты (--count/--prefix/--sessions)
|
||||
glchat change-domain <domain> сменить домен
|
||||
@@ -227,6 +228,14 @@ cmd_reindex() {
|
||||
${COMPOSE} exec -T app glchat reindex
|
||||
}
|
||||
|
||||
# cmd_vapid_keys печатает новую пару VAPID-ключей (Фаза 7): строки из вывода
|
||||
# добавляются в .env инстанса вручную — смена ключа отзывает все подписки,
|
||||
# поэтому автоматически её никто не делает.
|
||||
cmd_vapid_keys() {
|
||||
require_stack
|
||||
${COMPOSE} exec -T app glchat vapid-keys "$@"
|
||||
}
|
||||
|
||||
# cmd_cleanup запускает чистку данных вручную: те же правила, что у
|
||||
# периодического обслуживания (AGENT.md 6.4).
|
||||
cmd_cleanup() {
|
||||
@@ -261,6 +270,7 @@ main() {
|
||||
profile) cmd_profile "$@" ;;
|
||||
security-check) cmd_security_check "$@" ;;
|
||||
reindex) cmd_reindex "$@" ;;
|
||||
vapid-keys) cmd_vapid_keys "$@" ;;
|
||||
verify-backup) cmd_verify_backup "$@" ;;
|
||||
cleanup) cmd_cleanup "$@" ;;
|
||||
create-user) cmd_create_user "$@" ;;
|
||||
|
||||
@@ -638,6 +638,24 @@ print("".join(charset[d] for d in out))
|
||||
PYEOF
|
||||
}
|
||||
|
||||
# generate_vapid_key создаёт приватный ключ VAPID (P-256, PKCS#8 DER в base64).
|
||||
# Публичный ключ приложение выводит из приватного, поэтому в .env хранится
|
||||
# только приватный. Без openssl ключ не сделать: функция честно возвращает
|
||||
# ошибку, и Web Push остаётся выключенным.
|
||||
generate_vapid_key() {
|
||||
have openssl || return 1
|
||||
local tmp key
|
||||
tmp="$(mktemp -d)"
|
||||
if ! openssl ecparam -name prime256v1 -genkey -noout -out "${tmp}/key.pem" 2>/dev/null; then
|
||||
rm -rf "$tmp"
|
||||
return 1
|
||||
fi
|
||||
key="$(openssl pkcs8 -topk8 -nocrypt -in "${tmp}/key.pem" -outform DER 2>/dev/null | base64 -w0)"
|
||||
rm -rf "$tmp"
|
||||
[ -n "$key" ] || return 1
|
||||
printf '%s' "$key"
|
||||
}
|
||||
|
||||
generate_secrets() {
|
||||
info "секреты"
|
||||
local env_existing=0
|
||||
@@ -693,6 +711,25 @@ generate_secrets() {
|
||||
LIVEKIT_API_KEY="$(secret_or_new LIVEKIT_API_KEY rand_hex)"
|
||||
LIVEKIT_API_SECRET="$(secret_or_new LIVEKIT_API_SECRET rand_hex)"
|
||||
|
||||
# VAPID-ключ Web Push (Фаза 7, AGENT.md 7.16): приватный ключ P-256 в
|
||||
# PKCS#8 DER (base64 одной строкой), публичный приложение выводит само.
|
||||
# Ключ переиспользуется при повторной установке: его смена отозвала бы все
|
||||
# подписки браузеров, поэтому она возможна только с --rotate-secrets.
|
||||
VAPID_PRIVATE_KEY="$(secret_or_new VAPID_PRIVATE_KEY generate_vapid_key || true)"
|
||||
if [ -z "$VAPID_PRIVATE_KEY" ]; then
|
||||
warn "VAPID-ключ не сгенерирован: Web Push будет выключен (нужен openssl)"
|
||||
fi
|
||||
# Контакт администратора для push-сервисов: значение можно задать заранее,
|
||||
# иначе берём email администратора или адрес домена.
|
||||
VAPID_SUBJECT="$(oauth_value VAPID_SUBJECT)"
|
||||
if [ -z "$VAPID_SUBJECT" ]; then
|
||||
if [ -n "${ADMIN_EMAIL:-}" ]; then
|
||||
VAPID_SUBJECT="mailto:${ADMIN_EMAIL}"
|
||||
else
|
||||
VAPID_SUBJECT="mailto:admin@${DOMAIN}"
|
||||
fi
|
||||
fi
|
||||
|
||||
# OAuth (Фаза 7) не генерируется: клиентские id/секреты выдаёт провайдер.
|
||||
# Значение берём из окружения, иначе сохраняем прежнее из .env — иначе
|
||||
# `--reconfigure` молча выключил бы вход через провайдеров.
|
||||
@@ -886,6 +923,12 @@ OAUTH_DISCORD_CLIENT_SECRET=@OAUTH_DISCORD_CLIENT_SECRET@
|
||||
# Необязательно: внешний адрес инстанса для redirect_uri (пусто — из домена).
|
||||
OAUTH_REDIRECT_BASE=@OAUTH_REDIRECT_BASE@
|
||||
|
||||
# --- Web Push (Фаза 7) ---
|
||||
# Приватный VAPID-ключ (PKCS#8 DER в base64). Пусто — Web Push выключен.
|
||||
VAPID_PRIVATE_KEY=@VAPID_PRIVATE_KEY@
|
||||
# Контакт администратора для push-сервисов: mailto:… или https://…
|
||||
VAPID_SUBJECT=@VAPID_SUBJECT@
|
||||
|
||||
# --- функции ---
|
||||
REGISTRATION_ENABLED=@REGISTRATION_ENABLED@
|
||||
ANTI_BOT_ENABLED=@ANTI_BOT_ENABLED@
|
||||
@@ -966,6 +1009,10 @@ OAUTH_DISCORD_CLIENT_ID=$(env_quote "$OAUTH_DISCORD_CLIENT_ID")
|
||||
OAUTH_DISCORD_CLIENT_SECRET=$(env_quote "$OAUTH_DISCORD_CLIENT_SECRET")
|
||||
OAUTH_REDIRECT_BASE=$(env_quote "$OAUTH_REDIRECT_BASE")
|
||||
|
||||
# Web Push (Фаза 7): приватный VAPID-ключ переиспользуется при переустановке.
|
||||
VAPID_PRIVATE_KEY=${VAPID_PRIVATE_KEY}
|
||||
VAPID_SUBJECT=$(env_quote "$VAPID_SUBJECT")
|
||||
|
||||
# Offsite-бэкапы: цель и срок хранения задаются вручную после установки.
|
||||
BACKUP_OFFSITE_TARGET=${BACKUP_OFFSITE_TARGET:-}
|
||||
BACKUP_OFFSITE_KEEP_DAYS=${BACKUP_OFFSITE_KEEP_DAYS:-}
|
||||
|
||||
Reference in New Issue
Block a user