Matrix Docker Ansible eploy
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 

336 lines
12 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-16 12:05+0900\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-ma1sd.md:1
  24. msgid "Setting up ma1sd Identity Server (optional)"
  25. msgstr ""
  26. #: ../../../docs/configuring-playbook-ma1sd.md:3
  27. msgid ""
  28. "**⚠️Note**: ma1sd itself has also been unmaintained for years (the latest"
  29. " commit and release being from 2021). The role of identity servers in the"
  30. " Matrix specification also has an uncertain future. **We recommend not "
  31. "bothering with installing it unless it's the only way you can do what you"
  32. " need to do**. For example, certain things like LDAP integration can also"
  33. " be implemented via [the LDAP provider module for Synapse](./configuring-"
  34. "playbook-ldap-auth.md)."
  35. msgstr ""
  36. #: ../../../docs/configuring-playbook-ma1sd.md:5
  37. msgid ""
  38. "The playbook can configure the [ma1sd](https://github.com/ma1uta/ma1sd) "
  39. "Identity Server for you. It is a fork of [mxisd](https://github.com"
  40. "/kamax-io/mxisd) which was pronounced end of life 2019-06-21."
  41. msgstr ""
  42. #: ../../../docs/configuring-playbook-ma1sd.md:7
  43. msgid ""
  44. "ma1sd is used for 3PIDs (3rd party identifiers like E-mail and phone "
  45. "numbers) and some [enhanced "
  46. "features](https://github.com/ma1uta/ma1sd/#features). It is private by "
  47. "default, potentially at the expense of user discoverability."
  48. msgstr ""
  49. #: ../../../docs/configuring-playbook-ma1sd.md:9
  50. msgid ""
  51. "See the project's [documentation](https://github.com/ma1uta/ma1sd) to "
  52. "learn what it does and why it might be useful to you."
  53. msgstr ""
  54. #: ../../../docs/configuring-playbook-ma1sd.md:11
  55. msgid ""
  56. "**Note**: enabling ma1sd, means that the `openid` API endpoints will be "
  57. "exposed on the Matrix Federation port (usually `8448`), even if "
  58. "[federation](configuring-playbook-federation.md) is disabled. It's "
  59. "something to be aware of, especially in terms of firewall whitelisting "
  60. "(make sure port `8448` is accessible)."
  61. msgstr ""
  62. #: ../../../docs/configuring-playbook-ma1sd.md:13
  63. msgid "Adjusting DNS records"
  64. msgstr ""
  65. #: ../../../docs/configuring-playbook-ma1sd.md:15
  66. msgid ""
  67. "To make the ma1sd Identity Server enable its federation features, set up "
  68. "a SRV record that looks like this:"
  69. msgstr ""
  70. #: ../../../docs/configuring-playbook-ma1sd.md:17
  71. msgid "Name: `_matrix-identity._tcp` (use this text as-is)"
  72. msgstr ""
  73. #: ../../../docs/configuring-playbook-ma1sd.md:18
  74. msgid ""
  75. "Content: `10 0 443 matrix.example.com` (replace `example.com` with your "
  76. "own)"
  77. msgstr ""
  78. #: ../../../docs/configuring-playbook-ma1sd.md:20
  79. msgid ""
  80. "See [ma1sd's documentation](https://github.com/ma1uta/ma1sd/wiki/mxisd-"
  81. "and-your-privacy#choices-are-never-easy) for information on the privacy "
  82. "implications of setting up this SRV record."
  83. msgstr ""
  84. #: ../../../docs/configuring-playbook-ma1sd.md:22
  85. msgid ""
  86. "**Note**: This `_matrix-identity._tcp` SRV record for the identity server"
  87. " is different from the `_matrix._tcp` that can be used for Synapse "
  88. "delegation. See [howto-server-delegation.md](howto-server-delegation.md) "
  89. "for more information about delegation."
  90. msgstr ""
  91. #: ../../../docs/configuring-playbook-ma1sd.md:24
  92. msgid "Adjusting the playbook configuration"
  93. msgstr ""
  94. #: ../../../docs/configuring-playbook-ma1sd.md:26
  95. msgid ""
  96. "To enable ma1sd, add the following configuration to your "
  97. "`inventory/host_vars/matrix.example.com/vars.yml` file:"
  98. msgstr ""
  99. #: ../../../docs/configuring-playbook-ma1sd.md:32
  100. msgid "Matrix.org lookup forwarding"
  101. msgstr ""
  102. #: ../../../docs/configuring-playbook-ma1sd.md:34
  103. msgid ""
  104. "To ensure maximum discovery, you can make your identity server also "
  105. "forward lookups to the central matrix.org Identity server (at the cost of"
  106. " potentially leaking all your contacts information)."
  107. msgstr ""
  108. #: ../../../docs/configuring-playbook-ma1sd.md:36
  109. msgid ""
  110. "Enabling this is discouraged and you'd better [learn "
  111. "more](https://github.com/ma1uta/ma1sd/blob/master/docs/features/identity.md#lookups)"
  112. " before proceeding."
  113. msgstr ""
  114. #: ../../../docs/configuring-playbook-ma1sd.md:38
  115. msgid ""
  116. "To enable matrix.org forwarding, add the following configuration to your "
  117. "`inventory/host_vars/matrix.example.com/vars.yml` file:"
  118. msgstr ""
  119. #: ../../../docs/configuring-playbook-ma1sd.md:44
  120. msgid "Additional features"
  121. msgstr ""
  122. #: ../../../docs/configuring-playbook-ma1sd.md:46
  123. msgid ""
  124. "What this playbook configures for your is some bare minimum Identity "
  125. "Server functionality, so that you won't need to rely on external 3rd "
  126. "party services."
  127. msgstr ""
  128. #: ../../../docs/configuring-playbook-ma1sd.md:48
  129. msgid ""
  130. "A few variables can be toggled in this playbook to alter the ma1sd "
  131. "configuration that gets generated."
  132. msgstr ""
  133. #: ../../../docs/configuring-playbook-ma1sd.md:50
  134. msgid ""
  135. "Still, ma1sd can do much more. You can refer to the [ma1sd "
  136. "website](https://github.com/ma1uta/ma1sd) for more details and "
  137. "configuration options."
  138. msgstr ""
  139. #: ../../../docs/configuring-playbook-ma1sd.md:52
  140. msgid ""
  141. "To use a more custom configuration, you can define a "
  142. "`matrix_ma1sd_configuration_extension_yaml` string variable and put your "
  143. "configuration in it. To learn more about how to do this, refer to the "
  144. "information about `matrix_ma1sd_configuration_extension_yaml` in the "
  145. "[default variables file](../roles/custom/matrix-ma1sd/defaults/main.yml) "
  146. "of the ma1sd component."
  147. msgstr ""
  148. #: ../../../docs/configuring-playbook-ma1sd.md:54
  149. msgid "Customizing email templates"
  150. msgstr ""
  151. #: ../../../docs/configuring-playbook-ma1sd.md:56
  152. msgid ""
  153. "If you'd like to change the default email templates used by ma1sd, take a"
  154. " look at the `matrix_ma1sd_threepid_medium_email_custom_` variables (in "
  155. "the `roles/custom/matrix-ma1sd/defaults/main.yml` file."
  156. msgstr ""
  157. #: ../../../docs/configuring-playbook-ma1sd.md:58
  158. msgid "ma1sd-controlled Registration"
  159. msgstr ""
  160. #: ../../../docs/configuring-playbook-ma1sd.md:60
  161. msgid ""
  162. "To use the "
  163. "[Registration](https://github.com/ma1uta/ma1sd/blob/master/docs/features/registration.md)"
  164. " feature of ma1sd, you can make use of the following variables:"
  165. msgstr ""
  166. #: ../../../docs/configuring-playbook-ma1sd.md:62
  167. msgid ""
  168. "`matrix_synapse_enable_registration` - to enable user-initiated "
  169. "registration in Synapse"
  170. msgstr ""
  171. #: ../../../docs/configuring-playbook-ma1sd.md:64
  172. msgid ""
  173. "`matrix_synapse_enable_registration_captcha` - to validate registering "
  174. "users using reCAPTCHA, as described in the [enabling reCAPTCHA"
  175. "](configuring-captcha.md) documentation."
  176. msgstr ""
  177. #: ../../../docs/configuring-playbook-ma1sd.md:66
  178. msgid ""
  179. "`matrix_synapse_registrations_require_3pid` - a list of 3pid types (among"
  180. " `'email'`, `'msisdn'`) required by the Synapse server for registering"
  181. msgstr ""
  182. #: ../../../docs/configuring-playbook-ma1sd.md:68
  183. msgid ""
  184. "variables prefixed with `matrix_ma1sd_container_labels_` (e.g. "
  185. "`matrix_ma1sd_container_labels_matrix_client_3pid_registration_enabled`) "
  186. "- to configure the Traefik reverse-proxy to capture and send registration"
  187. " requests to ma1sd (instead of Synapse), so it can apply its additional "
  188. "functionality"
  189. msgstr ""
  190. #: ../../../docs/configuring-playbook-ma1sd.md:70
  191. msgid ""
  192. "`matrix_ma1sd_configuration_extension_yaml` - to configure ma1sd as "
  193. "required. See the [Registration feature's "
  194. "docs](https://github.com/ma1uta/ma1sd/blob/master/docs/features/registration.md)"
  195. " for inspiration. Also see the [Additional features](#additional-"
  196. "features) section below to learn more about how to use "
  197. "`matrix_ma1sd_configuration_extension_yaml`."
  198. msgstr ""
  199. #: ../../../docs/configuring-playbook-ma1sd.md:72
  200. msgid ""
  201. "**Note**: For this to work, either the homeserver needs to [federate"
  202. "](configuring-playbook-federation.md) or the `openid` APIs need to "
  203. "exposed on the federation port. When federation is disabled and ma1sd is "
  204. "enabled, we automatically expose the `openid` APIs (only!) on the "
  205. "federation port. Make sure the federation port (usually "
  206. "`https://matrix.example.com:8448`) is whitelisted in your firewall (even "
  207. "if you don't actually use/need federation)."
  208. msgstr ""
  209. #: ../../../docs/configuring-playbook-ma1sd.md:74
  210. msgid "Authentication"
  211. msgstr ""
  212. #: ../../../docs/configuring-playbook-ma1sd.md:76
  213. msgid ""
  214. "[Authentication](https://github.com/ma1uta/ma1sd/blob/master/docs/features/authentication.md)"
  215. " provides the possibility to use your own [Identity "
  216. "Stores](https://github.com/ma1uta/ma1sd/blob/master/docs/stores/README.md)"
  217. " (for example LDAP) to authenticate users on your Homeserver."
  218. msgstr ""
  219. #: ../../../docs/configuring-playbook-ma1sd.md:78
  220. msgid ""
  221. "To enable authentication against an LDAP server, add the following "
  222. "configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "
  223. "file:"
  224. msgstr ""
  225. #: ../../../docs/configuring-playbook-ma1sd.md:98
  226. msgid "Example: SMS verification"
  227. msgstr ""
  228. #: ../../../docs/configuring-playbook-ma1sd.md:100
  229. msgid ""
  230. "If your use case requires mobile verification, it is quite simple to "
  231. "integrate ma1sd with [Twilio](https://www.twilio.com/), an online "
  232. "telephony services gateway. Their prices are reasonable for low-volume "
  233. "projects and integration can be done with the following configuration:"
  234. msgstr ""
  235. #: ../../../docs/configuring-playbook-ma1sd.md:114
  236. msgid "Example: Open Registration for every Domain"
  237. msgstr ""
  238. #: ../../../docs/configuring-playbook-ma1sd.md:116
  239. msgid ""
  240. "If you want to open registration for any domain, you have to setup the "
  241. "allowed domains with ma1sd's `blacklist` and `whitelist`. The default "
  242. "behavior when neither the `blacklist`, nor the `whitelist` match, is to "
  243. "allow registration. Beware: you can't block toplevel domains (aka `.xy`) "
  244. "because the internal architecture of ma1sd doesn't allow that."
  245. msgstr ""
  246. #: ../../../docs/configuring-playbook-ma1sd.md:130
  247. msgid "Installing"
  248. msgstr ""
  249. #: ../../../docs/configuring-playbook-ma1sd.md:132
  250. msgid ""
  251. "After configuring the playbook, run it with [playbook tags](playbook-"
  252. "tags.md) as below:"
  253. msgstr ""
  254. #: ../../../docs/configuring-playbook-ma1sd.md:139
  255. msgid ""
  256. "The shortcut commands with the [`just` program](just.md) are also "
  257. "available: `just install-all` or `just setup-all`"
  258. msgstr ""
  259. #: ../../../docs/configuring-playbook-ma1sd.md:141
  260. msgid ""
  261. "`just install-all` is useful for maintaining your setup quickly ([2x-5x "
  262. "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"
  263. "runtime) than `just setup-all`) when its components remain unchanged. If "
  264. "you adjust your `vars.yml` to remove other components, you'd need to run "
  265. "`just setup-all`, or these components will still remain installed. Note "
  266. "these shortcuts run the `ensure-matrix-users-created` tag too."
  267. msgstr ""
  268. #: ../../../docs/configuring-playbook-ma1sd.md:143
  269. msgid "Troubleshooting"
  270. msgstr ""
  271. #: ../../../docs/configuring-playbook-ma1sd.md:145
  272. msgid ""
  273. "If email address validation emails sent by ma1sd are not reaching you, "
  274. "you should look into [Adjusting email-sending settings](configuring-"
  275. "playbook-email.md)."
  276. msgstr ""
  277. #: ../../../docs/configuring-playbook-ma1sd.md:147
  278. msgid ""
  279. "If you'd like additional logging information, temporarily enable verbose "
  280. "logging for ma1sd."
  281. msgstr ""
  282. #: ../../../docs/configuring-playbook-ma1sd.md:149
  283. msgid ""
  284. "To enable it, add the following configuration to your "
  285. "`inventory/host_vars/matrix.example.com/vars.yml` file:"
  286. msgstr ""