overmind
/
matrix-docker-ansible-deploy
mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy
1
0
Fork 0
Code Issues 0 Releases 0 Wiki Activity
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.
8817 Commits
13 Branches
36 MiB
 
 
Tree: 0afa372ca8
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '0afa372ca8'
${ noResults }
matrix-docker-ansible-deploy/i18n/locales/bg/LC_MESSAGES/docs/configuring-playbook-ma1sd.po

344 lines
12 KiB
Raw Blame History 

  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. 

  24. #: ../../../docs/configuring-playbook-ma1sd.md:1

  25. msgid "Setting up ma1sd Identity Server (optional)"

  26. msgstr ""

  27. 

  28. #: ../../../docs/configuring-playbook-ma1sd.md:3

  29. msgid ""

  30. "**⚠️Note**: ma1sd itself has also been unmaintained for years (the latest"

  31. " commit and release being from 2021). The role of identity servers in the"

  32. " Matrix specification also has an uncertain future. **We recommend not "

  33. "bothering with installing it unless it's the only way you can do what you"

  34. " need to do**. For example, certain things like LDAP integration can also"

  35. " be implemented via [the LDAP provider module for Synapse](./configuring-"

  36. "playbook-ldap-auth.md)."

  37. msgstr ""

  38. 

  39. #: ../../../docs/configuring-playbook-ma1sd.md:5

  40. msgid ""

  41. "The playbook can configure the [ma1sd](https://github.com/ma1uta/ma1sd) "

  42. "Identity Server for you. It is a fork of [mxisd](https://github.com"

  43. "/kamax-io/mxisd) which was pronounced end of life 2019-06-21."

  44. msgstr ""

  45. 

  46. #: ../../../docs/configuring-playbook-ma1sd.md:7

  47. msgid ""

  48. "ma1sd is used for 3PIDs (3rd party identifiers like E-mail and phone "

  49. "numbers) and some [enhanced "

  50. "features](https://github.com/ma1uta/ma1sd/#features). It is private by "

  51. "default, potentially at the expense of user discoverability."

  52. msgstr ""

  53. 

  54. #: ../../../docs/configuring-playbook-ma1sd.md:9

  55. msgid ""

  56. "See the project's "

  57. "[documentation](https://github.com/ma1uta/ma1sd/blob/master/README.md) to"

  58. " learn what it does and why it might be useful to you."

  59. msgstr ""

  60. 

  61. #: ../../../docs/configuring-playbook-ma1sd.md:11

  62. msgid ""

  63. "**Note**: enabling ma1sd, means that the `openid` API endpoints will be "

  64. "exposed on the Matrix Federation port (usually `8448`), even if "

  65. "[federation](configuring-playbook-federation.md) is disabled. It's "

  66. "something to be aware of, especially in terms of firewall whitelisting "

  67. "(make sure port `8448` is accessible)."

  68. msgstr ""

  69. 

  70. #: ../../../docs/configuring-playbook-ma1sd.md:13

  71. msgid "Adjusting DNS records"

  72. msgstr ""

  73. 

  74. #: ../../../docs/configuring-playbook-ma1sd.md:15

  75. msgid ""

  76. "To make the ma1sd Identity Server enable its federation features, set up "

  77. "a SRV record that looks like this:"

  78. msgstr ""

  79. 

  80. #: ../../../docs/configuring-playbook-ma1sd.md:17

  81. msgid "Name: `_matrix-identity._tcp` (use this text as-is)"

  82. msgstr ""

  83. 

  84. #: ../../../docs/configuring-playbook-ma1sd.md:18

  85. msgid ""

  86. "Content: `10 0 443 matrix.example.com` (replace `example.com` with your "

  87. "own)"

  88. msgstr ""

  89. 

  90. #: ../../../docs/configuring-playbook-ma1sd.md:20

  91. msgid ""

  92. "See [ma1sd's documentation](https://github.com/ma1uta/ma1sd/wiki/mxisd-"

  93. "and-your-privacy#choices-are-never-easy) for information on the privacy "

  94. "implications of setting up this SRV record."

  95. msgstr ""

  96. 

  97. #: ../../../docs/configuring-playbook-ma1sd.md:22

  98. msgid ""

  99. "**Note**: This `_matrix-identity._tcp` SRV record for the identity server"

  100. " is different from the `_matrix._tcp` that can be used for Synapse "

  101. "delegation. See [howto-server-delegation.md](howto-server-delegation.md) "

  102. "for more information about delegation."

  103. msgstr ""

  104. 

  105. #: ../../../docs/configuring-playbook-ma1sd.md:24

  106. msgid "Adjusting the playbook configuration"

  107. msgstr ""

  108. 

  109. #: ../../../docs/configuring-playbook-ma1sd.md:26

  110. msgid ""

  111. "To enable ma1sd, add the following configuration to your "

  112. "`inventory/host_vars/matrix.example.com/vars.yml` file:"

  113. msgstr ""

  114. 

  115. #: ../../../docs/configuring-playbook-ma1sd.md:32

  116. msgid "Matrix.org lookup forwarding"

  117. msgstr ""

  118. 

  119. #: ../../../docs/configuring-playbook-ma1sd.md:34

  120. msgid ""

  121. "To ensure maximum discovery, you can make your identity server also "

  122. "forward lookups to the central matrix.org Identity server (at the cost of"

  123. " potentially leaking all your contacts information)."

  124. msgstr ""

  125. 

  126. #: ../../../docs/configuring-playbook-ma1sd.md:36

  127. msgid ""

  128. "Enabling this is discouraged and you'd better [learn "

  129. "more](https://github.com/ma1uta/ma1sd/blob/master/docs/features/identity.md#lookups)"

  130. " before proceeding."

  131. msgstr ""

  132. 

  133. #: ../../../docs/configuring-playbook-ma1sd.md:38

  134. msgid ""

  135. "To enable matrix.org forwarding, add the following configuration to your "

  136. "`inventory/host_vars/matrix.example.com/vars.yml` file:"

  137. msgstr ""

  138. 

  139. #: ../../../docs/configuring-playbook-ma1sd.md:44

  140. msgid "Additional features"

  141. msgstr ""

  142. 

  143. #: ../../../docs/configuring-playbook-ma1sd.md:46

  144. msgid ""

  145. "What this playbook configures for your is some bare minimum Identity "

  146. "Server functionality, so that you won't need to rely on external 3rd "

  147. "party services."

  148. msgstr ""

  149. 

  150. #: ../../../docs/configuring-playbook-ma1sd.md:48

  151. msgid ""

  152. "A few variables can be toggled in this playbook to alter the ma1sd "

  153. "configuration that gets generated."

  154. msgstr ""

  155. 

  156. #: ../../../docs/configuring-playbook-ma1sd.md:50

  157. msgid ""

  158. "Still, ma1sd can do much more. You can refer to the [ma1sd "

  159. "website](https://github.com/ma1uta/ma1sd) for more details and "

  160. "configuration options."

  161. msgstr ""

  162. 

  163. #: ../../../docs/configuring-playbook-ma1sd.md:52

  164. msgid ""

  165. "To use a more custom configuration, you can define a "

  166. "`matrix_ma1sd_configuration_extension_yaml` string variable and put your "

  167. "configuration in it. To learn more about how to do this, refer to the "

  168. "information about `matrix_ma1sd_configuration_extension_yaml` in the "

  169. "[default variables file](../roles/custom/matrix-ma1sd/defaults/main.yml) "

  170. "of the ma1sd component."

  171. msgstr ""

  172. 

  173. #: ../../../docs/configuring-playbook-ma1sd.md:54

  174. msgid "Customizing email templates"

  175. msgstr ""

  176. 

  177. #: ../../../docs/configuring-playbook-ma1sd.md:56

  178. msgid ""

  179. "If you'd like to change the default email templates used by ma1sd, take a"

  180. " look at the `matrix_ma1sd_threepid_medium_email_custom_` variables (in "

  181. "the `roles/custom/matrix-ma1sd/defaults/main.yml` file."

  182. msgstr ""

  183. 

  184. #: ../../../docs/configuring-playbook-ma1sd.md:58

  185. msgid "ma1sd-controlled Registration"

  186. msgstr ""

  187. 

  188. #: ../../../docs/configuring-playbook-ma1sd.md:60

  189. msgid ""

  190. "To use the "

  191. "[Registration](https://github.com/ma1uta/ma1sd/blob/master/docs/features/registration.md)"

  192. " feature of ma1sd, you can make use of the following variables:"

  193. msgstr ""

  194. 

  195. #: ../../../docs/configuring-playbook-ma1sd.md:62

  196. msgid ""

  197. "`matrix_synapse_enable_registration` - to enable user-initiated "

  198. "registration in Synapse"

  199. msgstr ""

  200. 

  201. #: ../../../docs/configuring-playbook-ma1sd.md:64

  202. msgid ""

  203. "`matrix_synapse_enable_registration_captcha` - to validate registering "

  204. "users using reCAPTCHA, as described in the [enabling reCAPTCHA"

  205. "](configuring-captcha.md) documentation."

  206. msgstr ""

  207. 

  208. #: ../../../docs/configuring-playbook-ma1sd.md:66

  209. msgid ""

  210. "`matrix_synapse_registrations_require_3pid` - a list of 3pid types (among"

  211. " `'email'`, `'msisdn'`) required by the Synapse server for registering"

  212. msgstr ""

  213. 

  214. #: ../../../docs/configuring-playbook-ma1sd.md:68

  215. msgid ""

  216. "variables prefixed with `matrix_ma1sd_container_labels_` (e.g. "

  217. "`matrix_ma1sd_container_labels_matrix_client_3pid_registration_enabled`) "

  218. "- to configure the Traefik reverse-proxy to capture and send registration"

  219. " requests to ma1sd (instead of Synapse), so it can apply its additional "

  220. "functionality"

  221. msgstr ""

  222. 

  223. #: ../../../docs/configuring-playbook-ma1sd.md:70

  224. msgid ""

  225. "`matrix_ma1sd_configuration_extension_yaml` - to configure ma1sd as "

  226. "required. See the [Registration feature's "

  227. "docs](https://github.com/ma1uta/ma1sd/blob/master/docs/features/registration.md)"

  228. " for inspiration. Also see the [Additional features](#additional-"

  229. "features) section below to learn more about how to use "

  230. "`matrix_ma1sd_configuration_extension_yaml`."

  231. msgstr ""

  232. 

  233. #: ../../../docs/configuring-playbook-ma1sd.md:72

  234. msgid ""

  235. "**Note**: For this to work, either the homeserver needs to [federate"

  236. "](configuring-playbook-federation.md) or the `openid` APIs need to "

  237. "exposed on the federation port. When federation is disabled and ma1sd is "

  238. "enabled, we automatically expose the `openid` APIs (only!) on the "

  239. "federation port. Make sure the federation port (usually "

  240. "`https://matrix.example.com:8448`) is whitelisted in your firewall (even "

  241. "if you don't actually use/need federation)."

  242. msgstr ""

  243. 

  244. #: ../../../docs/configuring-playbook-ma1sd.md:74

  245. msgid "Authentication"

  246. msgstr ""

  247. 

  248. #: ../../../docs/configuring-playbook-ma1sd.md:76

  249. msgid ""

  250. "[Authentication](https://github.com/ma1uta/ma1sd/blob/master/docs/features/authentication.md)"

  251. " provides the possibility to use your own [Identity "

  252. "Stores](https://github.com/ma1uta/ma1sd/blob/master/docs/stores/README.md)"

  253. " (for example LDAP) to authenticate users on your Homeserver."

  254. msgstr ""

  255. 

  256. #: ../../../docs/configuring-playbook-ma1sd.md:78

  257. msgid ""

  258. "To enable authentication against an LDAP server, add the following "

  259. "configuration to your `inventory/host_vars/matrix.example.com/vars.yml` "

  260. "file:"

  261. msgstr ""

  262. 

  263. #: ../../../docs/configuring-playbook-ma1sd.md:98

  264. msgid "Example: SMS verification"

  265. msgstr ""

  266. 

  267. #: ../../../docs/configuring-playbook-ma1sd.md:100

  268. msgid ""

  269. "If your use case requires mobile verification, it is quite simple to "

  270. "integrate ma1sd with [Twilio](https://www.twilio.com/), an online "

  271. "telephony services gateway. Their prices are reasonable for low-volume "

  272. "projects and integration can be done with the following configuration:"

  273. msgstr ""

  274. 

  275. #: ../../../docs/configuring-playbook-ma1sd.md:114

  276. msgid "Example: Open Registration for every Domain"

  277. msgstr ""

  278. 

  279. #: ../../../docs/configuring-playbook-ma1sd.md:116

  280. msgid ""

  281. "If you want to open registration for any domain, you have to setup the "

  282. "allowed domains with ma1sd's `blacklist` and `whitelist`. The default "

  283. "behavior when neither the `blacklist`, nor the `whitelist` match, is to "

  284. "allow registration. Beware: you can't block toplevel domains (aka `.xy`) "

  285. "because the internal architecture of ma1sd doesn't allow that."

  286. msgstr ""

  287. 

  288. #: ../../../docs/configuring-playbook-ma1sd.md:130

  289. msgid "Installing"

  290. msgstr ""

  291. 

  292. #: ../../../docs/configuring-playbook-ma1sd.md:132

  293. msgid ""

  294. "After configuring the playbook, run it with [playbook tags](playbook-"

  295. "tags.md) as below:"

  296. msgstr ""

  297. 

  298. #: ../../../docs/configuring-playbook-ma1sd.md:139

  299. msgid ""

  300. "The shortcut commands with the [`just` program](just.md) are also "

  301. "available: `just install-all` or `just setup-all`"

  302. msgstr ""

  303. 

  304. #: ../../../docs/configuring-playbook-ma1sd.md:141

  305. msgid ""

  306. "`just install-all` is useful for maintaining your setup quickly ([2x-5x "

  307. "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-"

  308. "runtime) than `just setup-all`) when its components remain unchanged. If "

  309. "you adjust your `vars.yml` to remove other components, you'd need to run "

  310. "`just setup-all`, or these components will still remain installed. Note "

  311. "these shortcuts run the `ensure-matrix-users-created` tag too."

  312. msgstr ""

  313. 

  314. #: ../../../docs/configuring-playbook-ma1sd.md:143

  315. msgid "Troubleshooting"

  316. msgstr ""

  317. 

  318. #: ../../../docs/configuring-playbook-ma1sd.md:145

  319. msgid ""

  320. "If email address validation emails sent by ma1sd are not reaching you, "

  321. "you should look into [Adjusting email-sending settings](configuring-"

  322. "playbook-email.md)."

  323. msgstr ""

  324. 

  325. #: ../../../docs/configuring-playbook-ma1sd.md:147

  326. msgid ""

  327. "If you'd like additional logging information, temporarily enable verbose "

  328. "logging for ma1sd."

  329. msgstr ""

  330. 

  331. #: ../../../docs/configuring-playbook-ma1sd.md:149

  332. msgid ""

  333. "To enable it, add the following configuration to your "

  334. "`inventory/host_vars/matrix.example.com/vars.yml` file:"

  335. msgstr ""

  336. 

  337. #~ msgid ""

  338. #~ "See the project's "

  339. #~ "[documentation](https://github.com/ma1uta/ma1sd) to learn"

  340. #~ " what it does and why it might"

  341. #~ " be useful to you."

  342. #~ msgstr ""