Re: create_user, what goes into %user?

[Jamie C. <jca...@we...>]

Joe Cooper wrote:
> 
> Quick query,
> 
> What /needs/ to be in %user when using the &create_user function from
> useradmin?
> 
> Here's the situation, I want to create a user from a template, with only
> a username selected by the admin at creation time.  The template will be
> hardcoded at first, but soon replaced by module config options or some
> other interactive setup method.  But, it will not be specific to each
> user.  I'd like to accomplish the following:
> 
> Insert the name which is being chosen at create time
> 
> Create a random password which is encrypted using the standard Red Hat
> PAM method -- (I'll probably also add a field for entering an optional
> password later)
> 
> Select the next available user ID (I think I've successfully pulled this
> mostly unaltered from the edit_user.cgi section)
> 
> Set everything else to 'defaults' as defined in the template
> 
> I'm already successfully creating the new user's home directory, and I
> think I can figure out adding ACLs for the user for Webmin (haven't
> tried to tackle adding a Webmin user yet).
> 
> What I'm trying to figure out is, what needs to be specified in the
> %user hash when calling create_user?  As I mentioned, the details of the
> user will not be chosen on a per-user basis so I definitely don't need
> all the funny bits being checked and configured in useradmin, but I want
> to make sure I'm creating a functional and completely defined user.

The hash keys that need to be in %user are :

user	- The username
pass	- The encrypted password (you should call encrypt_password to generate this)
uid	- The user's UID
gid	- The GID of the user's primary group
real	- The user's real name
home	- Home directory
shell	- The user's shell

In addition, if your system supports the shadow password file you also set the following
keys if you want (if not, they will just be left empty which is the default)

change	- Days since 1st jan 1970 that password was changed
min	- Days before password may be changed
max	- Days after which password must be changed
warn	- Days before password is to expire that user is warned
inactive- The number of days of inactivity allowed for the user
expire	- Days since Jan 1, 1970 that account is disabled

 - Jamie