Matrix Docker Ansible eploy
25'ten fazla konu seçemezsiniz Konular bir harf veya rakamla başlamalı, kısa çizgiler ('-') içerebilir ve en fazla 35 karakter uzunluğunda olabilir.
 
 
 

741 satır
25 KiB

  1. # SOME DESCRIPTIVE TITLE.
  2. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community
  3. # members
  4. # This file is distributed under the same license as the
  5. # matrix-docker-ansible-deploy package.
  6. # FIRST AUTHOR <EMAIL@ADDRESS>, 2024.
  7. #
  8. #, fuzzy
  9. msgid ""
  10. msgstr ""
  11. "Project-Id-Version: matrix-docker-ansible-deploy \n"
  12. "Report-Msgid-Bugs-To: \n"
  13. "POT-Creation-Date: 2024-12-20 09:53+0200\n"
  14. "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  15. "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  16. "Language: bg\n"
  17. "Language-Team: bg <LL@li.org>\n"
  18. "Plural-Forms: nplurals=2; plural=(n != 1);\n"
  19. "MIME-Version: 1.0\n"
  20. "Content-Type: text/plain; charset=utf-8\n"
  21. "Content-Transfer-Encoding: 8bit\n"
  22. "Generated-By: Babel 2.16.0\n"
  23. #: ../../../docs/configuring-playbook-bot-draupnir.md:1
  24. msgid "Setting up Draupnir (optional)"
  25. msgstr ""
  26. #: ../../../docs/configuring-playbook-bot-draupnir.md:3
  27. msgid ""
  28. "The playbook can install and configure the [Draupnir](https://github.com"
  29. "/the-draupnir-project/Draupnir) moderation bot for you."
  30. msgstr ""
  31. #: ../../../docs/configuring-playbook-bot-draupnir.md:5
  32. msgid ""
  33. "See the project's [documentation](https://github.com/the-draupnir-"
  34. "project/Draupnir/blob/main/README.md) to learn what it does and why it "
  35. "might be useful to you."
  36. msgstr ""
  37. #: ../../../docs/configuring-playbook-bot-draupnir.md:7
  38. msgid ""
  39. "This documentation page is about installing Draupnir in bot mode. As an "
  40. "alternative, you can run a multi-instance Draupnir deployment by "
  41. "installing [Draupnir in appservice mode](./configuring-playbook-"
  42. "appservice-draupnir-for-all.md) (called Draupnir-for-all) instead."
  43. msgstr ""
  44. #: ../../../docs/configuring-playbook-bot-draupnir.md:9
  45. msgid ""
  46. "If your migrating from Mjolnir skip to [this section](#migrating-from-"
  47. "mjolnir-only-required-if-migrating)."
  48. msgstr ""
  49. #: ../../../docs/configuring-playbook-bot-draupnir.md:11
  50. msgid "Prerequisites"
  51. msgstr ""
  52. #: ../../../docs/configuring-playbook-bot-draupnir.md:13
  53. msgid "Register the bot account"
  54. msgstr ""
  55. #: ../../../docs/configuring-playbook-bot-draupnir.md:15
  56. msgid ""
  57. "The playbook does not automatically create users for you. You **need to "
  58. "register the bot user manually** before setting up the bot."
  59. msgstr ""
  60. #: ../../../docs/configuring-playbook-bot-draupnir.md:17
  61. msgid ""
  62. "Choose a strong password for the bot. You can generate a good password "
  63. "with a command like this: `pwgen -s 64 1`."
  64. msgstr ""
  65. #: ../../../docs/configuring-playbook-bot-draupnir.md:19
  66. msgid "You can use the playbook to [register a new user](registering-users.md):"
  67. msgstr ""
  68. #: ../../../docs/configuring-playbook-bot-draupnir.md:25
  69. msgid ""
  70. "If you would like Draupnir to be able to deactivate users, move aliases, "
  71. "shutdown rooms, show abuse reports (see [below](#abuse-reports)), etc "
  72. "then it must be a server admin so you need to change `admin=no` to "
  73. "`admin=yes` in the command above."
  74. msgstr ""
  75. #: ../../../docs/configuring-playbook-bot-draupnir.md:27
  76. msgid "Get an access token"
  77. msgstr ""
  78. #: ../../../docs/configuring-playbook-bot-draupnir.md:29
  79. msgid ""
  80. "The bot requires an access token to be able to connect to your "
  81. "homeserver. Refer to the documentation on [how to obtain an access token"
  82. "](obtaining-access-tokens.md)."
  83. msgstr ""
  84. #: ../../../docs/configuring-playbook-bot-draupnir.md:31
  85. msgid "Make sure the account is free from rate limiting"
  86. msgstr ""
  87. #: ../../../docs/configuring-playbook-bot-draupnir.md:33
  88. msgid ""
  89. "If your homeserver's implementation is Synapse, you will need to prevent "
  90. "it from rate limiting the bot's account. **This is a required step. If "
  91. "you do not configure it, Draupnir will crash.**"
  92. msgstr ""
  93. #: ../../../docs/configuring-playbook-bot-draupnir.md:35
  94. msgid ""
  95. "This can be done using Synapse's [Admin APIs](https://element-"
  96. "hq.github.io/synapse/latest/admin_api/user_admin_api.html#override-"
  97. "ratelimiting-for-users). They can be accessed both externally and "
  98. "internally."
  99. msgstr ""
  100. #: ../../../docs/configuring-playbook-bot-draupnir.md:37
  101. msgid ""
  102. "To expose the APIs publicly, add the following configuration to your "
  103. "`inventory/host_vars/matrix.example.com/vars.yml` file."
  104. msgstr ""
  105. #: ../../../docs/configuring-playbook-bot-draupnir.md:43
  106. msgid ""
  107. "The APIs can also be accessed via [Synapse "
  108. "Admin](https://github.com/etkecc/synapse-admin), a web UI tool you can "
  109. "use to administrate users, rooms, media, etc. on your Matrix server. The "
  110. "playbook can install and configure Synapse Admin for you. For details "
  111. "about it, see [this page](configuring-playbook-synapse-admin.md)."
  112. msgstr ""
  113. #: ../../../docs/configuring-playbook-bot-draupnir.md:45
  114. msgid ""
  115. "**Note**: access to the APIs is restricted with a valid access token, so "
  116. "exposing them publicly should not be a real security concern. Still, "
  117. "doing so is not recommended for additional security. See [official "
  118. "Synapse reverse-proxying recommendations](https://element-"
  119. "hq.github.io/synapse/latest/reverse_proxy.html#synapse-administration-"
  120. "endpoints)."
  121. msgstr ""
  122. #: ../../../docs/configuring-playbook-bot-draupnir.md:47
  123. msgid ""
  124. "To discharge rate limiting, run the following command on systems that "
  125. "ship curl (note that it does not work on outdated Windows 10). Even if "
  126. "the APIs are not exposed to the internet, you should still be able to run"
  127. " the command on the homeserver locally. Before running it, make sure to "
  128. "replace `@bot.draupnir:example.com` with the MXID of your Draupnir:"
  129. msgstr ""
  130. #: ../../../docs/configuring-playbook-bot-draupnir.md:53
  131. msgid ""
  132. "You can obtain an access token for a homeserver admin account in the same"
  133. " way as you can do so for Draupnir itself. If you have made Draupnir an "
  134. "admin, you can just use the Draupnir token."
  135. msgstr ""
  136. #: ../../../docs/configuring-playbook-bot-draupnir.md:55
  137. msgid "Create a management room"
  138. msgstr ""
  139. #: ../../../docs/configuring-playbook-bot-draupnir.md:57
  140. msgid ""
  141. "Using your own account, create a new invite only room that you will use "
  142. "to manage the bot. This is the room where you will see the status of the "
  143. "bot and where you will send commands to the bot, such as the command to "
  144. "ban a user from another room. Anyone in this room can control the bot so "
  145. "it is important that you only invite trusted users to this room."
  146. msgstr ""
  147. #: ../../../docs/configuring-playbook-bot-draupnir.md:59
  148. msgid ""
  149. "If you make the management room encrypted (E2EE), then you MUST enable "
  150. "and use Pantalaimon (see [below](#configuration-with-e2ee-support))."
  151. msgstr ""
  152. #: ../../../docs/configuring-playbook-bot-draupnir.md:61
  153. msgid ""
  154. "Once you have created the room you need to copy the room ID so you can "
  155. "tell the bot to use that room. In Element Web you can do this by going to"
  156. " the room's settings, clicking Advanced, and then copying the internal "
  157. "room ID. The room ID will look something like `!qporfwt:example.com`."
  158. msgstr ""
  159. #: ../../../docs/configuring-playbook-bot-draupnir.md:63
  160. msgid ""
  161. "Finally invite the `@bot.draupnir:example.com` account you created "
  162. "earlier into the room."
  163. msgstr ""
  164. #: ../../../docs/configuring-playbook-bot-draupnir.md:65
  165. msgid "Adjusting the playbook configuration"
  166. msgstr ""
  167. #: ../../../docs/configuring-playbook-bot-draupnir.md:67
  168. msgid ""
  169. "Add the following configuration to your "
  170. "`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
  171. "replace `MANAGEMENT_ROOM_ID_HERE`."
  172. msgstr ""
  173. #: ../../../docs/configuring-playbook-bot-draupnir.md:76
  174. msgid "End-to-End Encryption support"
  175. msgstr ""
  176. #: ../../../docs/configuring-playbook-bot-draupnir.md:78
  177. msgid ""
  178. "Decide whether you want Draupnir to be capable of operating in end-to-end"
  179. " encrypted (E2EE) rooms. This includes the management room and the "
  180. "moderated rooms."
  181. msgstr ""
  182. #: ../../../docs/configuring-playbook-bot-draupnir.md:80
  183. msgid ""
  184. "To support E2EE, Draupnir needs to [use Pantalaimon](configuring-"
  185. "playbook-pantalaimon.md)."
  186. msgstr ""
  187. #: ../../../docs/configuring-playbook-bot-draupnir.md:82
  188. msgid "Configuration with E2EE support"
  189. msgstr ""
  190. #: ../../../docs/configuring-playbook-bot-draupnir.md:84
  191. msgid ""
  192. "When using Pantalaimon, Draupnir will log in to its bot account itself "
  193. "through Pantalaimon, so configure its username and password."
  194. msgstr ""
  195. #: ../../../docs/configuring-playbook-bot-draupnir.md:86
  196. msgid ""
  197. "Add the following configuration to your "
  198. "`inventory/host_vars/matrix.example.com/vars.yml` file (adapt to your "
  199. "needs):"
  200. msgstr ""
  201. #: ../../../docs/configuring-playbook-bot-draupnir.md:100
  202. msgid ""
  203. "The playbook's `group_vars` will configure other required settings. If "
  204. "using this role separately without the playbook, you also need to "
  205. "configure the two URLs that Draupnir uses to reach the homeserver, one "
  206. "through Pantalaimon and one \"raw\". This example is taken from the "
  207. "playbook's `group_vars`:"
  208. msgstr ""
  209. #: ../../../docs/configuring-playbook-bot-draupnir.md:112
  210. msgid "Configuration without E2EE support"
  211. msgstr ""
  212. #: ../../../docs/configuring-playbook-bot-draupnir.md:114
  213. msgid ""
  214. "When NOT using Pantalaimon, Draupnir does not log in by itself and you "
  215. "must give it an access token for its bot account."
  216. msgstr ""
  217. #: ../../../docs/configuring-playbook-bot-draupnir.md:116
  218. msgid ""
  219. "Add the following configuration to your "
  220. "`inventory/host_vars/matrix.example.com/vars.yml` file. Make sure to "
  221. "replace `ACCESS_TOKEN_HERE` with the one created [above](#get-an-access-"
  222. "token)."
  223. msgstr ""
  224. #: ../../../docs/configuring-playbook-bot-draupnir.md:122
  225. msgid "Abuse Reports"
  226. msgstr ""
  227. #: ../../../docs/configuring-playbook-bot-draupnir.md:124
  228. msgid "Draupnir supports two methods to receive reports in the management room."
  229. msgstr ""
  230. #: ../../../docs/configuring-playbook-bot-draupnir.md:126
  231. msgid ""
  232. "The first method intercepts the report API endpoint of the client-server "
  233. "API, which requires integration with the reverse proxy in front of the "
  234. "homeserver. If you are using traefik, this playbook can set this up for "
  235. "you:"
  236. msgstr ""
  237. #: ../../../docs/configuring-playbook-bot-draupnir.md:132
  238. msgid ""
  239. "The other method polls an Synapse Admin API endpoint, hence it is "
  240. "available only if using Synapse and if the Draupnir user is an admin (see"
  241. " [above](#register-the-bot-account)). To enable it, set `pollReports: "
  242. "true` on `vars.yml` file as below."
  243. msgstr ""
  244. #: ../../../docs/configuring-playbook-bot-draupnir.md:134
  245. msgid "Extending the configuration"
  246. msgstr ""
  247. #: ../../../docs/configuring-playbook-bot-draupnir.md:136
  248. msgid ""
  249. "You can configure additional options by adding the "
  250. "`matrix_bot_draupnir_configuration_extension_yaml` variable."
  251. msgstr ""
  252. #: ../../../docs/configuring-playbook-bot-draupnir.md:138
  253. msgid ""
  254. "For example, to change Draupnir's `pollReports` option to `true`, add the"
  255. " following configuration to your "
  256. "`inventory/host_vars/matrix.example.com/vars.yml` file:"
  257. msgstr ""
  258. #: ../../../docs/configuring-playbook-bot-draupnir.md:152
  259. msgid "Migrating from Mjolnir (Only required if migrating)"
  260. msgstr ""
  261. #: ../../../docs/configuring-playbook-bot-draupnir.md:154
  262. msgid ""
  263. "Replace your `matrix_bot_mjolnir` config with `matrix_bot_draupnir` "
  264. "config. Also disable Mjolnir if you're doing migration."
  265. msgstr ""
  266. #: ../../../docs/configuring-playbook-bot-draupnir.md:156
  267. msgid ""
  268. "That is all you need to do due to that Draupnir can complete migration on"
  269. " its own."
  270. msgstr ""
  271. #: ../../../docs/configuring-playbook-bot-draupnir.md:158
  272. msgid "Installing"
  273. msgstr ""
  274. #: ../../../docs/configuring-playbook-bot-draupnir.md:160
  275. msgid ""
  276. "After configuring the playbook, run it with [playbook tags](playbook-"
  277. "tags.md) as below:"
  278. msgstr ""
  279. #: ../../../docs/configuring-playbook-bot-draupnir.md:167
  280. msgid "**Notes**:"
  281. msgstr ""
  282. #: ../../../docs/configuring-playbook-bot-draupnir.md:169
  283. msgid ""
  284. "The `ensure-matrix-users-created` playbook tag makes the playbook "
  285. "automatically create the bot's user account."
  286. msgstr ""
  287. #: ../../../docs/configuring-playbook-bot-draupnir.md:171
  288. msgid ""
  289. "The shortcut commands with the [`just` program](just.md) are also "
  290. "available: `just install-all` or `just setup-all`"
  291. msgstr ""
  292. #: ../../../docs/configuring-playbook-bot-draupnir.md:173
  293. msgid ""
  294. "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
  295. "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
  296. "runtime) than `just setup-all`) when its components remain unchanged. If "
  297. "you adjust your `vars.yml` to remove other components, you'd need to run "
  298. "`just setup-all`, or these components will still remain installed."
  299. msgstr ""
  300. #: ../../../docs/configuring-playbook-bot-draupnir.md:175
  301. msgid ""
  302. "If you change the Pantalaimon's password "
  303. "(`matrix_bot_draupnir_pantalaimon_password` in your `vars.yml` file) "
  304. "subsequently, its credentials on the homeserver won't be updated "
  305. "automatically. If you'd like to change the password, use a tool like "
  306. "[synapse-admin](configuring-playbook-synapse-admin.md) to change it, and "
  307. "then update `matrix_bot_draupnir_pantalaimon_password` to let Pantalaimon"
  308. " know its new password."
  309. msgstr ""
  310. #: ../../../docs/configuring-playbook-bot-draupnir.md:177
  311. msgid "Usage"
  312. msgstr ""
  313. #: ../../../docs/configuring-playbook-bot-draupnir.md:179
  314. msgid ""
  315. "You can refer to the upstream [documentation](https://the-draupnir-"
  316. "project.github.io/draupnir-documentation/) for additional ways to use and"
  317. " configure Draupnir and for a more detailed usage guide."
  318. msgstr ""
  319. #: ../../../docs/configuring-playbook-bot-draupnir.md:181
  320. msgid "Below is a **non-exhaustive quick-start guide** for the impatient."
  321. msgstr ""
  322. #: ../../../docs/configuring-playbook-bot-draupnir.md:183
  323. msgid "Making Draupnir join and protect a room"
  324. msgstr ""
  325. #: ../../../docs/configuring-playbook-bot-draupnir.md:185
  326. msgid ""
  327. "Draupnir can be told to self-join public rooms, but it's better to follow"
  328. " this flow which works well for all kinds of rooms:"
  329. msgstr ""
  330. #: ../../../docs/configuring-playbook-bot-draupnir.md:187
  331. msgid ""
  332. "Invite the bot to the room manually ([inviting Draupnir to rooms](https"
  333. "://the-draupnir-project.github.io/draupnir-documentation/moderator"
  334. "/managing-protected-rooms#inviting-draupnir-to-rooms)). Before joining, "
  335. "the bot *may* ask for confirmation in the Management Room"
  336. msgstr ""
  337. #: ../../../docs/configuring-playbook-bot-draupnir.md:189
  338. msgid ""
  339. "[Give the bot permissions to do its job](#giving-draupnir-permissions-to-"
  340. "do-its-job)"
  341. msgstr ""
  342. #: ../../../docs/configuring-playbook-bot-draupnir.md:191
  343. msgid ""
  344. "Tell it to protect the room (using the [rooms command](https://the-"
  345. "draupnir-project.github.io/draupnir-documentation/moderator/managing-"
  346. "protected-rooms#using-the-draupnir-rooms-command)) by sending the "
  347. "following command to the Management Room: `!draupnir rooms add "
  348. "!qporfwt:example.com`"
  349. msgstr ""
  350. #: ../../../docs/configuring-playbook-bot-draupnir.md:193
  351. msgid ""
  352. "To have Draupnir provide useful room protection, you need do to a bit "
  353. "more work (at least the first time around). You may wish to [Subscribe to"
  354. " a public policy list](#subscribing-to-a-public-policy-list), [Create "
  355. "your own own policy and rules](#creating-your-own-policy-lists-and-rules)"
  356. " and [Enabling built-in protections](#enabling-built-in-protections)."
  357. msgstr ""
  358. #: ../../../docs/configuring-playbook-bot-draupnir.md:195
  359. msgid "Giving Draupnir permissions to do its job"
  360. msgstr ""
  361. #: ../../../docs/configuring-playbook-bot-draupnir.md:197
  362. msgid ""
  363. "For Draupnir to do its job, you need to [give it permissions](https"
  364. "://the-draupnir-project.github.io/draupnir-documentation/moderator"
  365. "/managing-protected-rooms#giving-draupnir-permissions) in rooms it's "
  366. "protecting. This involves **giving it an Administrator power level**."
  367. msgstr ""
  368. #: ../../../docs/configuring-playbook-bot-draupnir.md:199
  369. msgid ""
  370. "**We recommend setting this power level as soon as the bot joins your "
  371. "room** (and before you create new rules), so that it can apply rules as "
  372. "soon as they are available. If the bot is under-privileged, it may fail "
  373. "to apply protections and may not retry for a while (or until your restart"
  374. " it)."
  375. msgstr ""
  376. #: ../../../docs/configuring-playbook-bot-draupnir.md:201
  377. msgid "Subscribing to a public policy list"
  378. msgstr ""
  379. #: ../../../docs/configuring-playbook-bot-draupnir.md:203
  380. msgid ""
  381. "We recommend **subscribing to a public [policy list](https://the-"
  382. "draupnir-project.github.io/draupnir-documentation/concepts/policy-"
  383. "lists)** using the [watch command](https://the-draupnir-project.github.io"
  384. "/draupnir-documentation/moderator/managing-policy-lists#using-draupnirs-"
  385. "watch-command-to-subscribe-to-policy-rooms)."
  386. msgstr ""
  387. #: ../../../docs/configuring-playbook-bot-draupnir.md:205
  388. msgid ""
  389. "Polcy lists are maintained in Matrix rooms. A popular policy list is "
  390. "maintained in the public `#community-moderation-effort-bl:neko.dev` room."
  391. msgstr ""
  392. #: ../../../docs/configuring-playbook-bot-draupnir.md:207
  393. msgid ""
  394. "You can tell Draupnir to subscribe to it by sending the following command"
  395. " to the Management Room: `!draupnir watch #community-moderation-effort-"
  396. "bl:neko.dev`"
  397. msgstr ""
  398. #: ../../../docs/configuring-playbook-bot-draupnir.md:209
  399. msgid "Creating your own policy lists and rules"
  400. msgstr ""
  401. #: ../../../docs/configuring-playbook-bot-draupnir.md:211
  402. msgid ""
  403. "We also recommend **creating your own policy lists** with the [list "
  404. "create](https://the-draupnir-project.github.io/draupnir-"
  405. "documentation/moderator/managing-policy-lists#using-draupnirs-list-"
  406. "create-command-to-create-a-policy-room) command."
  407. msgstr ""
  408. #: ../../../docs/configuring-playbook-bot-draupnir.md:213
  409. msgid ""
  410. "You can do so by sending the following command to the Management Room: "
  411. "`!draupnir list create my-bans my-bans-bl`. This will create a policy "
  412. "list having a name (shortcode) of `my-bans` and stored in a public `#my-"
  413. "bans-bl:example.com` room on your server. As soon as you run this "
  414. "command, the bot will invite you to the policy list room."
  415. msgstr ""
  416. #: ../../../docs/configuring-playbook-bot-draupnir.md:215
  417. msgid ""
  418. "A policy list does nothing by itself, so the next step is **adding some "
  419. "rules to your policy list**. Policies target a so-called `entity` (one "
  420. "of: `user`, `room` or `server`). These entities are mentioned on the "
  421. "[policy lists](https://the-draupnir-project.github.io/draupnir-"
  422. "documentation/concepts/policy-lists) documentation page and in the Matrix"
  423. " Spec [here](https://spec.matrix.org/v1.11/client-server-api/#mban-"
  424. "recommendation)."
  425. msgstr ""
  426. #: ../../../docs/configuring-playbook-bot-draupnir.md:217
  427. msgid ""
  428. "The simplest and most useful entity to target is `user`. Below are a few "
  429. "examples using the [ban command](https://the-draupnir-project.github.io"
  430. "/draupnir-documentation/moderator/managing-users#the-ban-command) and "
  431. "targeting users."
  432. msgstr ""
  433. #: ../../../docs/configuring-playbook-bot-draupnir.md:219
  434. msgid ""
  435. "To create rules, you run commands in the Management Room (**not** in the "
  436. "policy list room)."
  437. msgstr ""
  438. #: ../../../docs/configuring-playbook-bot-draupnir.md:221
  439. msgid ""
  440. "(ban a single user on a given homeserver): `!draupnir ban "
  441. "@charles:example.com my-bans Rude to others`"
  442. msgstr ""
  443. #: ../../../docs/configuring-playbook-bot-draupnir.md:222
  444. msgid ""
  445. "(ban all users on a given homeserver by using a [wildcard](https://the-"
  446. "draupnir-project.github.io/draupnir-documentation/moderator/managing-"
  447. "users#wildcards)): `!draupnir ban @*:example.org my-bans Spam server - "
  448. "all users are fake`"
  449. msgstr ""
  450. #: ../../../docs/configuring-playbook-bot-draupnir.md:224
  451. msgid "As a result of running these commands, you may observe:"
  452. msgstr ""
  453. #: ../../../docs/configuring-playbook-bot-draupnir.md:226
  454. msgid ""
  455. "Draupnir creating `m.policy.rule.user` state events in the `#my-bans-"
  456. "bl:example.com` room on your server"
  457. msgstr ""
  458. #: ../../../docs/configuring-playbook-bot-draupnir.md:227
  459. msgid ""
  460. "applying these rules against all rooms that Draupnir is an Administrator "
  461. "in"
  462. msgstr ""
  463. #: ../../../docs/configuring-playbook-bot-draupnir.md:229
  464. msgid ""
  465. "You can undo bans with the [unban command](https://the-draupnir-"
  466. "project.github.io/draupnir-documentation/moderator/managing-users#the-"
  467. "unban-command)."
  468. msgstr ""
  469. #: ../../../docs/configuring-playbook-bot-draupnir.md:231
  470. msgid "Enabling built-in protections"
  471. msgstr ""
  472. #: ../../../docs/configuring-playbook-bot-draupnir.md:233
  473. msgid ""
  474. "You can also **turn on various built-in [protections](https://the-"
  475. "draupnir-project.github.io/draupnir-documentation/protections)** like "
  476. "`JoinWaveShortCircuit` (\"If X amount of users join in Y time, set the "
  477. "room to invite-only\")."
  478. msgstr ""
  479. #: ../../../docs/configuring-playbook-bot-draupnir.md:235
  480. msgid ""
  481. "To **see which protections are available and which are enabled**, send a "
  482. "`!draupnir protections` command to the Management Room."
  483. msgstr ""
  484. #: ../../../docs/configuring-playbook-bot-draupnir.md:237
  485. msgid ""
  486. "To **see the configuration options for a given protection**, send a "
  487. "`!draupnir config get PROTECTION_NAME` (e.g. `!draupnir config get "
  488. "JoinWaveShortCircuit`)."
  489. msgstr ""
  490. #: ../../../docs/configuring-playbook-bot-draupnir.md:239
  491. msgid ""
  492. "To **set a specific option for a given protection**, send a command like "
  493. "this: `!draupnir config set PROTECTION_NAME.OPTION VALUE` (e.g. "
  494. "`!draupnir config set JoinWaveShortCircuit.timescaleMinutes 30`)."
  495. msgstr ""
  496. #: ../../../docs/configuring-playbook-bot-draupnir.md:241
  497. msgid ""
  498. "To **enable a given protection**, send a command like this: `!draupnir "
  499. "enable PROTECTION_NAME` (e.g. `!draupnir enable JoinWaveShortCircuit`)."
  500. msgstr ""
  501. #: ../../../docs/configuring-playbook-bot-draupnir.md:243
  502. msgid ""
  503. "To **disable a given protection**, send a command like this: `!draupnir "
  504. "disable PROTECTION_NAME` (e.g. `!draupnir disable JoinWaveShortCircuit`)."
  505. msgstr ""
  506. #~ msgid ""
  507. #~ "See the project's [documentation](https://github.com"
  508. #~ "/the-draupnir-project/Draupnir) to learn "
  509. #~ "what it does and why it might "
  510. #~ "be useful to you."
  511. #~ msgstr ""
  512. #~ msgid "If your migrating from Mjolnir skip to step 5b."
  513. #~ msgstr ""
  514. #~ msgid ""
  515. #~ "The playbook does not automatically "
  516. #~ "create users for you. The bot "
  517. #~ "requires an access token to be "
  518. #~ "able to connect to your homeserver."
  519. #~ msgstr ""
  520. #~ msgid ""
  521. #~ "You **need to register the bot "
  522. #~ "user manually** before setting up the"
  523. #~ " bot."
  524. #~ msgstr ""
  525. #~ msgid ""
  526. #~ "If you would like Draupnir to be"
  527. #~ " able to deactivate users, move "
  528. #~ "aliases, shutdown rooms, show abuse "
  529. #~ "reports ([see below](#abuse-reports)), etc "
  530. #~ "then it must be a server admin "
  531. #~ "so you need to change `admin=no` "
  532. #~ "to `admin=yes` in the command above."
  533. #~ msgstr ""
  534. #~ msgid ""
  535. #~ "Refer to the documentation on [how "
  536. #~ "to obtain an access token](obtaining-"
  537. #~ "access-tokens.md)."
  538. #~ msgstr ""
  539. #~ msgid ""
  540. #~ "You will need to prevent Synapse "
  541. #~ "from rate limiting the bot's account."
  542. #~ " This is not an optional step. "
  543. #~ "If you do not do this step "
  544. #~ "Draupnir will crash. This can be "
  545. #~ "done using Synapse's [admin API](https"
  546. #~ "://matrix-"
  547. #~ "org.github.io/synapse/latest/admin_api/user_admin_api.html"
  548. #~ "#override-ratelimiting-for-users). Please "
  549. #~ "ask for help if you are "
  550. #~ "uncomfortable with these steps or run"
  551. #~ " into issues."
  552. #~ msgstr ""
  553. #~ msgid ""
  554. #~ "If your Synapse Admin API is "
  555. #~ "exposed to the internet for some "
  556. #~ "reason like running the Synapse Admin"
  557. #~ " Role [Link](configuring-playbook-synapse-"
  558. #~ "admin.md) or running "
  559. #~ "`matrix_synapse_container_labels_public_client_synapse_admin_api_enabled:"
  560. #~ " true` in your playbook config. If"
  561. #~ " your API is not externally exposed"
  562. #~ " you should still be able to on"
  563. #~ " the local host for your synapse "
  564. #~ "run these commands."
  565. #~ msgstr ""
  566. #~ msgid ""
  567. #~ "The following command works on semi "
  568. #~ "up to date Windows 10 installs and"
  569. #~ " All Windows 11 installations and "
  570. #~ "other systems that ship curl. `curl "
  571. #~ "--header \"Authorization: Bearer <access_token>\""
  572. #~ " -X POST "
  573. #~ "https://matrix.example.com/_synapse/admin/v1/users/@bot.draupnir:example.com/override_ratelimit`"
  574. #~ " Replace `@bot.draupnir:example.com` with the "
  575. #~ "MXID of your Draupnir and example.com"
  576. #~ " with your homeserver domain. You can"
  577. #~ " easily obtain an access token for"
  578. #~ " a homeserver admin account the same"
  579. #~ " way you can obtain an access "
  580. #~ "token for Draupnir itself. If you "
  581. #~ "made Draupnir Admin you can just "
  582. #~ "use the Draupnir token."
  583. #~ msgstr ""
  584. #~ msgid ""
  585. #~ "If you make the management room "
  586. #~ "encrypted (E2EE), then you MUST enable"
  587. #~ " and use Pantalaimon (see below)."
  588. #~ msgstr ""
  589. #~ msgid ""
  590. #~ "Decide whether you want Draupnir to "
  591. #~ "be capable of operating in end-"
  592. #~ "to-end encrypted (E2EE) rooms. This "
  593. #~ "includes the management room and the "
  594. #~ "moderated rooms. To support E2EE, "
  595. #~ "Draupnir needs to [use Pantalaimon"
  596. #~ "](configuring-playbook-pantalaimon.md)."
  597. #~ msgstr ""
  598. #~ msgid "a. Configuration with E2EE support"
  599. #~ msgstr ""
  600. #~ msgid "b. Configuration without E2EE support"
  601. #~ msgstr ""
  602. #~ msgid ""
  603. #~ "You must replace "
  604. #~ "`ACCESS_TOKEN_FROM_STEP_2_GOES_HERE` and "
  605. #~ "`ROOM_ID_FROM_STEP_4_GOES_HERE` with your own "
  606. #~ "values."
  607. #~ msgstr ""
  608. #~ msgid "c. Migrating from Mjolnir (Only required if migrating.)"
  609. #~ msgstr ""
  610. #~ msgid ""
  611. #~ "You can configure additional options by"
  612. #~ " adding the "
  613. #~ "`matrix_bot_draupnir_configuration_extension_yaml` variable "
  614. #~ "to your `inventory/host_vars/matrix.example.com/vars.yml`"
  615. #~ " file."
  616. #~ msgstr ""
  617. #~ msgid ""
  618. #~ "For example to change Draupnir's "
  619. #~ "`recordIgnoredInvites` option to `true` you"
  620. #~ " would add the following to your "
  621. #~ "`vars.yml` file."
  622. #~ msgstr ""
  623. #~ msgid ""
  624. #~ "The other method polls an synapse "
  625. #~ "admin API endpoint and is hence "
  626. #~ "only available when using synapse and"
  627. #~ " when the Draupnir user is an "
  628. #~ "admin user (see step 1). To enable"
  629. #~ " it, set `pollReports: true` in "
  630. #~ "Draupnir's config:"
  631. #~ msgstr ""