From de65cc088afe1a92606fc0d03edbaed2b7578700 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Fri, 16 Oct 2026 20:59:11 +0300 Subject: [PATCH] =?UTF-8?q?VPN:=20=D0=B2=D1=8B=D0=B4=D0=B0=D1=87=D0=B0=20?= =?UTF-8?q?=D0=B4=D0=BE=D1=81=D1=82=D1=83=D0=BF=D0=B0=20=D0=BD=D0=BE=D0=B2?= =?UTF-8?q?=D0=BE=D0=BC=D1=83=20=D1=87=D0=B5=D0=BB=D0=BE=D0=B2=D0=B5=D0=BA?= =?UTF-8?q?=D1=83=20=D0=BE=D0=B4=D0=BD=D0=BE=D0=B9=20=D0=BA=D0=BE=D0=BC?= =?UTF-8?q?=D0=B0=D0=BD=D0=B4=D0=BE=D0=B9=20=D0=B0=D0=B4=D0=BC=D0=B8=D0=BD?= =?UTF-8?q?=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Владельцу нужна была одна команда, чтобы выдать профиль новому участнику без ручной сборки QR и без пересылки ключей в мессенджерах. Добавлено: !vpn give @логин — выдать свободный ключ !vpn give @логин 08 — выдать конкретный ключ !vpn list — что выдано, что свободно Доступно только владельцу (@akadmin, @comms_agent); обычному человеку бот отвечает отказом и пишет попытку в журнал. Профиль уходит ЛИЧНО получателю: бот заводит с ним личную комнату, приглашает и отправляет QR и ссылку. Владельцу приходит подтверждение, что и кому выдано, и это же пишется в состояние (given_by, key). Два вывода, которые дала проверка на живом получателе: 1. Видимость истории. Первый прогон создал комнату с history_visibility "joined". Бот отчитался "отправлено", но получатель — а он в тот момент ещё только приглашён — не увидел НИЧЕГО: с этой видимостью видны только сообщения после вступления. Исправлено на "shared", проверено на новой комнате: приглашённый видит профиль сразу. Это выяснилось проверкой, а не из документации. 2. Права бота. Бот не серверный админ: заводить и деактивировать учётные записи в Matrix он не может (403). Поэтому !vpn give создаёт только комнату, а учётную запись человеку заводит владелец. Записано в документации, чтобы это не выглядело недоделкой. Проверено по-настоящему: временный человек заводился в Matrix, получал ключ Buryan-10, принимал приглашение и видел у себя картинку QR и ссылку. Обычному человеку на "!vpn 04" приходит отказ. Уборка после проверки: временные люди и их комнаты удалены из базы (пользователей снова 21, событий временных комнат 0). Комнаты чистились с обнулением зависимостей — event_edges держал события круговой ссылкой. --- docs/TASKS.md | 3 +- docs/vpn-clients.md | 53 +++++++++ ops/vpn/VPN-STAGE1-IMPLEMENTATION.md | 46 ++++++++ ops/vpn/matrix-vpn-bot.py | 160 +++++++++++++++++++++++++-- 4 files changed, 254 insertions(+), 8 deletions(-) diff --git a/docs/TASKS.md b/docs/TASKS.md index d37939f..acd53f0 100644 --- a/docs/TASKS.md +++ b/docs/TASKS.md @@ -82,7 +82,8 @@ | 1.1 | Удобный профиль для телефонов (ключей 10, QR на каждого) | ✅ | | 1.2 | Инструкция для семьи (`docs/VPN-FOR-FAMILY.md`) | ✅ | | 1.3 | **Проверить на телефонах Сергея и AlexTest** | 🔶 ждёт устройств | -| 1.4 | Раздать остальным | ⬜ после 1.3 | +| 1.4 | Раздать остальным | ✅ выдано всем шестерым | +| 1.6 | Выдача доступа новому человеку одной командой админа | ✅ `!vpn give @логин` | | 1.5 | Разместить ссылки в Vaultwarden | ⬜ | ### Этап 2. Больше протоколов diff --git a/docs/vpn-clients.md b/docs/vpn-clients.md index 57e9d4c..62470c1 100644 --- a/docs/vpn-clients.md +++ b/docs/vpn-clients.md @@ -249,6 +249,59 @@ eval "$FUNC"; check_vpn; echo "код: $?" Ожидаемый результат: `код: 0` и `PASSED` увеличился на единицу. +## 5г. Выдача доступа новому человеку + +**Зачем.** Владельцу нужна одна команда, чтобы выдать профиль новому +участнику — без ручной сборки QR и без пересылки ключей в мессенджерах. + +``` +!vpn give @логин — выдать свободный ключ +!vpn give @логин 08 — выдать конкретный ключ +!vpn list — что кому выдано и какие ключи свободны +``` + +Доступна **только владельцу** (`@akadmin`, `@comms_agent`). Обычному +человеку бот ответит отказом и запишет попытку в журнал. + +**Как это работает.** Бот заводит личную комнату с получателем, +приглашает его и отправляет профиль **лично ему**, а не в комнату, где +сидит владелец: ключ — это доступ, в переписке с третьими лицами ему +не место. Владельцу бот отвечает, что и кому выдано, и это же +записывается в состояние (`given_by`, `key`). + +**Что человек должен уже иметь.** Учётную запись в матрице — +бот заводит только комнату. Учётные записи создаёт владелец через +админский доступ Synapse: у самого бота прав серверного админа нет. + +### Важная тонкость: видимость истории + +Личные комнаты создаются с `history_visibility: shared`, а не `joined`. +Причина: при выдаче доступа человек в комнате ещё только **приглашён**. +С видимостью `joined` он увидел бы только то, что отправлено после его +вступления, — то есть приглашение с профилем внутри оказалось бы для +него пустым. С `shared` приглашённый видит, что ему прислали, **сразу**. + +Это выяснилось проверкой, а не из документации: первый прогон создал +комнату с `joined`, и получатель не увидел ничего, хотя бот отчитался +об успешной отправке. + +### Свободные ключи + +``` +Buryan-08, Buryan-09, Buryan-10 — свободны +Buryan-01..07 — выданы семье +``` + +Свободных не осталось — нужен новый: добавить клиента в конфигурацию +xray (раздел 6) и внести в `profiles.json` со своим QR. + +### Проверка + +Выдача проверена по-настоящему, на живом получателе: временный человек +заводился в Matrix, получал ключ, принимал приглашение и видел у себя +QR-код и ссылку. После проверки временный человек и его комнаты удалены +из базы (пользователей снова 21, событий временных комнат — 0). + ## 6. Как выдать доступ новому человеку 1. Взять свободный ключ из `/root/.buryan-vpn-final`. diff --git a/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md b/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md index 18d91a9..4b3cf36 100644 --- a/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md +++ b/ops/vpn/VPN-STAGE1-IMPLEMENTATION.md @@ -249,3 +249,49 @@ Synapse ответил `M_LIMIT_EXCEEDED`. Двое получили комна * Не отвечает профилем в комнату — только личным сообщением. * Не слушает «Семью» и тревоги. * Не отдаёт чужой профиль никому, кроме двух админов. + +## 11. Выдача доступа новому человеку (добавлено 17.10.2026) + +Команда владельца: + +``` +!vpn give @логин — выдать свободный ключ +!vpn give @логин 08 — выдать конкретный ключ +!vpn list — что выдано, что свободно +``` + +Профиль уходит **лично получателю** (бот заводит с ним личную комнату), +владельцу приходит подтверждение, выдача записывается в состояние. + +### Что выяснила проверка + +**1. Видимость истории.** Первый прогон создал личную комнату +с `history_visibility: joined`. Бот отчитался «отправлено», но +получатель — а он в тот момент ещё только приглашён — не увидел +ничего: с этой видимостью видны лишь сообщения после вступления. +Исправлено на `shared`, проверено на новой комнате: приглашённый +видит профиль сразу. + +**2. Права бота.** Бот не серверный админ: создавать учётные записи +в Matrix и деактивировать их он не может (403 `You are not a server +admin`). Поэтому `!vpn give` заводит только комнату, а учётную запись +человеку создаёт владелец. Это записано в документации, чтобы не +выглядело недоделкой. + +**3. Уборка за проверкой.** Временный человек заводился через ключ +регистрации Synapse (лежит **внутри CT 155**, а не на хосте PVE — +на этом я споткнулся). После проверки временные люди и их комнаты +удалены: пользователей снова 21, событий временных комнат 0. +Комнаты чистились с обнулением зависимостей (`event_edges` держал +события круговой ссылкой). + +### Итог проверки + +| Проверка | Результат | +|---|---| +| Бот завёл личную комнату и пригласил | ✅ | +| Получатель видит профиль при приглашении | ✅ (`shared`) | +| До получателя дошли картинка QR и ссылка | ✅ | +| Выдача записана: кто, кому, какой ключ | ✅ | +| Обычному человеку — отказ | ✅ | +| Уборка после проверки | ✅ 0 временных | diff --git a/ops/vpn/matrix-vpn-bot.py b/ops/vpn/matrix-vpn-bot.py index 4f4203e..32cb62f 100644 --- a/ops/vpn/matrix-vpn-bot.py +++ b/ops/vpn/matrix-vpn-bot.py @@ -151,11 +151,18 @@ def send_image(room, mxc, name, size, caption): "info": {"mimetype": "image/png", "size": size, "w": 732, "h": 732}}) -def direct_room(user_id): +def direct_room(user_id, history="shared"): """Личная комната с человеком. Заводится один раз и запоминается. - Хранится в ОТДЕЛЬНОМ файле: токен синхронизации переписывается на каждом - круге, и если держать личные комнаты в том же файле, они затираются. + История — «shared», а не «joined», и это важно. При выдаче доступа + человек в комнате ещё только ПРИГЛАШЁН. С видимостью «joined» он + увидел бы только то, что отправлено после его вступления, — то есть + приглашение с профилем внутри оказалось бы для него пустым. + С «shared» приглашённый видит, что ему прислали, сразу. + + Хранится в ОТДЕЛЬНОМ файле: токен синхронизации переписывается на + каждом круге, и если держать личные комнаты в том же файле, они + затираются. """ store = load_json(DIRECT_FILE, {}) dm = store.get(user_id) @@ -178,7 +185,7 @@ def direct_room(user_id): {"type": "m.room.guest_access", "state_key": "", "content": {"guest_access": "forbidden"}}, {"type": "m.room.history_visibility", "state_key": "", - "content": {"history_visibility": "joined"}}, + "content": {"history_visibility": history}}, ], }) room = res["room_id"] @@ -201,7 +208,12 @@ def deliver(user_id, key_name, where, link_only=False): # link_only: только строка-ссылка. Нужно, когда человек настраивает # телефон, держа его же в руках: QR с того же экрана не считать, # а ссылку из сообщения можно просто скопировать. - if not link_only and os.path.exists(qr): + if link_only: + send_text(room, "Профиль %s — строка для вставки в приложение " + "(«Импорт из ссылки»):\n%s" % (key_name, prof["link"])) + return "только ссылка в личную комнату %s" % room + + if os.path.exists(qr): mxc = upload_image(qr) send_image(room, mxc, os.path.basename(qr), os.path.getsize(qr), "Профиль VPN — %s" % key_name) @@ -227,9 +239,14 @@ def help_text(): " !vpn — прислать ваш профиль личным сообщением (с QR-кодом)\n" " !vpn link — прислать только строку-ссылку, без картинки:\n" " удобно, когда настраиваете телефон на нём же\n" + " !vpn list — что выдано и какие ключи свободны\n" " !vpn help — эта подсказка\n" - "Для владельца: !vpn <ключ> — прислать указанный ключ " - "(например, Buryan-08)") + "Для владельца:\n" + " !vpn <ключ> — прислать себе указанный ключ\n" + " !vpn give @логин — выдать новому человеку свободный ключ\n" + " !vpn give @логин 08 — выдать конкретный ключ\n" + "Профиль при выдаче уходит личным сообщением самому человеку: " + "ключ — это доступ, в общей комнате его показывать нельзя.") def normalise_key(arg): @@ -240,6 +257,123 @@ def normalise_key(arg): return None +def full_user_id(name): + """Приводит «sergey», «@sergey», «@sergey:matrix.buryans.ru» к полному виду.""" + name = name.strip() + if not name.startswith("@"): + name = "@" + name + if ":" not in name: + name += ":" + SERVER_NAME + return name + + +def assigned_keys(): + """Что уже кому выдано — по состоянию раздачи и по личным комнатам.""" + state = load_json(STATE_FILE, {}) + used = {} + for localpart, info in state.items(): + if info.get("key"): + used[info["key"]] = localpart + return used + + +def all_keys(): + return sorted(profiles().keys()) + + +def free_keys(): + used = assigned_keys() + return [k for k in all_keys() if k not in used] + + +def user_exists(user_id): + """Есть ли такой человек в Matrix. Проверяем через профиль.""" + try: + api("GET", "/_matrix/client/v3/profile/" + urllib.parse.quote(user_id)) + return True + except RuntimeError as e: + # 404 — нет такого; прочие ошибки не считаем отсутствием + return "404" not in str(e) + + +def handle_give(room_id, sender, args): + """Владелец выдаёт профиль другому человеку. + + Профиль уходит ЛИЧНО получателю, а не в комнату, где сидит владелец: + ключ — это доступ, и он не должен оказаться в переписке, куда потом + добавят третьего. + """ + if len(args) < 1: + send_text(room_id, "Как выдать доступ:\n" + " !vpn give @логин — выдать свободный ключ\n" + " !vpn give @логин 08 — выдать конкретный ключ\n" + " !vpn list — что выдано, что свободно") + return "give: нет получателя" + + target = full_user_id(args[0]) + if target == sender: + send_text(room_id, "Это ваш собственный логин. Свой профиль — просто «!vpn».") + return "give: получатель — сам владелец" + + if not user_exists(target): + send_text(room_id, "В Matrix нет человека %s. Проверьте логин " + "(например, @sergey)." % target) + return "give: нет такого человека %s" % target + + if len(args) >= 2: + key_name = normalise_key(args[1]) or args[1] + if key_name not in all_keys(): + send_text(room_id, "Ключа %s нет. Свободны: %s" + % (key_name, ", ".join(free_keys()) or "нет")) + return "give: нет ключа %s" % key_name + owner = assigned_keys().get(key_name) + if owner and owner != target.split(":")[0].lstrip("@"): + send_text(room_id, "Ключ %s уже выдан (%s). Если нужно передать " + "его другому — сначала отзовите у прежнего." + % (key_name, owner)) + return "give: ключ %s занят (%s)" % (key_name, owner) + else: + free = free_keys() + if not free: + send_text(room_id, "Свободных ключей не осталось. Нужен новый — " + "добавлю в конфигурацию и выдам.") + return "give: свободных ключей нет" + key_name = free[0] + + note = deliver(target, key_name, room_id) + localpart = target.split(":")[0].lstrip("@") + + # запоминаем, кому что выдали — чтобы это было видно команде !vpn list + state = load_json(STATE_FILE, {}) + entry = state.setdefault(localpart, {}) + entry["key"] = key_name + if "room" not in entry: + entry["room"] = direct_room(target) + entry["given_by"] = sender + entry["delivered"] = True + save_json(STATE_FILE, state) + + send_text(room_id, "Выдал %s профиль %s — ушёл ему личным сообщением.\n" + "Отозвать: убрать ключ %s из конфигурации xray." + % (target, key_name, key_name)) + log("ВЫДАЧА: %s выдал %s человеку %s" % (sender, key_name, target)) + return "выдал %s человеку %s: %s" % (key_name, target, note) + + +def handle_list(room_id): + """Что выдано и что свободно.""" + used = assigned_keys() + lines = ["Ключи VPN:", ""] + for k in all_keys(): + who = used.get(k) + lines.append(" %-10s %s" % (k, ("выдан: " + who) if who else "свободен")) + free = free_keys() + lines.append("") + lines.append("Свободно: %s" % (", ".join(free) if free else "нет")) + send_text(room_id, "\n".join(lines)) + return "список ключей" + + def handle(room_id, sender, body, room_key): """Обрабатывает одну команду. room_key — какой ключ закреплён за комнатой.""" text = body.strip() @@ -257,6 +391,18 @@ def handle(room_id, sender, body, room_key): send_text(room_id, help_text()) return "подсказка" + # Выдача доступа новому человеку — только владелец. + if arg.lower() in ("give", "выдать", "выдай"): + if not is_admin: + send_text(room_id, "Выдавать доступ может только владелец.") + log("ОТКАЗ: %s пытался выдать доступ" % sender) + return "отказ: выдача не админу" + return handle_give(room_id, sender, parts[2:]) + + # Что выдано и что свободно — смотреть можно всем (доступы не раскрываются). + if arg.lower() in ("list", "список"): + return handle_list(room_id) + # «!vpn link» — только строка-ссылка, без картинки. # Удобно, когда настраиваешь телефон, держа его в руках: QR с того же # экрана не считать, а ссылку можно скопировать.