Wiki source code of LDAP-Benutzer unter Linux

Version 13.1 by Jonas Jelten on 2024/12/12 16:12

version	line-number	content
9.1	1	# Für wen ist diese Anleitung
1.1	2
7.1	3	Nicht relevant: für VMs im ITO-VM-Cluster mit Ubuntu 24.04 oder neuer - diese haben das LDAP-Setup direkt schon mitgeliefert!
1.1	4
7.1	5	Relevant für: Alle Maschinen, auf denen CIT-Benutzer (alle aus der StrukturDB) am Rechner verfügbar sein sollen - z.B. damit Nutzer sich über SSH mit ihrem CIT-Account anmelden können
	6
1.1	7	Falls du den LDAP für andere Zwecke benutzen möchtest (Einbindung in ein Mailprogramm, als Kontaktbuch oder für Webanwendungen), ist dies vermutlich nicht die passende Anleitung.
	8
9.1	9	# Allgemein
4.1	10
2.1	11	{{warning}}
11.1	12	Für die VMs der ITO: Bitte nicht die von uns vorinstallierten statischen Benutzer in /etc/passwd, /etc/shadow und /home entfernen. Der LDAP muss so installiert werden, dass diese statischen Benutzereinträge zusätzlich noch funktionieren. Für Wartungszwecke ist es uns wichtig, dass dies auch dann noch funktioniert, wenn die VM keine Netzwerkverbindung hat.
2.1	13	{{/warning}}
1.1	14
	15	Ihr könnt gerne mit uns Rücksprache halten, wenn Ihr unseren LDAP für Loginzwecke benutzen möchtet, denn wir bleiben auch gerne darüber informiert, wo eine solche Konfiguration eingesetzt wird.
	16
9.1	17	# Anleitung
4.1	18
9.1	19	Wir wählen den Weg mit `nslcd` und `pam-ldapd` und `nss-ldapd`, weil leichter zu debuggen ist, leichtgewichtiger (die pam/nss-module reden mit nslcd und bauen nicht jeder einzeln eine ldap-verbindung auf).
1.1	20
	21	Zunächst den LDAP-Connector-Dienst installieren:
2.1	22
9.1	23	```bash
1.1	24	apt install nslcd
9.1	25	```
1.1	26
	27	Das fragt einen normalerweise nach dem LDAP-Server und nach dem Base-DN.
	28
	29	LDAP-Server:
2.1	30
9.1	31	ldaps://ldap.cit.tum.de
2.1	32
1.1	33	Base-DN:
2.1	34
9.1	35	ou=dir,dc=cit,dc=tum,dc=de
1.1	36
9.1	37	Konfiguration in `/etc/nslcd.conf`:
1.1	38
11.2	39	```
	40	# /etc/nslcd.conf
	41	# nslcd configuration file. See nslcd.conf(5)
	42	# for details.
9.1	43
11.2	44	# The user and group nslcd should run as.
	45	uid nslcd
	46	gid nslcd
9.1	47
11.2	48	# The location at which the LDAP server(s) should be reachable.
	49	uri ldaps://ldap.cit.tum.de
9.1	50
11.2	51	# The search base that will be used for all queries.
	52	base ou=dir,dc=cit,dc=tum,dc=de
9.1	53
11.2	54	# The LDAP protocol version to use.
	55	#ldap_version 3
9.1	56
11.2	57	# The DN to bind with for normal lookups.
	58	#binddn cn=annonymous,dc=example,dc=net
	59	#bindpw secret
9.1	60
11.2	61	# The DN used for password modifications by root.
	62	#rootpwmoddn cn=admin,dc=example,dc=com
9.1	63
11.2	64	# SSL options
	65	#ssl off
	66	tls_reqcert demand
	67	tls_cacertfile /etc/ssl/certs/ca-certificates.crt
9.1	68
11.2	69	# The search scope.
	70	#scope sub
	71	```
1.1	72
9.1	73	Der Installationsprozess sollte schon automatisch die Einträge in `/etc/pam.d/common-*` angelegt haben.
1.1	74
	75	Wenn nicht, kann man die für für LDAP notwendigen Einträge aktualisieren mit:
