diff --git a/ops/audit/6-1-matrix-tg-bridge-design.md b/ops/audit/6-1-matrix-tg-bridge-design.md new file mode 100644 index 0000000..70257ae --- /dev/null +++ b/ops/audit/6-1-matrix-tg-bridge-design.md @@ -0,0 +1,37 @@ +# πŸ“‹ Pre-Audit Task: 6-1 Π˜Π½Ρ‚Π΅Π³Ρ€Π°Ρ†ΠΈΡ моста Matrix ↔ Telegram + +**Бтатус:** πŸ“ **Π—ΠΠŸΠ›ΠΠΠ˜Π ΠžΠ’ΠΠΠž (Backlog)** +**ΠŸΡ€ΠΈΠΎΡ€ΠΈΡ‚Π΅Ρ‚:** Высокий (для отказоустойчивости ΠΊΠ°Π½Π°Π»ΠΎΠ² связи) +**ΠžΡ‚Π²Π΅Ρ‚ΡΡ‚Π²Π΅Π½Π½Ρ‹ΠΉ:** Admin-Buryans (Roman) + +## 1. ЦСль Π·Π°Π΄Π°Ρ‡ΠΈ +ΠžΠ±Π΅ΡΠΏΠ΅Ρ‡ΠΈΡ‚ΡŒ ΠΏΡ€ΠΎΠ·Ρ€Π°Ρ‡Π½ΡƒΡŽ, Π½Π°Π΄Π΅ΠΆΠ½ΡƒΡŽ ΠΈ Π΄Π²ΡƒΡΡ‚ΠΎΡ€ΠΎΠ½Π½ΡŽΡŽ Ρ€Π΅Ρ‚Ρ€Π°Π½ΡΠ»ΡΡ†ΠΈΡŽ сообщСний ΠΌΠ΅ΠΆΠ΄Ρƒ Ρ‡Π°Ρ‚Π°ΠΌΠΈ Telegram ΠΈ ΠΊΠΎΠΌΠ½Π°Ρ‚Π°ΠΌΠΈ Matrix. + +## 2. Выбранная Π°Ρ€Ρ…ΠΈΡ‚Π΅ΠΊΡ‚ΡƒΡ€Π° +ИспользованиС **mautrix-telegram** (Docker) Π½Π° VPS, ΠΏΠΎΠ΄ΠΊΠ»ΡŽΡ‡Π΅Π½Π½ΠΎΠ³ΠΎ ΠΊ Synapse (CT 155) Ρ‡Π΅Ρ€Π΅Π· AppService API. +Π Π΅ΠΆΠΈΠΌ Ρ€Π°Π±ΠΎΡ‚Ρ‹: Double Puppeting (ΠΏΡ€Π΅Π΄ΠΏΠΎΡ‡Ρ‚ΠΈΡ‚Π΅Π»ΡŒΠ½ΠΎ) ΠΈΠ»ΠΈ Relay Mode. + +## 3. ΠŸΡ€Π΅Π΄Π²Π°Ρ€ΠΈΡ‚Π΅Π»ΡŒΠ½Ρ‹Π΅ трСбования +- [ ] Π”Π΅ΠΉΡΡ‚Π²ΡƒΡŽΡ‰ΠΈΠΉ Matrix Synapse (CT 155) с ΠΏΡ€Π°Π²Π°ΠΌΠΈ администратора. +- [ ] Новый Telegram Bot Token (с ΠΎΡ‚ΠΊΠ»ΡŽΡ‡Π΅Π½Π½Ρ‹ΠΌ Privacy Mode). +- [ ] РСзСрвная копия ΠΊΠΎΠ½Ρ„ΠΈΠ³ΡƒΡ€Π°Ρ†ΠΈΠΈ Synapse ΠΏΠ΅Ρ€Π΅Π΄ внСсСниСм ΠΈΠ·ΠΌΠ΅Π½Π΅Π½ΠΈΠΉ. + +## 4. Π­Ρ‚Π°ΠΏΡ‹ Ρ€Π΅Π°Π»ΠΈΠ·Π°Ρ†ΠΈΠΈ +1. Π Π°Π·Π²Π΅Ρ€Ρ‚Ρ‹Π²Π°Π½ΠΈΠ΅ ΠΊΠΎΠ½Ρ‚Π΅ΠΉΠ½Π΅Ρ€Π° `mautrix-telegram` ΠΈ гСнСрация ΠΊΠΎΠ½Ρ„ΠΈΠ³ΠΎΠ². +2. РСгистрация `registration.yaml` Π² `homeserver.yaml` Synapse. +3. Запуск моста ΠΈ аутСнтификация администратора Ρ‡Π΅Ρ€Π΅Π· ΠΊΠΎΠΌΠ°Π½Π΄Ρƒ `login` Π² Telegram. +4. БвязываниС Ρ‡Π°Ρ‚ΠΎΠ² ΠΊΠΎΠΌΠ°Π½Π΄ΠΎΠΉ `bridge` ΠΈ тСстированиС. + +## 5. ΠšΡ€ΠΈΡ‚Π΅Ρ€ΠΈΠΈ ΠΏΡ€ΠΈΠ΅ΠΌΠΊΠΈ +- [ ] Двусторонняя ΠΏΠ΅Ρ€Π΅Π΄Π°Ρ‡Π° тСкста ΠΈ ΠΌΠ΅Π΄ΠΈΠ° Ρ€Π°Π±ΠΎΡ‚Π°Π΅Ρ‚ ΡΡ‚Π°Π±ΠΈΠ»ΡŒΠ½ΠΎ. +- [ ] АвтоматичСский рСстарт ΠΊΠΎΠ½Ρ‚Π΅ΠΉΠ½Π΅Ρ€Π° ΠΏΡ€ΠΈ сбоях. +- [ ] ΠžΡ‚ΡΡƒΡ‚ΡΡ‚Π²ΠΈΠ΅ критичСских ошибок (ERROR) Π² Π»ΠΎΠ³Π°Ρ… моста. + +## 6. Риски ΠΈ ограничСния +- ΠžΠ³Ρ€Π°Π½ΠΈΡ‡Π΅Π½ΠΈΡ API Telegram (rate limiting, Π²ΠΎΠ·ΠΌΠΎΠΆΠ½Ρ‹Π΅ Π±Π»ΠΎΠΊΠΈΡ€ΠΎΠ²ΠΊΠΈ Π±ΠΎΡ‚Π°). +- Π‘Π»ΠΎΠΆΠ½ΠΎΡΡ‚ΡŒ настройки E2EE (Π½Π° ΠΏΠ΅Ρ€Π²ΠΎΠΌ этапС ΠΈΡΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚ΡŒ Π½Π΅Π·Π°ΡˆΠΈΡ„Ρ€ΠΎΠ²Π°Π½Π½Ρ‹Π΅ ΠΊΠΎΠΌΠ½Π°Ρ‚Ρ‹). + +## 7. Π‘Π»Π΅Π΄ΡƒΡŽΡ‰ΠΈΠ΅ шаги ΠΏΠ΅Ρ€Π΅Π΄ спринтом +1. Аудит настроСк Synapse Π½Π° ΡΠΎΠ²ΠΌΠ΅ΡΡ‚ΠΈΠΌΠΎΡΡ‚ΡŒ с AppServices. +2. Π‘ΠΎΠ·Π΄Π°Π½ΠΈΠ΅ Π½ΠΎΠ²ΠΎΠ³ΠΎ Π±ΠΎΡ‚Π° Π² @BotFather. +3. Π’ΠΊΠ»ΡŽΡ‡Π΅Π½ΠΈΠ΅ Π·Π°Π΄Π°Ρ‡ΠΈ Π² ΠΏΠ»Π°Π½ΠΈΡ€ΠΎΠ²Π°Π½ΠΈΠ΅ ΡΠ»Π΅Π΄ΡƒΡŽΡ‰Π΅Π³ΠΎ спринта.