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