ns_perm

Overview

Add users, groups, and permissions

Syntax

ns_perm adduser name encpass userfield ?-allow | -deny host ...?

ns_perm addgroup name user ?user ...?

ns_perm allowuser ?-noinherit? method url user

ns_perm denyuser ?-noinherit? method url user

ns_perm allowgroup ?-noinherit? method url group

ns_perm denygroup ?-noinherit? method url group

ns_perm checkpass user passwd

ns_perm setpass user encpass

Description

Note: To use this function after server startup, the SkipLocks parameter (see page 69 in the AOLserver Administrator's Guide) must be set to On.

ns_perm adduser adds the user with the specified name and the encrypted password (encpass) and the specified user text (userfield) into the users database.

If -allow and hostnames are specified, the user will be allowed on the specified hostnames. If -deny and hostnames are specified, the user will be denied on the specified hostnames. The hostname must be specified as ipaddress/netmask or dnshostname. For example: 128.2.142.0/255.255.255.0 or www.microsoft.com or .microsoft.com.

ns_perm addgroup creates a new group with the specified name that includes the users listed after the name.

ns_perm allowuser allows the specified user access to the specified method and URL combination. If -noinherit is specified, only access to the exact URL is allowed; otherwise, URLs under that URL are allowed as well.

ns_perm denyuser denies the specified user access to the specified method and URL combination. If -noinherit is specified, only access to the exact URL is denied; otherwise, URLs under that URL are denied as well.

ns_perm allowgroup allows the specified group access to the specified method and URL combination. If -noinherit is specified, only access to the exact URL is allowed; otherwise, URLs under that URL are allowed as well.

ns_perm denygroup denies the specified group access to the specified method and URL combination. If -noinherit is specified, only access to the exact URL is denied; otherwise, URLs under that URL are denied as well.

ns_perm checkpass checks that the specified plain-text password is correct for the specified user. A Tcl error is thrown if it does not match.

ns_perm setpass updates the specified user's password to the encrypted password encpass. The password should be encrypted using ns_encrypt.