Wiki-Quellcode von Kopano mit lokalem Betrieb einrichten

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