Wiki-Quellcode von Kopano mit lokalem Betrieb einrichten

Version 19.1 von Jonas Mayer am 2022/05/23 13:40

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