Wiki-Quellcode von Kopano für lokalen Betrieb einrichten

Version 25.1 von Jonas Mayer am 2022/05/23 13:54

version	line-number	content
21.1	1	{{toc start="5"/}}
1.1	2
	3
21.1	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
16.1	9	----
	10
21.1	11	===== __Einleitung__ =====
16.1	12
21.1	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.
1.1	14
21.1	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	)))
1.1	20
21.1	21
16.1	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/
1.1	23
	24	(% class="box" %)
	25	(((
	26	(% style="color:#000000" %)##cd /etc/logodidact/hiera/custom.d/##
	27	)))
	28
16.1	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:
1.1	30
21.1	31	* ##kopano-g1.yaml##
	32	* ##ldhost.yaml##
	33	* ##samba4-ad.yaml##
1.1	34
21.1	35	----
1.1	36
21.1	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
1.1	41	(% class="box" %)
	42	(((
4.1	43	(% style="color:#000000" %)##ld_multidrop::ensure: absent
1.1	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:
5.1	52	value: 'yes'
1.1	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'
7.1	67	# Einschränken von vordefinierte Absendern auf Empfänger der lokalen Maildomäne##(%%)
6.1	68	(% style="color:#000000" %)## smtpd_restriction_classes:
2.1	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:
1.1	75	'%{dir_etc}/smtp_generic_maps.hash':
	76	content: \|
	77	%{header}
2.1	78	# Umschreibung der Absender-Domain bei externem Mailversand
	79	# (Dummy-Eintrag, durch Empfängerfilterung nicht genutzt)
1.1	80	@%{::fqdn} @example.com
	81	'%{dir_etc}/sender_dependent_relayhost_maps_external.hash':
	82	content: \|
	83	%{header}
2.1	84	# Bounce-Nachrichten mit Null-Sender via Relayhost versenden
1.1	85	<> smtp.example.com
2.1	86	# Mails an externe Empfänger via Relayhost versenden
1.1	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
2.1	96	'%{dir_etc}/restricted_senders.pcre':
	97	content: \|
	98	%{header}
7.1	99	# Regular Expression Format: Liste an Absendern, deren Versand eingeschränkt wird
2.1	100	/@(.+?\.)?%{::domain}$/ local_only
	101	'%{dir_etc}/local_domains.pcre':
	102	content: \|
	103	%{header}
7.1	104	# Regular Expression Format: Liste erlaubter Empfängerdomänen für die eingeschränkten Absender
2.1	105	/@(.+?\.)?%{::domain}$/ OK
3.1	106	\\\\ld_kopano::postfix::verbose: false
1.1	107	\\ld_kopano::ldap_type: openldap
9.1	108	\\ld_kopano::db_server: mariadb103##
1.1	109	)))
	110
	111
21.1	112	----
1.1	113
21.1	114	===== (% style="color:#000000" %)Anpassungen in der (% style="color:#3498db" %)ldhost.yaml(%%) =====
	115
24.1	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.
21.1	117
1.1	118	(% class="box" %)
	119	(((
3.1	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:
1.1	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:
3.1	125	- elehrer##
1.1	126	)))
	127
	128
21.1	129	----
1.1	130
21.1	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
1.1	135	(% class="box" %)
	136	(((
4.1	137	(% style="color:#000000" %)### Kopano: Definition von Benutzern, die administrative Rechte erhalten sollen
1.1	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
18.1	144	(% class="box infomessage" %)
	145	(((
	146	__Tipp:__
	147	Um Benutzerkonten bei Verwendung des OpenLDAP-Verzeichnisdienst zu Kopano-Admins hochzustufen, muss anders vorgegangen werden.
20.1	148	Wechseln Sie hierzu in den LXC-Container logosrv und aktivieren Sie die Admin-Funktion über folgendes Kommando für alle gewünschten Benutzer:
18.1	149
10.1	150
18.1	151	{{box}}
24.1	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##
18.1	154	{{/box}}
	155	)))
	156
	157
21.1	158	----
	159
22.1	160	===== __Vorgenommene Änderungen ins Git einchecken__ =====
21.1	161
11.1	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" %).
1.1	163
	164	(% class="box" %)
	165	(((
11.1	166	(% style="color:#000000" %)##cd /etc/logodidact/
	167	git add *
	168	git commit -am "Kopano für den lokalen Betrieb eingerichtet"##
1.1	169	)))
	170
	171
11.1	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).
18.1	173
21.1	174
	175
18.1	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