LCMAPS_LDAP_ENF.MOD(8)

πŸ’– lcmaps_ldap_enf.mod β€” it's giving "manual page, but make it cute" ✨

okay bestie, welcome to the LCMAPS_LDAP_ENF.MOD(8) page, living in the System Manager's Manual section. this one is a whole vibe: it's the LCMAPS plugin that goes into your LDAP directory and updates stuff. let's get into it πŸ¦‹


🌸 NAME 🌸

lcmaps_ldap_enf.mod β€” the LCMAPS plugin that updates ldap based on your credentials, no cap πŸ’…


✨ SYNOPSIS ✨

lcmaps_ldap_enf.mod -maxuid maxuid -maxpgid maxpgid -maxsgid maxsgid
-hostname hostname -port port [-require_all_groups {yes|no}] -dn_manager
DN -ldap_pw filename -sb_groups searchbase -sb_user searchbase -timeout
seconds

okay so look at that synopsis, it's a lot, but we're gonna walk through every single flag together, don't even worry 🫢


πŸŽ€ DESCRIPTION πŸŽ€

so the Ldap enforcement plugin will alter the user and group settings in the ldap database, using the user and group settings that the credential acquisition plugins handed over. that's the whole job, that's the main character energy right there πŸ‘‘

⚠️ note this, bestie, it's important: LDAP has to be used as the source of account information for PAM or NSS, and it has to be RFC 2307 compliant. no exceptions, periodt.

πŸ’… OPTIONS πŸ’…

okay here's the full roster, every single one, we're not skipping anybody:

  • -maxuid maxuid β€” the maximum number of uids that can be used. and listen, it is strongly advised to set this to 1. like, seriously. do it. πŸ™ˆ
  • -maxpgid maxpgid β€” the maximum number of primary gids that can be used.
  • -maxsgid maxsgid β€” the maximum number of (secondary) gids that can be used, and no, the primary group does not count in this one. advised value? 1. iconic. ✨
  • -hostname hostname β€” the hostname where the LDAP server is chillin', like asen.nikhef.nl
  • -port port β€” the port number you connect to, like 389
  • -require_all_groups {yes|no} β€” tells you whether all the groups that the PluginManager set shall be used. default is 'yes' πŸ’œ
  • -dn_manager DN β€” the DN of the LDAP manager, like "cn=Manager,dc=root"
  • -ldap_pw filename β€” the path to the file holding the LDAP manager's password.
😭 okay this one is a whole thing: the mode of the password file must be read-only for root (400), otherwise the plugin will not run. not even a little bit. so chmod accordingly, bestie.
  • -sb_groups searchbase β€” the search base for the (secondary) groups, like "ou=LocalGroups, dc=example, dc=com"
  • -sb_user searchbase β€” the search base for the user, like "ou=LocalUsers, dc=example, dc=com"
  • -timeout timeout value β€” the timeout, in seconds, that gets applied to the ldap binding ⏳

🌈 RETURN VALUE 🌈

  • LCMAPS_MOD_SUCCESS β€” success!! we ate πŸ’…πŸŽ‰
  • LCMAPS_MOD_FAIL β€” failure. it's giving pain πŸ’€

πŸ¦‹ BUGS πŸ¦‹

found a bug? please report any errors to the Nikhef Grid Middleware Security Team <grid-mw-security-support@nikhef.nl>. they wanna hear about it, fr fr 🫢


πŸ”₯ SEE ALSO πŸ”₯

lcmaps.db(5), lcmaps(3), ldap(3). go read those too, iykyk πŸ“š


πŸ‘‘ AUTHORS πŸ‘‘

LCMAPS and the LCMAPS plug-ins were written by the Grid Middleware Security Team <grid-mw-security@nikhef.nl>. legends, honestly. πŸ’–


and that's the whole page, bestie!! πŸŽ€ this little gem lives in the System Manager's Manual, and the version you're reading is dated March 22, 2011. go forth and enforce that ldap, you've got this πŸŒΈπŸ’…βœ¨