Zum Inhalt springen
Version 25.1 von Jonas Mayer am 2022/05/23 13:54
Zeige letzte Bearbeiter
1 {{toc start="5"/}}
2
3
4 ===== (% style="color:#000000" %)__Voraussetzung__(%%) =====
5
6 Eine abgeschlossene [[Kopano-Grundinstallation>>doc:xwiki:Main.Kopano.Allgemein.Kopano Grundinstallation.WebHome]] mit Anbindung an die MariaDB103 als Datenbank muss gegeben sein.
7
8
9 ----
10
11 ===== __Einleitung__ =====
12
13 (% 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.
14
15 (% class="box successmessage" %)
16 (((
17 (% style="font-size:12px" %)**__Hinweis:__**(%%)
18 (% style="font-size:12px" %)Im lokalen Betrieb können keine Nachrichten an externe Mailadressen versendet werden. Die Kommunikation ist strikt auf interne Adressen beschränkt.
19 )))
20
21
22 (% 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/
23
24 (% class="box" %)
25 (((
26 (% style="color:#000000" %)##cd /etc/logodidact/hiera/custom.d/##
27 )))
28
29 (% 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:
30
31 * ##kopano-g1.yaml##
32 * ##ldhost.yaml##
33 * ##samba4-ad.yaml##
34
35 ----
36
37 ===== (% style="color:#000000" %)__Anpassungen in der __(% style="color:#3498db" %)__kopano-g1.yaml__(%%) =====
38
39 (% style="color:#000000" %)Ü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.
40
41 (% class="box" %)
42 (((
43 (% style="color:#000000" %)##ld_multidrop::ensure: absent
44 \\ld_kopano::amavisd_new::configs:
45 '@local_domains_maps': "( new_RE( qr'[@.](.*~\~\.?%{::domain})$'i ) )"
46 \\ld_kopano::postfix::configs:
47 smtp_generic_maps:
48 value: 'hash:%{dir_etc}/smtp_generic_maps.hash'
49 sender_dependent_relayhost_maps:
50 value: 'pcre:%{dir_etc}/sender_dependent_relayhost_maps_internal.pcre'
51 smtp_sender_dependent_authentication:
52 value: 'yes'
53 smtp_sasl_auth_enable:
54 value: 'yes'
55 smtp_sasl_password_maps:
56 value: 'hash:%{dir_etc}/smtp_sasl_password_maps.hash'
57 smtp_sasl_security_options:
58 value: 'noanonymous, noplaintext'
59 smtp_sasl_tls_security_options:
60 value: 'noanonymous'
61 smtp_tls_session_cache_database:
62 value: 'btree:${data_directory}/smtp_scache'
63 smtp_use_tls:
64 value: 'yes'
65 virtual_mailbox_domains:
66 value: 'pcre:%{dir_etc}/virtual_mailbox_domains_internal.pcre'
67 # Einschränken von vordefinierte Absendern auf Empfänger der lokalen Maildomäne##(%%)
68 (% style="color:#000000" %)## smtpd_restriction_classes:
69 value: 'local_only'
70 local_only:
71 value: 'check_recipient_access pcre:%{dir_etc}/local_domains.pcre, reject'
72 smtpd_recipient_restrictions:
73 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'
74 \\\\ld_kopano::postfix::hashes:
75 '%{dir_etc}/smtp_generic_maps.hash':
76 content: |
77 %{header}
78 # Umschreibung der Absender-Domain bei externem Mailversand
79 # (Dummy-Eintrag, durch Empfängerfilterung nicht genutzt)
80 @%{::fqdn} @example.com
81 '%{dir_etc}/sender_dependent_relayhost_maps_external.hash':
82 content: |
83 %{header}
84 # Bounce-Nachrichten mit Null-Sender via Relayhost versenden
85 <> smtp.example.com
86 # Mails an externe Empfänger via Relayhost versenden
87 @example.com smtp.example.com
88 '%{dir_etc}/smtp_sasl_password_maps.hash':
89 content: |
90 %{header}
91 #user1@example.com user1@example.com:geheim
92 '%{dir_etc}/virtual_mailbox_domains_external.hash':
93 content: |
94 %{header}
95 example.com ACCEPT
96 '%{dir_etc}/restricted_senders.pcre':
97 content: |
98 %{header}
99 # Regular Expression Format: Liste an Absendern, deren Versand eingeschränkt wird
100 /@(.+?\.)?%{::domain}$/ local_only
101 '%{dir_etc}/local_domains.pcre':
102 content: |
103 %{header}
104 # Regular Expression Format: Liste erlaubter Empfängerdomänen für die eingeschränkten Absender
105 /@(.+?\.)?%{::domain}$/ OK
106 \\\\ld_kopano::postfix::verbose: false
107 \\ld_kopano::ldap_type: openldap
108 \\ld_kopano::db_server: mariadb103##
109 )))
110
111
112 ----
113
114 ===== (% style="color:#000000" %)Anpassungen in der (% style="color:#3498db" %)ldhost.yaml(%%) =====
115
116 (% style="color:#000000" %)Hier wird die Maildomain (und als Resultat die primäre SMTP-Absenderadresse) festgelegt, die Benutzer im OpenLDAP-Attribut **mail** unter (% style="color:#3498db" %)/var/lds/user/USERNAME/mail(% style="color:#000000" %) im (% style="color:#3498db" %)logosrv (% style="color:#000000" %)erhalten.
117
118 (% class="box" %)
119 (((
120 (% 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##(%%)
121 (% style="color:#000000" %)###ld_legacy::mail::filters:
122 # '(zarafaaccount=1)': 'example.com'
123 # Kopano: Definition von Gruppen, die eine Mailadresse erhalten sollen und dadurch anschreibbar werden
124 ld_legacy::mail::zarafa_groups:
125 - elehrer##
126 )))
127
128
129 ----
130
131 ===== (% style="color:#000000" %)Anpassungen in der (% style="color:#3498db" %)samba4-ad.yaml(%%) =====
132
133 (% style="color:#000000" %)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.
134
135 (% class="box" %)
136 (((
137 (% style="color:#000000" %)### Kopano: Definition von Benutzern, die administrative Rechte erhalten sollen
138 # (Einstellung wird nicht benutzt, sofern Kopano an das OpenLDAP angebunden ist, was dem Standard entspricht)
139 ld_samba4::ad::kopano::admins:
140 - 'admin'##
141 )))
142
143
144 (% class="box infomessage" %)
145 (((
146 __**Tipp:**__
147 Um Benutzerkonten bei Verwendung des OpenLDAP-Verzeichnisdienst zu Kopano-Admins hochzustufen, muss anders vorgegangen werden.
148 Wechseln Sie hierzu in den LXC-Container logosrv und aktivieren Sie die Admin-Funktion über folgendes Kommando für alle gewünschten Benutzer:
149
150
151 {{box}}
152 (% style="color:#16a085" %)### Das Schlüsselwort USERNAME durch den Benutzernamen austauschen, der zum Kopano-Admin werden soll (üblicherweise admin)##(%%)
153 (% style="color:#000000" %)##echo 1 >/var/lds/ldap/ou=users/uid=USERNAME/zarafaadmin##
154 {{/box}}
155 )))
156
157
158 ----
159
160 ===== __Vorgenommene Änderungen ins Git einchecken__ =====
161
162 (% style="color:#000000" %)Damit die Änderungen sauber übernommen werden, fehlt noch ein {{box}}git commit{{/box}} im (% style="color:#3498db" %)Puppeteer(% style="color:#000000" %).
163
164 (% class="box" %)
165 (((
166 (% style="color:#000000" %)##cd /etc/logodidact/
167 git add *
168 git commit -am "Kopano für den lokalen Betrieb eingerichtet"##
169 )))
170
171
172 (% 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).
173
174
175
176 ----
177
178
179 (% class="box successmessage" %)
180 (((
181 Weitere Optimierungen können in folgendem Artikel nachgelesen werden.
182 [[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/]]
183 )))
184
185