VPN: выдача доступа новому человеку одной командой админа

Владельцу нужна была одна команда, чтобы выдать профиль новому
участнику без ручной сборки 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 держал события круговой ссылкой.
This commit is contained in:
root committed 2026-10-16 20:59:11 +03:00
1 parent cd2657b2f8
commit de65cc088a
4 files changed
+254 -8

No files matched your search

+2 -1
View File
@@ -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. Больше протоколов
+53
View File
@@ -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`.
+46
View File
@@ -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 временных |
+153 -7
View File
@@ -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 с того же
# экрана не считать, а ссылку можно скопировать.