com.ibm.security.userregistry
Interface SecAdmin

All Known Implementing Classes:
RACF_SecAdmin

public interface SecAdmin

Interface for security administration of users and groups.


Method Summary
 UserGroup createGroup(String groupname, BasicAttributes input_at)
          Creates a new group in security repository with specified attributes
 User createUser(String username, BasicAttributes input_at)
          Creates a new user in security repository with specified attributes
 void deleteGroup(String groupname)
          Deletes existing group from security repository
 void deleteUser(String username)
          Deletes existing user from security repository
 UserGroup getGroup(String groupname)
          Gets UserGroup object for an existing group
 User getUser(String username)
          Gets User object for an existing user
 void modifyGroup(String groupname, ModificationItem[] mods)
          changes, adds or deletes attributes of an existing group
 void modifyUser(String username, ModificationItem[] mods)
          changes, adds or deletes attributes of an existing user
 

Method Detail

createGroup

public UserGroup createGroup(String groupname,
                             BasicAttributes input_at)
                      throws SecAdminException
Creates a new group in security repository with specified attributes

Parameters:
groupname - Identifier for group, such as: name, dn, group id
input_at - Attributes of group, such as: owner, gid
Returns:
UserGroup object for new group
Throws:
SecAdminException

createUser

public User createUser(String username,
                       BasicAttributes input_at)
                throws SecAdminException
Creates a new user in security repository with specified attributes

Parameters:
username - String to represent user, such as: userid, dn
input_at - Attributes of user, such as: email address, full name, account number. Can be null.
Returns:
User object for new user
Throws:
SecAdminException

deleteGroup

public void deleteGroup(String groupname)
                 throws SecAdminException
Deletes existing group from security repository

Parameters:
groupname - Identifier for group, such as: name, dn, group id
Throws:
SecAdminException

deleteUser

public void deleteUser(String username)
                throws SecAdminException
Deletes existing user from security repository

Parameters:
username - String to represent user, such as: userid, dn
Throws:
SecAdminException

getGroup

public UserGroup getGroup(String groupname)
                   throws SecAdminException
Gets UserGroup object for an existing group

Parameters:
groupname - String to represent group, such as: name of group, dn
Returns:
UserGroup object
Throws:
SecAdminException

getUser

public User getUser(String username)
             throws SecAdminException
Gets User object for an existing user

Parameters:
username - String to represent user, such as: userid, dn
Returns:
User object
Throws:
SecAdminException

modifyGroup

public void modifyGroup(String groupname,
                        ModificationItem[] mods)
                 throws SecAdminException
changes, adds or deletes attributes of an existing group

Parameters:
groupname - Identifier for group, such as: name, dn, group id
mods - Array of modifications (each modification could be deleting, changing the value of, or adding an attribute)
Throws:
SecAdminException

modifyUser

public void modifyUser(String username,
                       ModificationItem[] mods)
                throws SecAdminException
changes, adds or deletes attributes of an existing user

Parameters:
username - String to represent user, such as: userid, dn
mods - Array of modifications (each modification could be deleting, changing the value of, or adding an attribute)
Throws:
SecAdminException