Wiki-Quellcode von Kopano mit lokalem Betrieb einrichten

Version 14.1 von Jonas Mayer am 2022/05/23 13:29

version	line-number	content
14.1	1	(% style="color:#000000" %)__Voraussetzung:__
1.1	2
14.1	3	* [[Abgeschlossene Kopano-Grundinstallation mit Anbindung an die MariaDB103 als Datenbank>>doc:xwiki:Main.Kopano.Allgemein.Kopano Grundinstallation.WebHome]]
1.1	4
	5	(% 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.
	6	__Wichtig:__ Im lokalen Betrieb können keine Nachrichten an externe Mailadressen versendet werden. Die Kommunikation ist strikt auf interne Adressen beschränkt.
	7
	8
2.1	9	(% 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	10
	11	(% class="box" %)
	12	(((
	13	(% style="color:#000000" %)##cd /etc/logodidact/hiera/custom.d/##
	14	)))
	15
11.1	16	(% style="color:#000000" %)In diesem Verzeichnis liegen mehrere YAML-Konfigurationsdateien mit Bezug zu Kopano abgespeichert. Für die Einrichtung sind die Nachfolgenden von Relevanz:
1.1	17
	18	(% class="box" %)
	19	(((
9.1	20	(% style="color:#000000" %)##kopano-g1.yaml / ldhost.yaml / samba4-ad.yaml##
1.1	21	)))
	22
	23
	24	(% style="color:#000000" %)Anpassungen in der (% style="color:#3498db" %)kopano-g1.yaml(% style="color:#000000" %):
13.1	25	Ü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.
1.1	26
	27	(% class="box" %)
	28	(((
4.1	29	(% style="color:#000000" %)##ld_multidrop::ensure: absent
1.1	30	\\ld_kopano::amavisd_new::configs:
	31	'@local_domains_maps': "( new_RE( qr'[@.](.*~\~\.?%{::domain})$'i ) )"
	32	\\ld_kopano::postfix::configs:
	33	smtp_generic_maps:
	34	value: 'hash:%{dir_etc}/smtp_generic_maps.hash'
	35	sender_dependent_relayhost_maps:
	36	value: 'pcre:%{dir_etc}/sender_dependent_relayhost_maps_internal.pcre'
	37	smtp_sender_dependent_authentication:
5.1	38	value: 'yes'
1.1	39	smtp_sasl_auth_enable:
	40	value: 'yes'
	41	smtp_sasl_password_maps:
	42	value: 'hash:%{dir_etc}/smtp_sasl_password_maps.hash'
	43	smtp_sasl_security_options:
	44	value: 'noanonymous, noplaintext'
	45	smtp_sasl_tls_security_options:
	46	value: 'noanonymous'
	47	smtp_tls_session_cache_database:
	48	value: 'btree:${data_directory}/smtp_scache'
	49	smtp_use_tls:
	50	value: 'yes'
	51	virtual_mailbox_domains:
	52	value: 'pcre:%{dir_etc}/virtual_mailbox_domains_internal.pcre'
7.1	53	# Einschränken von vordefinierte Absendern auf Empfänger der lokalen Maildomäne##(%%)
6.1	54	(% style="color:#000000" %)## smtpd_restriction_classes:
2.1	55	value: 'local_only'
	56	local_only:
	57	value: 'check_recipient_access pcre:%{dir_etc}/local_domains.pcre, reject'
	58	smtpd_recipient_restrictions:
	59	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'
	60	\\\\ld_kopano::postfix::hashes:
1.1	61	'%{dir_etc}/smtp_generic_maps.hash':
	62	content: \|
	63	%{header}
2.1	64	# Umschreibung der Absender-Domain bei externem Mailversand
	65	# (Dummy-Eintrag, durch Empfängerfilterung nicht genutzt)
1.1	66	@%{::fqdn} @example.com
	67	'%{dir_etc}/sender_dependent_relayhost_maps_external.hash':
	68	content: \|
	69	%{header}
2.1	70	# Bounce-Nachrichten mit Null-Sender via Relayhost versenden
1.1	71	<> smtp.example.com
2.1	72	# Mails an externe Empfänger via Relayhost versenden
1.1	73	@example.com smtp.example.com
	74	'%{dir_etc}/smtp_sasl_password_maps.hash':
	75	content: \|
	76	%{header}
	77	#user1@example.com user1@example.com:geheim
	78	'%{dir_etc}/virtual_mailbox_domains_external.hash':
	79	content: \|
	80	%{header}
	81	example.com ACCEPT
2.1	82	'%{dir_etc}/restricted_senders.pcre':
	83	content: \|
	84	%{header}
7.1	85	# Regular Expression Format: Liste an Absendern, deren Versand eingeschränkt wird
2.1	86	/@(.+?\.)?%{::domain}$/ local_only
	87	'%{dir_etc}/local_domains.pcre':
	88	content: \|
	89	%{header}
7.1	90	# Regular Expression Format: Liste erlaubter Empfängerdomänen für die eingeschränkten Absender
2.1	91	/@(.+?\.)?%{::domain}$/ OK
3.1	92	\\\\ld_kopano::postfix::verbose: false
1.1	93	\\ld_kopano::ldap_type: openldap
9.1	94	\\ld_kopano::db_server: mariadb103##
1.1	95	)))
	96
	97
	98	(% style="color:#000000" %)Anpassungen in der (% style="color:#3498db" %)ldhost.yaml(% style="color:#000000" %):
	99	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.
	100
	101	(% class="box" %)
	102	(((
3.1	103	(% 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##(%%)
	104	(% style="color:#000000" %)###ld_legacy::mail::filters:
1.1	105	# '(zarafaaccount=1)': 'example.com'
	106	# Kopano: Definition von Gruppen, die eine Mailadresse erhalten sollen und dadurch anschreibbar werden
	107	ld_legacy::mail::zarafa_groups:
3.1	108	- elehrer##
1.1	109	)))
	110
	111
	112	(% style="color:#000000" %)Nun fehlen noch die Anpassungen in der (% style="color:#3498db" %)samba4-ad.yaml(% style="color:#000000" %):
11.1	113	Hier kann dem admin die administrativen Rechte zugeteilt. Falls noch andere Benutzer mit administrativen Rechten innerhalb von Kopano vergeben werden sollen, können diese ergänzt werden.
1.1	114
	115	(% class="box" %)
	116	(((
4.1	117	(% style="color:#000000" %)### Kopano: Definition von Benutzern, die administrative Rechte erhalten sollen
1.1	118	# (Einstellung wird nicht benutzt, sofern Kopano an das OpenLDAP angebunden ist, was dem Standard entspricht)
	119	ld_samba4::ad::kopano::admins:
	120	- 'admin'##
	121	)))
	122
	123
11.1	124	Weitere Optimierungen können in folgendem Artikel nachgelesen werden.
10.1	125	[[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/]]
	126
	127
11.1	128	(% 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	129
	130	(% class="box" %)
	131	(((
11.1	132	(% style="color:#000000" %)##cd /etc/logodidact/
	133	git add *
	134	git commit -am "Kopano für den lokalen Betrieb eingerichtet"##
1.1	135	)))
	136
	137
11.1	138	(% 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).