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:
1 parent
cd2657b2f8
commit
de65cc088a
4 files changed
+254
-8
No files matched your search
+2
-1
@@ -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. Больше протоколов
|
||||
|
||||
@@ -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`.
|
||||
|
||||
@@ -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
@@ -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 с того же
|
||||
# экрана не считать, а ссылку можно скопировать.
|
||||
|
||||
Reference in new issue
Block a user