LDAP: Difference between revisions

From NURDspace
 
(39 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Project
{{Project
|ProjectSkills=Linux, OpenLDAP, reading documentation, asking Wilco for help
|Name=LDAP
|ProjectStatus=Active
|Skills=Linux, FreeIPA
|ProjectNiche=Software
|Status=Implemented
|ProjectPurpose=Infrastructure
|Niche=Software
|Purpose=Infrastructure
|Tool=Yes
}}
}}
= Status =


For use with [[Spacenet]] we've installed OpenLDAP on [[NURDServer]]. On the new [[NURDServices]] we're going serious with LDAP.
We are currently running on [[Network/Roadmap/LDAPAuthentication|FreeIPA]].


= Status =
= Connected machines and services =
Slapd and [http://fusiondirectory.org FusionDirectory] are running on [[NURDServices]]. FusionDirectory can be accessed on https://ldap.nurdspace.nl.


= Connected machines and services =
== Virtual Machines ==
* [[Hp_dc5800_sinterklaas|Sinterklaas]]
* [[Dell_Optiplex_GX270|Vjdeb]]
* [[PrinterPC]]
* [[NURDServices]] (only users in group "admins" can log in)
* [[Proxmox1]] (for fixing homedir ownership, only users in group "admins" can actually log in)
* [[Tankstation]]
* [[Sun_Ultra_1|plankton]]
* [[Spacenet]]
* [[Wiki]]
* [[BPM_Studio_Jukebox|BPM_Studio_Jukebox (all-in-one hark)]]


== Workstations ==
You can use the following systems by logging into them using your LDAP account. These systems are only available when you are connected to the space network, or you have a working VPN tunnel to the space. Note that you need to be part of the BOFH group to gain root access. If you need root, ask someone from the BOFH team to see whats possible.
The workstations listed above are set up as follows:
* Homedirs mounted over NFS from [[Proxmox1]] (except user 'printer' on [[PrinterPC]])
* Users in the LDAP 'sudo' group can sudo.
* Homedirs are created on the NFS-export when adding a user to LDAP ([http://documentation.fusiondirectory.org/en/documentation_faq/command_after like this])


=== Setting up other workstations in this way ===
* services-1.lan.nurd.space
To get this to work you need to:
* services-2.lan.nurd.space
* create all local users in LDAP (if they don't exist already)
* gitlab.vm.nurd.space
* delete local users (optional)
* minio.vm.nurd.space
* move homedirs to nurdservices (fix ownership because LDAP-users have a different UID)
* navi.vm.nurd.space
* delete local homedirs
* gh-runner-almalinux.vm.nurd.space
* mount /home from proxmox1:/mnt/md0/homedirs over nfs (put it in /etc/fstab)
* gh-runner-debian.vm.nurd.space
* put https://www.sslcertificaten.nl/files/PositiveSSLCA2.crt in /etc/ssl/certs/ with permissions 644
* install [http://wiki.debian.org/LDAP/NSS#NSS_Setup_with_libnss-ldapd libnss-ldapd] (see below for settings asked during installation, in the selection list check passwd, group and shadow)
* install libpam-ldapd (see below for settings asked during installation)
* the installation of libnss-ldap and libpam-ldap don't offer all required settings, so fix nslcd.conf and pam_ldap.conf to mention at least the following:
uri ldaps://ldap.nurdspace.nl/
base dc=nurdspace,dc=lan
binddn cn=read-user,ou=systems,dc=nurdspace,dc=lan
bindpw (obtain from other machine)
ssl on
tls_reqcert demand
tls_cacertfile /etc/ssl/certs/PositiveSSLCA2.crt
* restart nslcd
* check if ldap users are listed when you run "getent passwd"
* sudo might not work until you type 'id' which is [http://wiki.debian.org/LDAP/PAM kind of a mystery]


Useful reading: http://www.debian-administration.org/article/OpenLDAP_installation_on_Debian
All machines are deployed using a combination of OpenTOFU, cloud-init and Ansible via an CI/CD pipeline running on Gitlab. Configuration is done via GIT. If you need a machine for any purpose, ask the BOFH team.


In certain cases sudo can break. This can be fixed with [http://osdir.com/ml/general/2013-01/msg44182.html a patch] while it's not fixed properly.
TODO: Make this available for members without BOFH being involved.


== Wiki ==
== Wiki ==
* Port 636 (ldaps) is [[Cisco800series#Port_forwarding_howto|forwarded]] to [[NURDServices]] for usage by the [[Wiki]].
Authentication on this wiki is done via SAML using a combination of SimpleSAML and Keycloak. Keycloak uses LDAP as an identity source.
* [http://www.mediawiki.org/wiki/Extension:LDAP_Authentication Extension:LDAP_Authentication] is installed on the Wiki
* Users in the group 'wikiusers' can log in. Admins, bureaucrats and sysops are locally managed.
* Full addition to LocalSettings.php:
 
require_once( "$IP/extensions/LdapAuthentication/LdapAuthentication.php" );
$wgAuth = new LdapAuthenticationPlugin();
$wgLDAPDomainNames = array( 'nurdspace.lan', );
$wgLDAPServerNames = array( 'nurdspace.lan' => 'ldap.nurdspace.nl', );
$wgLDAPUseLocal = false;
$wgLDAPEncryptionType = array( 'nurdspace.lan' => 'ssl', );
$wgLDAPSearchStrings = array( 'nurdspace.lan' => 'uid=USER-NAME,ou=people,dc=nurdspace,dc=lan', );
$wgLDAPLowerCaseUsername = array( 'nurdspace.lan' => true );
$wgLDAPRequiredGroups = array( 'nurdspace.lan' => array( 'cn=wikiusers,ou=groups,dc=nurdspace,dc=lan', ) );
$wgLDAPGroupUseFullDN = array( "nurdspace.lan"=>false );
$wgLDAPGroupObjectclass = array( "nurdspace.lan"=>"posixGroup" );
$wgLDAPGroupAttribute = array( "nurdspace.lan"=>"memberUid" );
$wgLDAPGroupSearchNestedGroups = array( "nurdspace.lan"=>false );
$wgLDAPGroupNameAttribute = array( "nurdspace.lan"=>"cn" );
$wgLDAPBaseDNs = array( "nurdspace.lan"=>"dc=nurdspace,dc=lan" );
$wgLDAPUseLDAPGroups = array( "nurdspace.lan"=>true );
$wgGroupPermissions['wikiusers']['edit'] = true;
$wgGroupPermissions['admins'] = $wgGroupPermissions['sysop'];
# This hook is called by the LdapAuthentication plugin. It is a configuration hook. Here we
# are specifying what attibute we want to use for a username in the wiki.
# Note that this hook is NOT called on a straight bind.
# The hook calls the function defined below.
$wgHooks['SetUsernameAttributeFromLDAP'][] = 'SetUsernameAttribute';
 
Some settings might not be necessary, such as the wgGroupPermissions and wgHooks. I'll do some experimenting to see if it can be cleaned up.
 
=== Limitations ===
* The mediawiki login system converts the first character of usernames to uppercase due to [http://en.wikipedia.org/wiki/Wikipedia:Naming_conventions_(technical_restrictions)#Restrictions_on_usernames restrictions on usernames]. To get around this we've enabled [http://www.mediawiki.org/wiki/Extension:LDAP_Authentication/Changelog#v2.0a $wgLDAPLowercaseUsernameScheme]. This requires usernames to be all lowercase in the LDAP.
* Users are maintained through the LDAP, so creating a user on the Wiki is no longer possible. It could be enabled, but that would require adding a user with write-access in the LDAP. That seems a little scary for now. It would however offer the possibility of changing your LDAP password through the Wiki.


== Wifi ==
== Gitlab ==
The LDAP serves as a userdb for [[Spacenet]], which is connected via FreeRADIUS. For full details see the [[Spacenet]]-page.
See [[Network/Roadmap/MigrateToGitlab|our Gitlab instance]]


= Future plans =
== Wifi (Spacenet) ==
The most important machines and services are now hooked up to the LDAP. However, there's always room for more.
TODO: Is broken as of now


== More groups for different purposes ==
== DHCP ==
We should create more groups for specific purposes, such as:
See the [[Network|network page]].
* Workstation users (now only sudo'ers are treated separately)
* Separate group per workstation? Or some sort of hierarchy of groups, so members need only be in 1 group?
* <s>Spacenet users</s> done


== (Un)locking the front door ==
== (Un)locking the front door ==
See [[Spacelock]].
See the [[Network/Services/DoorLock|Door lock page]].
 
== Member registration ==
Currently the users in group "members" are maintained by hand. A little more automation would be appropriate. Hooking it up to actual money transactions might be far-fetched, but maybe something else is possible.
 
== E-mail and contacts services ==
We could install Zimbra or Zarafa, or maybe some smaller services to provide e-mail accounts, mailinglist functionality and maybe a CardDAV services for members.
 
== Make use of more of FusionDirectory's features ==
FusionDirectory has [http://documentation.fusiondirectory.org/en/documentation/available_plugins features/plugins] for applications, mime-types, workstations, object groups, public key authentication. Maybe some of these could be useful?
* Systems plugin installed and working, so we can now list all systems (workstations, servers) in the LDAP
* Wake-on-lan not working yet, probably due to a bug in argonaut
* Maybe maintain the internal DNS with [http://documentation.fusiondirectory.org/en/documentation/plugin/dns_plugin/how_to_setup_dns_plugin_1.0.5 this plugin]?
* [http://documentation.fusiondirectory.org/en/documentation/plugin/dhcp_plugin/how_to_setup_dhcp_plugin_1.0.5 DHCP plugin] installed, configged and working
 
== SAML ==
There's already a [https://spacefed.net/wiki/index.php/Spacesaml SpaceSAML] project, but until this is fully operational we can set up our own construction. This would require setting up an Identity Provider service (such as [http://shibboleth.net/products/identity-provider.html Shibboleth IdP]) and [http://www.mediawiki.org/wiki/Extension:SAMLAuth hooking up the Wiki] to that.
 
== Wiki ==
* Create ACL for a wiki service account that can create (and edit?) users
* Config said account in the wiki so it's used for creating users
 
== Misc ==
* Investigate possibility of moving to a different database back-end ([http://www.openldap.org/faq/data/cache/978.html back-sql])
* Exclude weak ciphers from olcTLSCipherSuite in cn=config
* Setting "change password on first login" in FusionDirectory doesn't get enforced through PAM
* Upgrade FusionDirectory from 1.0.5 to [http://fusiondirectory.org/basic/press#fd-1.0.6 1.0.6]
* Maintain [http://nurdspace.nl/Category:Members Members] page from LDAP ([http://www.mediawiki.org/wiki/Extension:External_Data#.23get_ldap_data_-_retrieve_data_from_LDAP_directory Like so], but this only displays 1 entry. Could be fixed [http://www.mediawiki.org/wiki/Extension_talk:External_Data/Archive_2012#.23for_external_table_support_for_.23get_ldap_data like so].)
* Check if the passwordmailer on FusionDirectory works
* Check out [http://www.lichteblau.com/ldapvi/manual/ ldapvi]

Latest revision as of 21:48, 6 September 2024

LDAP
NoPicture.png
Participants Fwd
Skills Linux, FreeIPA
Status Implemented
Niche Software
Purpose Infrastructure
Tool Yes
Location
Cost
Tool category

LDAP Property "Tool Image" (as page type) with input value "File:{{{Picture}}}" contains invalid characters or is incomplete and therefore can cause unexpected results during a query or annotation process. {{{Picture}}} {{#if:Yes | [[Tool Owner::{{{ProjectParticipants}}} | }} {{#if:Yes | [[Tool Cost::{{{Cost}}} | }}

Status

We are currently running on FreeIPA.

Connected machines and services

Virtual Machines

You can use the following systems by logging into them using your LDAP account. These systems are only available when you are connected to the space network, or you have a working VPN tunnel to the space. Note that you need to be part of the BOFH group to gain root access. If you need root, ask someone from the BOFH team to see whats possible.

  • services-1.lan.nurd.space
  • services-2.lan.nurd.space
  • gitlab.vm.nurd.space
  • minio.vm.nurd.space
  • navi.vm.nurd.space
  • gh-runner-almalinux.vm.nurd.space
  • gh-runner-debian.vm.nurd.space

All machines are deployed using a combination of OpenTOFU, cloud-init and Ansible via an CI/CD pipeline running on Gitlab. Configuration is done via GIT. If you need a machine for any purpose, ask the BOFH team.

TODO: Make this available for members without BOFH being involved.

Wiki

Authentication on this wiki is done via SAML using a combination of SimpleSAML and Keycloak. Keycloak uses LDAP as an identity source.

Gitlab

See our Gitlab instance

Wifi (Spacenet)

TODO: Is broken as of now

DHCP

See the network page.

(Un)locking the front door

See the Door lock page.