https://github.com/alerque/diradm
a simple bash script for managing posix users and groups stored in a LDAP directory
https://github.com/alerque/diradm
Last synced: over 1 year ago
JSON representation
a simple bash script for managing posix users and groups stored in a LDAP directory
- Host: GitHub
- URL: https://github.com/alerque/diradm
- Owner: alerque
- License: gpl-2.0
- Created: 2014-03-15T21:43:03.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2014-03-15T22:27:16.000Z (over 12 years ago)
- Last Synced: 2025-01-05T15:36:26.278Z (over 1 year ago)
- Language: Shell
- Size: 141 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README
- Changelog: CHANGES
- License: COPYING
Awesome Lists containing this project
README
DIRADM README
=============
What is diradm?
---------------
diradm is a simple bash script for managing posix users and groups stored
in a LDAP directory, offering the same features as the traditional passwd
file utilities useradd/usermod/userdel and groupadd/groupmod/groupdel.
It uses the utils ldapsearch, ldapadd, ldapmodify and ldapdelete from the
OpenLDAP project (http://www.openldap.org/) to perform the needed queries
against the LDAP database.
Installation
------------
Just copy the script itself (diradm) to a location you want it to reside
(usually /usr/local/sbin or somewhere else within your path), then take a
look at the configuration file (diradm.conf), adjust it to your needs and
copy it to an appropriate location as well.
By default diradm will search for its config at /etc/diradm.conf, but its
behaviour can be changed by editing the script and adjusting the variable
CONFIG.
How do I use it?
----------------
If you know the usage of the traditional password file maintainance tools
useradd/usermod/userdel and groupadd/groupmod/groupdel, you are ready to
use diradm. Its first command line parameter tells it which operation to
perform, taking exactly the same options as its "flat file equivalent".
E.g. "diradm useradd -m -c "Testuser" -g group1 -G group2,group3 testusr"
For further information on these command line options please take a look
at the man pages of useradd/usermod/userdel & groupadd/groupmod/groupdel.
The are two additional parameters in comparison to the traditional passwd
tools. One of them is "-h", which you can use to set the "host" attribute
of a user. This attribute can be used by pam_ldap to determine wether the
user has access to a system. The usage is the same as for "-G" (groups).
The other one is "-n" (only for useradd), which reverses the value of the
variable USERGROUPS in the configuration file. If this variable is set to
"yes", a group with the same name as the user (and, if possible, same ID
number) will be created by useradd. The variable also enables userdel to
remove user groups if no members exist. If USERGROUPS is unset, "no" is
assumed.
Bug reports
-----------
If you should find a bug, please send a report to .
Copyright
---------
Copyright (C) 2003-2004 Daniel Himler
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA