Wiki-Quellcode von Kopano mit lokalem Betrieb einrichten
Version 18.1 von Jonas Mayer am 2022/05/23 13:40
Zeige letzte Bearbeiter
author | version | line-number | content |
---|---|---|---|
1 | (% style="color:#000000" %)__**Voraussetzung**:__ | ||
2 | |||
3 | * Abgeschlossene [[Kopano-Grundinstallation>>doc:xwiki:Main.Kopano.Allgemein.Kopano Grundinstallation.WebHome]] mit Anbindung an die MariaDB103 als Datenbank | ||
4 | |||
5 | ---- | ||
6 | |||
7 | |||
8 | (% style="color:#000000" %)Um Kopano im lokalen Betrieb einzurichten, muss man Anpassungen an Konfigurationsdateien im Puppeteer vornehmen. Dadurch erhalten Benutzer dann [[username@schule.local>>mailto:username@schule.local]] als lokale Mailadresse und können untereinander Nachrichten verschicken. | ||
9 | **__Wichtig:__** Im lokalen Betrieb können keine Nachrichten an externe Mailadressen versendet werden. Die Kommunikation ist strikt auf interne Adressen beschränkt. | ||
10 | |||
11 | |||
12 | (% style="color:#000000" %)Um die Anpassungen vorzunehmen, wechselt man in den (% style="color:#3498db" %)Puppeteer (% style="color:#000000" %)und dort in das Verzeichnis(% style="color:#3498db" %) /etc/logodidact/hiera/custom.d/ | ||
13 | |||
14 | (% class="box" %) | ||
15 | ((( | ||
16 | (% style="color:#000000" %)##cd /etc/logodidact/hiera/custom.d/## | ||
17 | ))) | ||
18 | |||
19 | (% style="color:#000000" %)In diesem Verzeichnis liegen mehrere YAML-Konfigurationsdateien mit Bezug zu Kopano abgespeichert. Für die Einrichtung sind die nachfolgende Dateien von Relevanz: | ||
20 | |||
21 | (% class="box" %) | ||
22 | ((( | ||
23 | (% style="color:#000000" %)##kopano-g1.yaml / ldhost.yaml / samba4-ad.yaml## | ||
24 | ))) | ||
25 | |||
26 | |||
27 | (% style="color:#000000" %)Anpassungen in der (% style="color:#3498db" %)kopano-g1.yaml(% style="color:#000000" %): | ||
28 | Üblicherweise trägt man in der kopano-g1.yaml die gewünschte externe Maildomain sowie Zugangsdaten für das zugehörige Catchall-Postfach der Domain ein. Da wir jedoch keine externe Maildomain verwenden, bleiben diese Felder auf den Default-Wert bestehen. | ||
29 | |||
30 | (% class="box" %) | ||
31 | ((( | ||
32 | (% style="color:#000000" %)##ld_multidrop::ensure: absent | ||
33 | \\ld_kopano::amavisd_new::configs: | ||
34 | '@local_domains_maps': "( new_RE( qr'[@.](.*~\~\.?%{::domain})$'i ) )" | ||
35 | \\ld_kopano::postfix::configs: | ||
36 | smtp_generic_maps: | ||
37 | value: 'hash:%{dir_etc}/smtp_generic_maps.hash' | ||
38 | sender_dependent_relayhost_maps: | ||
39 | value: 'pcre:%{dir_etc}/sender_dependent_relayhost_maps_internal.pcre' | ||
40 | smtp_sender_dependent_authentication: | ||
41 | value: 'yes' | ||
42 | smtp_sasl_auth_enable: | ||
43 | value: 'yes' | ||
44 | smtp_sasl_password_maps: | ||
45 | value: 'hash:%{dir_etc}/smtp_sasl_password_maps.hash' | ||
46 | smtp_sasl_security_options: | ||
47 | value: 'noanonymous, noplaintext' | ||
48 | smtp_sasl_tls_security_options: | ||
49 | value: 'noanonymous' | ||
50 | smtp_tls_session_cache_database: | ||
51 | value: 'btree:${data_directory}/smtp_scache' | ||
52 | smtp_use_tls: | ||
53 | value: 'yes' | ||
54 | virtual_mailbox_domains: | ||
55 | value: 'pcre:%{dir_etc}/virtual_mailbox_domains_internal.pcre' | ||
56 | # Einschränken von vordefinierte Absendern auf Empfänger der lokalen Maildomäne##(%%) | ||
57 | (% style="color:#000000" %)## smtpd_restriction_classes: | ||
58 | value: 'local_only' | ||
59 | local_only: | ||
60 | value: 'check_recipient_access pcre:%{dir_etc}/local_domains.pcre, reject' | ||
61 | smtpd_recipient_restrictions: | ||
62 | value: 'check_sender_access pcre:%{dir_etc}/restricted_senders.pcre, permit_mynetworks,permit_sasl_authenticated, reject_invalid_hostname, reject_non_fqdn_hostname, reject_non_fqdn_recipient, reject_non_fqdn_sender, reject_unknown_recipient_domain, reject_unknown_sender_domain, reject_unauth_destination, reject_unauth_pipelining, reject' | ||
63 | \\\\ld_kopano::postfix::hashes: | ||
64 | '%{dir_etc}/smtp_generic_maps.hash': | ||
65 | content: | | ||
66 | %{header} | ||
67 | # Umschreibung der Absender-Domain bei externem Mailversand | ||
68 | # (Dummy-Eintrag, durch Empfängerfilterung nicht genutzt) | ||
69 | @%{::fqdn} @example.com | ||
70 | '%{dir_etc}/sender_dependent_relayhost_maps_external.hash': | ||
71 | content: | | ||
72 | %{header} | ||
73 | # Bounce-Nachrichten mit Null-Sender via Relayhost versenden | ||
74 | <> smtp.example.com | ||
75 | # Mails an externe Empfänger via Relayhost versenden | ||
76 | @example.com smtp.example.com | ||
77 | '%{dir_etc}/smtp_sasl_password_maps.hash': | ||
78 | content: | | ||
79 | %{header} | ||
80 | #user1@example.com user1@example.com:geheim | ||
81 | '%{dir_etc}/virtual_mailbox_domains_external.hash': | ||
82 | content: | | ||
83 | %{header} | ||
84 | example.com ACCEPT | ||
85 | '%{dir_etc}/restricted_senders.pcre': | ||
86 | content: | | ||
87 | %{header} | ||
88 | # Regular Expression Format: Liste an Absendern, deren Versand eingeschränkt wird | ||
89 | /@(.+?\.)?%{::domain}$/ local_only | ||
90 | '%{dir_etc}/local_domains.pcre': | ||
91 | content: | | ||
92 | %{header} | ||
93 | # Regular Expression Format: Liste erlaubter Empfängerdomänen für die eingeschränkten Absender | ||
94 | /@(.+?\.)?%{::domain}$/ OK | ||
95 | \\\\ld_kopano::postfix::verbose: false | ||
96 | \\ld_kopano::ldap_type: openldap | ||
97 | \\ld_kopano::db_server: mariadb103## | ||
98 | ))) | ||
99 | |||
100 | |||
101 | (% style="color:#000000" %)Anpassungen in der (% style="color:#3498db" %)ldhost.yaml(% style="color:#000000" %): | ||
102 | Hier wird die Maildomain festgelegt, die Benutzer im Attribut mail unter (% style="color:#3498db" %)/var/lds/user/username/mail(% style="color:#000000" %) im (% style="color:#3498db" %)logosrv (% style="color:#000000" %)erhalten. | ||
103 | |||
104 | (% class="box" %) | ||
105 | ((( | ||
106 | (% style="color:#000000; font-family:~"Open Sans~",~"Helvetica Neue~",Helvetica,Arial,sans-serif" %)### Kopano: Definition einer Maildomain (abweichend zu schule.local), die Benutzer & Gruppen im LDAP-Feld 'mail' erhalten sollen##(%%) | ||
107 | (% style="color:#000000" %)###ld_legacy::mail::filters: | ||
108 | # '(zarafaaccount=1)': 'example.com' | ||
109 | # Kopano: Definition von Gruppen, die eine Mailadresse erhalten sollen und dadurch anschreibbar werden | ||
110 | ld_legacy::mail::zarafa_groups: | ||
111 | - elehrer## | ||
112 | ))) | ||
113 | |||
114 | |||
115 | (% style="color:#000000" %)Nun fehlen noch die Anpassungen in der (% style="color:#3498db" %)samba4-ad.yaml(% style="color:#000000" %): | ||
116 | Hier kann dem admin die administrativen Rechte zugeteilt. Falls noch andere Benutzer mit administrativen Rechten innerhalb von Kopano ausgestattet werden sollen, können diese ergänzt werden. | ||
117 | |||
118 | (% class="box" %) | ||
119 | ((( | ||
120 | (% style="color:#000000" %)### Kopano: Definition von Benutzern, die administrative Rechte erhalten sollen | ||
121 | # (Einstellung wird nicht benutzt, sofern Kopano an das OpenLDAP angebunden ist, was dem Standard entspricht) | ||
122 | ld_samba4::ad::kopano::admins: | ||
123 | - 'admin'## | ||
124 | ))) | ||
125 | |||
126 | |||
127 | (% class="box infomessage" %) | ||
128 | ((( | ||
129 | __**Tipp:**__ | ||
130 | Um Benutzerkonten bei Verwendung des OpenLDAP-Verzeichnisdienst zu Kopano-Admins hochzustufen, muss anders vorgegangen werden. | ||
131 | Wechseln Sie hierzu in den LXC-Container logosrv und aktivieren Sie die Admin-Funktion über folgendes Kommando für alle gewünschten Beutzer: | ||
132 | |||
133 | |||
134 | ---- | ||
135 | |||
136 | {{box}} | ||
137 | (% style="color:#16a085" %)### Das Schlüsselwort NAME durch den Benutzernamen austauschen, der zum Kopano-Admin werden soll (üblicherweise admin)##(%%) | ||
138 | (% style="color:#000000" %)##echo 1 >/var/lds/ldap/ou=users/uid=NAME/zarafaadmin## | ||
139 | {{/box}} | ||
140 | ))) | ||
141 | |||
142 | |||
143 | (% style="color:#000000" %)Damit die Änderungen sauber übernommen werden, fehlt noch ein {{box}}git commit{{/box}} im (% style="color:#3498db" %)Puppeteer(% style="color:#000000" %). | ||
144 | |||
145 | (% class="box" %) | ||
146 | ((( | ||
147 | (% style="color:#000000" %)##cd /etc/logodidact/ | ||
148 | git add * | ||
149 | git commit -am "Kopano für den lokalen Betrieb eingerichtet"## | ||
150 | ))) | ||
151 | |||
152 | |||
153 | (% style="color:#000000" %)Führen Sie bitte abschließend noch einen {{box}}prun{{/box}}(%%) in den betreffenden LXC-Containern aus (% style="color:#000000" %)(d.h. in allen Container, die durch Anpassungen in den YAML-Dateien Änderungen erhalten). | ||
154 | |||
155 | ---- | ||
156 | |||
157 | |||
158 | (% class="box successmessage" %) | ||
159 | ((( | ||
160 | Weitere Optimierungen können in folgendem Artikel nachgelesen werden. | ||
161 | [[https:~~/~~/kb.logodidact.com/xwiki/bin/view/Main/Kopano/Allgemein/Optimierungen%20von%20Kopano/>>https://kb.logodidact.com/xwiki/bin/view/Main/Kopano/Allgemein/Optimierungen%20von%20Kopano/]] | ||
162 | ))) | ||
163 | |||
164 |