2.1	76
9.1	77	```bash
1.1	78	sudo pam-auth-update
9.1	79	```
1.1	80
	81	Nach den Config-Änderungen die Dienste neu starten:
2.1	82
9.1	83	```bash
1.1	84	sudo systemctl restart nscd nslcd
9.1	85	```
1.1	86
9.1	87	# Testing und Debugging
1.1	88
4.1	89	Man sollte jetzt in einer Shell Nutzer aus dem LDAP abfragen können:
1.1	90
11.2	91	```
	92	id $username
	93	```
1.1	94
4.1	95	Auflisten aller Nutzer:
	96
11.2	97	```
	98	getent passwd
	99	```
4.1	100
	101	Auflisten aller Gruppen:
	102
11.2	103	```
	104	getent group
	105	```
4.1	106
	107	Was mit dem LDAP gesprochen wird kann man sich live anschauen um besser fehler zu finden:
	108
9.1	109	```bash
1.1	110	sudo systemctl stop nslcd.service
	111	sudo nslcd -n -d # starte im vordergrund im debug-modus
	112	# jetzt schauen was so passiert
	113	# danach mit C-c beenden, und normalen Dienst wieder starten:
	114	sudo systemctl start nslcd.service
9.1	115	```
11.2	116
	117	## Homedirectory
	118
	119	Wo die Home-Verzeichnisse abgelegt werden oder von wo sie eingebunden werden, und welches LDAP-Attribut für den Home-Pfad benutzt wird, ist im Einzelfall zu überlegen.
	120	Man kann z.B. in der `/etc/nslcd.conf` das homefolderattribut anders mappen (siehe `man nslcd.conf`)
	121
	122	```
	123	map passwd homeDirectory ...
	124	```
	125
	126	# Dienst-Spezifische Konfiguration
	127
	128	## Filtern von Nutzern mit Gruppen
	129
	130	Auf ldap.cit.tum.de sind alle CIT-Benutzer. Gewöhnlich möchte man nicht, dass sie sich alle anmelden können.
	131	Die gängige Lösung ist, dass man eine Benutzergruppe definiert (auch in der StrukturDB als LDAP-Gruppe oder auch lokal aus /etc/groups) mit den Benutzern, die sich einloggen dürfen.
	132	Diese Gruppe konfigurieren wir dann in allen installierten Diensten, die eine Benutzeranmeldung ermöglichen.
	133
	134	## PAM-Logins
	135
	136	Für logins über PAM (z.b. `ssh`) kann man es global mit `pam_access` in `/etc/security/access.conf` regulieren.
	137	Dafür: `/usr/share/pam-configs/ito-ldap` anlegen:
	138
	139	```
	140	Name: ITO LDAP group-based Authentication
	141	Default: yes
	142	Priority: 128
	143	Auth-Type: Additional
	144	Auth:
	145	required pam_access.so nodefgroup
	146	Account-Type: Primary
	147	Account:
	148	required pam_access.so nodefgroup
	149	Password-Type: Primary
	150	Password:
	151	required pam_access.so nodefgroup
	152	Session-Type: Additional
	153	Session:
	154	required pam_access.so nodefgroup
	155	```
	156
	157	und dann aktivieren: `pam-auth-update --enable ito-ldap --enable ldap --enable mkhomedir`
	158
	159	## sudo
	160
	161	`sudo` (`sudoers`) config für passwortlosen root-zugriff:
	162
	163	```
	164	%deine-ldap-gruppe ALL=(ALL) NOPASSWD: ALL
	165	```
	166
	167	## SSH-Key Login aus StrukturDB
	168
	169	Damit `ssh` automatisch ssh-keys von Nutzern aus der StrukturDB verwendet, muss man diese aus dem LDAP abholen. config für `ssh`:
	170
	171	```
	172	AuthorizedKeysCommand /usr/local/bin/ssh-ldap-key
	173	AuthorizedKeysCommandUser nobody
	174	```
	175
13.1	176	[[attach:ssh-ldap-key]]-programm zum download

Wiki source code of LDAP-Benutzer unter Linux

Navigation