jet.server.api.admin
Interface SecurityAdminService

public interface SecurityAdminService

Interface SecurityAdminService provide methods to manage security resource in report server.

Since:

5.0

Method Summary

java.lang.String	addAcl(java.lang.String realmName, java.lang.String aclName, java.lang.String submitter) Deprecated. This method was not effective since V6.
java.lang.String	addGroup(java.lang.String realmName, java.lang.String groupName, java.lang.String description, java.lang.String submitter) Add a new group into the realm.
java.lang.String	addGroupIntoRole(java.lang.String realmName, java.lang.String submitter, java.lang.String groupName, java.lang.String roleName) add a group to role as a memeber
java.lang.String	addMemberIntoAcl(java.lang.String realmName, java.lang.String aclName, java.lang.String memberName, java.lang.String submitter) Deprecated. This method was not effective since V6.
java.lang.String	addMemberIntoGroup(java.lang.String realmName, java.lang.String groupName, java.lang.String memberName, java.lang.String submitter) Deprecated. This method was not effective since V6.
java.lang.String	addNewParentRolesToUser(java.lang.String realmName, java.lang.String submitter, java.lang.String userName, java.lang.String roleName) Add some new parent role to a user.
java.lang.String	addPrivilegedGroups(java.lang.String realmName, java.lang.String submitter, java.lang.String privilege, java.util.Vector groups) add roles to have this privilege
java.lang.String	addPrivilegedRoles(java.lang.String realmName, java.lang.String submitter, java.lang.String privilege, java.util.Vector roles) add roles to have this privilege
void	addPrivilegedRoles(java.lang.String privilege, java.util.Vector roles) Deprecated. Server V7.1 eplaced by addPrivilegedRoles(String realmName, String submitter, String privilege, Vector groups) throws NoSuchGroupException, NoSuchRealmException, BadRealmException;.
java.lang.String	addPrivilegedUsers(java.lang.String realmName, java.lang.String submitter, java.lang.String privilege, java.util.Vector users) add users to have this privilege
void	addPrivilegedUsers(java.lang.String privilege, java.util.Vector users) Deprecated. Server V7.1 replaced by addPrivilegedUsers(String realmName, String submitter, String privilege, Vector users) throws NoSuchUserException, NoSuchRealmException;.
java.lang.String	addProtection(java.lang.String realmName, java.lang.String resourcePath, java.lang.String aclName, java.lang.String submitter) Deprecated. This method was not effective since V6.
java.lang.String	addRealm(java.lang.String realmName, java.lang.String submitter, int scheme) Add a new realm specified by realmName.
java.lang.String	addRole(java.lang.String realmName, java.lang.String roleName, java.lang.String description, java.lang.String submitter) Add a new role into the realm.
java.lang.String	addRole(java.lang.String realmName, java.lang.String roleName, java.lang.String description, java.lang.String parentRoleName, java.lang.String submitter) Deprecated. This method is not effective since V7.0 .
java.lang.String	addSubGroupIntoGroup(java.lang.String realmName, java.lang.String submitter, java.lang.String subGroupName, java.lang.String groupName) add a group into a group as sub group
java.lang.String	addSubRoleToRole(java.lang.String realmName, java.lang.String submitter, java.lang.String subRoleName, java.lang.String roleName) Add a sub role to a role
java.lang.String	addSubUserToRole(java.lang.String realmName, java.lang.String submitter, java.lang.String subUserName, java.lang.String roleName) Add a sub user to a role
java.lang.String	addUser(java.lang.String realmName, java.lang.String userName, java.lang.String password, java.lang.String fullName, java.lang.String description, java.lang.String email, boolean passNeverExpire, int passExpireTime, boolean passPermitBlank, int passMinLength, boolean disabledAccount, java.lang.String submitter) Deprecated. This method is not effective since V6.
java.lang.String	addUser(java.lang.String realmName, java.lang.String submitter, java.lang.String userName, java.lang.String password, java.lang.String fullName, java.lang.String description, java.lang.String email, boolean passNeverExpire, int passExpireTime, boolean passPermitBlank, int passMinLength, boolean disabledAccount) Add a new user into the realm.
java.lang.String	addUserIntoGroup(java.lang.String realmName, java.lang.String submitter, java.lang.String userName, java.lang.String groupName) Add a user into a group as sub user
java.lang.String	addUserIntoRole(java.lang.String realmName, java.lang.String roleName, java.lang.String userName, java.lang.String submitter) Add a user into a role.
java.lang.String	changePassword(java.lang.String realmName, java.lang.String userName, java.lang.String subPwd, java.lang.String newPwd, java.lang.String submitter) Change user password.
java.lang.String	editLDAPUser(java.lang.String realmName, java.lang.String userName, java.lang.String fullName, java.lang.String description, java.lang.String email, java.lang.String submitter) Edit the specified user.
java.lang.String	editProtection(java.lang.String realmName, java.lang.String resourcePath, java.lang.String aclName, java.lang.String submitter) Deprecated. This method was not effective since V6.
java.lang.String	editUser(java.lang.String realmName, java.lang.String userName, java.lang.String fullName, java.lang.String description, java.lang.String email, boolean passNeverExpire, int passExpireTime, boolean passPermitBlank, int passMinLength, boolean disabledAccount, java.lang.String submitter) Edit the specified user.
java.security.acl.Acl	getAcl(java.lang.String realmName, java.lang.String aclName) Deprecated. This method was not effective since V6.
java.util.Enumeration	getAclNames(java.lang.String realmName) Deprecated. This method was not effective since V6.
java.util.Enumeration	getAcls(java.lang.String realmName) Deprecated. This method was not effective since V6.
java.lang.String	getActiveRealm() Get the active Realm in JReport server.
java.util.Enumeration	getAllGroupNames(java.lang.String realmName) Get all group name list in the realm.
java.util.Enumeration	getAllGroups(java.lang.String realmName) Deprecated. This method was not effective since Server V6.0
java.util.Vector	getAllGroups(java.lang.String realmName, java.lang.String submitter) Get all group list in the realm.
java.util.Enumeration	getAllRealmNames() Get all realm name list in report server.
java.util.Vector	getAllRoleNames(java.lang.String realmName, java.lang.String submitter) Get all role name list in the realm.
java.util.Vector	getAllRoles(java.lang.String realmName, java.lang.String submitter) Get all role set in the realm.
java.util.Vector	getAllUser(java.lang.String realmName, java.lang.String submitter) Get all users set in the realm.
java.util.Enumeration	getAllUserNames(java.lang.String realmName) Get all user name list in the realm.
java.util.Enumeration	getAllUserNames(java.lang.String realmName, java.lang.String groupName) Deprecated. This method was not effective since Server V6.0
java.util.Enumeration	getAllUserNamesByRole(java.lang.String submitter, java.lang.String realmName, java.lang.String roleName) Get all user name list in the role.
java.lang.String	getCombinedAclName(java.lang.String realmName, java.lang.String resourcePath) Deprecated. This method was not effective since V6.
java.lang.String	getCurRealm() Get the current edit Realm in JReport server.
java.security.acl.Group	getGroup(java.lang.String realmName, java.lang.String groupName) Deprecated. This method was not effective since Server V6.0
Group	getGroupByName(java.lang.String realmName, java.lang.String submitter, java.lang.String groupName) Get a group specified by group name
int	getGroupMemberCount(java.lang.String realmName, java.lang.String groupName) Get member count in a group.
java.util.Vector	getGroupPrivileges(java.lang.String realmName, java.lang.String submitter, java.lang.String groupName) get user's privileges
java.util.Vector	getGroupsByRole(java.lang.String realmName, java.lang.String submitter, java.lang.String roleName) Get sub groups from the role
java.util.Vector	getGroupsByUser(java.lang.String realmName, java.lang.String submitter, java.lang.String userName) Get the groups which specifie user has
java.util.Vector	getParentRolesByUser(java.lang.String realmName, java.lang.String submitter, java.lang.String userName) Get roles which specific user has
java.util.Vector	getPrivilegedGroups(java.lang.String realmName, java.lang.String submitter, java.lang.String privilege) get all groups who have the privilege
java.util.Vector	getPrivilegedRoles(java.lang.String privilege) Deprecated. Server V7.1 replaced by getPrivilegedRoles(String realmName, String submitter, String privilege,) throws NoSuchRealmException;.
java.util.Vector	getPrivilegedRoles(java.lang.String realmName, java.lang.String submitter, java.lang.String privilege) get all roles who have the privilege
java.util.Vector	getPrivilegedUsers(java.lang.String privilege) Deprecated. Server V7.1 replaced by getPrivilegedUsers(String realmName, String submitter, String privilege,) throws NoSuchRealmException;.
java.util.Vector	getPrivilegedUsers(java.lang.String realmName, java.lang.String submitter, java.lang.String privilege) get all users who have the privilege
java.util.Enumeration	getProtections(java.lang.String realmName) Deprecated. This method is not effective since V6.
java.util.Vector	getReferRoles(java.lang.String realmName, java.lang.String userName)
java.util.Vector	getReferUsers(java.lang.String realmName, java.lang.String userName)
Role	getRole(java.lang.String submitter, java.lang.String realmName, java.lang.String roleName) Get a role specified by roleName.
int	getRoleMemberCount(java.lang.String realmName, java.lang.String roleName) Get member count in a role.
java.util.Vector	getRolePrivileges(java.lang.String roleName) Deprecated. Server V7.1 replaced by getRolePrivileges(String realmName, String submitter, String roleName,) throws NoSuchRoleException, NoSuchRealmException;.
java.util.Vector	getRolePrivileges(java.lang.String realmName, java.lang.String submitter, java.lang.String roleName) get user's privileges
java.util.Vector	getRolesByGroup(java.lang.String realmName, java.lang.String submitter, java.lang.String groupName) Get parent roles' names from the group
java.util.Vector	getSubGroupsByGroup(java.lang.String realmName, java.lang.String submitter, java.lang.String groupName) Get sub groups from the parent group
java.util.Vector	getSubRolesByRole(java.lang.String realmName, java.lang.String submitter, java.lang.String roleName) Get the set of a role's sub roles.
java.util.Vector	getSubUsersByRole(java.lang.String realmName, java.lang.String submitter, java.lang.String roleName) Get the set of a role's sub users
java.util.Vector	getSubUsersNameByRole(java.lang.String realmName, java.lang.String submitter, java.lang.String roleName) Get the set of a role's sub users' names
User	getUser(java.lang.String submitter, java.lang.String realmName, java.lang.String userName) Get a user
java.lang.String	getUserDescription(java.lang.String realmName, java.lang.String userName) Get user's description.
java.lang.String	getUserEmail(java.lang.String realmName, java.lang.String userName) Get user's email address.
java.lang.String	getUserFullname(java.lang.String realmName, java.lang.String userName) Get user's full name.
int	getUserParentGroupsCount(java.lang.String realmName, java.lang.String userName) Get the count if a user's parent groups count
int	getUserParentRolesCount(java.lang.String realmName, java.lang.String userName) Get the count if a user's parent roles' count
int	getUserPasswordExpireTime(java.lang.String realmName, java.lang.String userName) Get user password expire time
int	getUserPasswordMinLength(java.lang.String realmName, java.lang.String userName) Get user password minimum length.
java.util.Vector	getUserPrivileges(java.lang.String userName) Deprecated. Server V7.1 replaced by getUserPrivileges(String realmName, String submitter, String userName,) throws NoSuchUserException, NoSuchRealmException;.
java.util.Vector	getUserPrivileges(java.lang.String realmName, java.lang.String submitter, java.lang.String userName) get user's privileges
java.util.Vector	getUsersByGroup(java.lang.String realmName, java.lang.String submitter, java.lang.String groupName) Get users' names from the parent group
boolean	isAdminUser(java.lang.String userName) Check the user is adminisitrator or not
boolean	isAuditFileAccessFail(java.lang.String realmName, java.lang.String userName) Check if audit failing ACCESS event for the user.
boolean	isAuditFileAccessSuccess(java.lang.String realmName, java.lang.String userName) Check if audit successful ACCESS event for the user.
boolean	isAuditManageFail(java.lang.String realmName, java.lang.String userName) Check if audit failing MANAGE event for the user.
boolean	isAuditManageSuccess(java.lang.String realmName, java.lang.String userName) Check if audit successful MANAGE event for the user.
boolean	isNoAudit(java.lang.String realmName, java.lang.String userName) Check if does not audit any ACCESS or MANAGE event for the user.
boolean	isUserAccountDisable(java.lang.String realmName, java.lang.String userName) Check whether user account is disabled.
boolean	isUserPasswordNeverExpire(java.lang.String realmName, java.lang.String userName) Check if user password is never expire.
boolean	isUserPasswordPermitBlank(java.lang.String realmName, java.lang.String userName) Check if user password permit blank.
java.lang.String	removeAcl(java.lang.String realmName, java.lang.String aclName, java.lang.String submitter) Deprecated. This method was not effective since V6.
java.lang.String	removeGroup(java.lang.String realmName, java.lang.String groupName, java.lang.String submitter) Remove a group from the realm.
java.lang.String	removeGroupFromRole(java.lang.String realmName, java.lang.String submitter, java.lang.String groupName, java.lang.String roleName) remove a group from the role
java.lang.String	removeMemberFromAcl(java.lang.String realmName, java.lang.String aclName, java.lang.String memberName, java.lang.String submitter) Deprecated. This method was not effective since V6.
java.lang.String	removeMemberFromGroup(java.lang.String realmName, java.lang.String groupName, java.lang.String memberName, java.lang.String submitter) Deprecated. This method was not effective since V6.
java.lang.String	removeParentRolesFromUser(java.lang.String realmName, java.lang.String submitter, java.lang.String userName, java.lang.String roleName) Remove a parent role from a user
java.lang.String	removePrivilegedGroups(java.lang.String realmName, java.lang.String submitter, java.lang.String privilege, java.util.Vector groups) remove groups from groups who have the privilege
java.lang.String	removePrivilegedRoles(java.lang.String realmName, java.lang.String submitter, java.lang.String privilege, java.util.Vector roles) remove roles from roles who have the privilege
java.lang.String	removePrivilegedRoles(java.lang.String privilege, java.util.Vector roles) Deprecated. Server V7.1 replaced by removePrivilegedRoles(String realmName, String submitter, String privilege, Vector roles) throws NoSuchRoleException, NoSuchRealmException;.
java.lang.String	removePrivilegedUsers(java.lang.String realmName, java.lang.String submitter, java.lang.String privilege, java.util.Vector users) remove users from users who have the privilege
java.lang.String	removePrivilegedUsers(java.lang.String privilege, java.util.Vector users) Deprecated. Server V7.1 replaced by removePrivilegedUsers(String realmName, String submitter, String privilege, Vector users) throws NoSuchUserException, NoSuchRealmException;.
java.lang.String	removeProtection(java.lang.String realmName, java.lang.String resourcePath, java.lang.String submitter) Deprecated. This method was not effective since V6.
java.lang.String	removeRealm(java.lang.String realmName, java.lang.String submitter) Remove a realm spcified by realmName.
java.lang.String	removeRole(java.lang.String realmName, java.lang.String roleName, java.lang.String submitter) Remove a role from the realm.
java.lang.String	removeRoleFromParentRole(java.lang.String submitter, java.lang.String realmName, java.lang.String roleName, java.lang.String parentRoleName) Remove a role from a parent role
java.lang.String	removeSubGroupFromGroup(java.lang.String realmName, java.lang.String submitter, java.lang.String subGroupName, java.lang.String groupName) remove a sub group from the group
java.lang.String	removeUser(java.lang.String realmName, java.lang.String userName, java.lang.String submitter) Remove a user from the realm.
java.lang.String	removeUserFromGroup(java.lang.String realmName, java.lang.String submitter, java.lang.String userName, java.lang.String groupName) remove a user from the group
java.lang.String	removeUserFromParentRole(java.lang.String submitter, java.lang.String realmName, java.lang.String userName, java.lang.String parentRoleName) Remove a user from a parent role
java.lang.String	removeUserFromRole(java.lang.String realmName, java.lang.String roleName, java.lang.String userName, java.lang.String submitter) Deprecated. This method was not effective since Server V7.0
java.lang.String	setAuditFileAccessFail(java.lang.String realmName, java.lang.String userName, boolean b, java.lang.String submitter) Set whether audit failing ACCESS actions for the user.
java.lang.String	setAuditFileAccessSuccess(java.lang.String realmName, java.lang.String userName, boolean b, java.lang.String submitter) Set whether audit successful ACCESS actions for the user.
java.lang.String	setAuditManageFail(java.lang.String realmName, java.lang.String userName, boolean b, java.lang.String submitter) Set whether audit failing MANAGE actions for the user.
java.lang.String	setAuditManageSuccess(java.lang.String realmName, java.lang.String userName, boolean b, java.lang.String submitter) Set whether audit successful MANAGE actions for the user.
void	setCurRealm(java.lang.String realm) Set the current edit Realm in JReport server.
java.lang.String	setGroupPrivileges(java.lang.String realmName, java.lang.String submitter, java.lang.String groupName, java.util.Vector privileges) set privileges for group
java.lang.String	setMemberPermissions(java.lang.String realmName, java.lang.String aclName, java.lang.String memberName, java.util.Vector permissions, boolean isNegative, java.lang.String submitter) Deprecated. This method was not effective since V6.
java.lang.String	setNoAudit(java.lang.String realmName, java.lang.String userName, boolean b, java.lang.String submitter) Set whether no event to be audited for the user.
java.lang.String	setRolePrivileges(java.lang.String realmName, java.lang.String submitter, java.lang.String roleName, java.util.Vector privileges) set privileges for role
void	setRolePrivileges(java.lang.String roleName, java.util.Vector privileges) Deprecated. Server V7.1 replaced by setRolePrivileges(String realmName, String submitter, String roleName, Vector privileges) throws NoSuchRoleException, NoSuchRealmException;.
java.lang.String	setUserPrivileges(java.lang.String realmName, java.lang.String submitter, java.lang.String userName, java.util.Vector privileges) set privileges for user
void	setUserPrivileges(java.lang.String userName, java.util.Vector privileges) Deprecated. Server V7.1 replaced by setUserPrivileges(String realmName, String submitter, String userName, Vector privileges) throws NoSuchUserException, NoSuchRealmException;.

Method Detail

getCurRealm

public java.lang.String getCurRealm()

Get the current edit Realm in JReport server.

setCurRealm

public void setCurRealm(java.lang.String realm)

Set the current edit Realm in JReport server.

getActiveRealm

public java.lang.String getActiveRealm()

Get the active Realm in JReport server.

getAllRealmNames

public java.util.Enumeration getAllRealmNames()

Get all realm name list in report server.

Returns:

the enumeration represent all realm name list.

Since:

addRealm

public java.lang.String addRealm(java.lang.String realmName,
                                 java.lang.String submitter,
                                 int scheme)
                          throws NoSuchRealmException,
                                 BadRealmException,
                                 NoSuchAclException,
                                 java.security.acl.NotOwnerException,
                                 NoSuchUserException,
                                 InUseException

Add a new realm specified by realmName.

Parameters:

realmName - new realm name

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchAclException - if acl does not exist.

java.security.acl.NotOwnerException - if the Principal attempting the modification is not an owner.

NoSuchUserException - if user does not exist.

InUseException - if attempting to delete an object, such as a user or group, which is in use as part of the realm's security policy.

Since:

removeRealm

public java.lang.String removeRealm(java.lang.String realmName,
                                    java.lang.String submitter)

Remove a realm spcified by realmName.

Parameters:

realmName - new realm name

submitter - the user who request this action.

Returns:

error message if any error occurs, or null if success.

Since:

addGroup

public java.lang.String addGroup(java.lang.String realmName,
                                 java.lang.String groupName,
                                 java.lang.String description,
                                 java.lang.String submitter)
                          throws NoSuchRealmException,
                                 BadRealmException,
                                 NoSuchGroupException,
                                 InUseException,
                                 java.io.IOException

Add a new group into the realm.

Parameters:

realmName - the realm name

groupName - the new group name

description - the new group description

submitter - the user who request this action

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

InUseException - if attempting to delete an object, such as a user or group, which is in use as part of the realm's security policy.

java.io.IOException - if error occurs when try to save data.

Since:

server V7.1

removeGroup

public java.lang.String removeGroup(java.lang.String realmName,
                                    java.lang.String groupName,
                                    java.lang.String submitter)
                             throws NoSuchRealmException,
                                    BadRealmException,
                                    NoSuchGroupException,
                                    InUseException

Remove a group from the realm.

Parameters:

realmName - the realm name.

groupName - the new group name.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

InUseException - if attempting to delete an object, such as a user or group, which is in use as part of the realm's security policy.

Since:

server V7.1

getAllGroups

public java.util.Enumeration getAllGroups(java.lang.String realmName)
                                   throws NoSuchRealmException,
                                          BadRealmException

Deprecated. This method was not effective since Server V6.0

Get all group list in the realm.

Parameters:

realmName - the realm name.

Returns:

the enumeration represent all group list.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

getAllGroups

public java.util.Vector getAllGroups(java.lang.String realmName,
                                     java.lang.String submitter)
                              throws NoSuchRealmException,
                                     BadRealmException

Get all group list in the realm.

Parameters:

realmName - the realm name.

submitter - the user who request this action.

Returns:

the enumeration represent all group list.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

Since:

Server V7.1

getAllGroupNames

public java.util.Enumeration getAllGroupNames(java.lang.String realmName)
                                       throws NoSuchRealmException,
                                              BadRealmException

Get all group name list in the realm.

Parameters:

realmName - the realm name.

Returns:

the enumeration represent all group name list.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

Since:

server V7.1

getGroup

public java.security.acl.Group getGroup(java.lang.String realmName,
                                        java.lang.String groupName)
                                 throws NoSuchRealmException,
                                        BadRealmException,
                                        NoSuchGroupException

Deprecated. This method was not effective since Server V6.0

Get a group specified by groupName.

Parameters:

realmName - the realm name.

groupName - the group name.

Returns:

a Group that request.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

Since:

getGroupByName

public Group getGroupByName(java.lang.String realmName,
                            java.lang.String submitter,
                            java.lang.String groupName)
                     throws NoSuchRealmException,
                            BadRealmException,
                            NoSuchGroupException

Get a group specified by group name

Parameters:

realmName - the realm name

submitter - the user who request this action.

groupName - the group name

Returns:

a Group that request.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

Since:

server V7.1

getGroupMemberCount

public int getGroupMemberCount(java.lang.String realmName,
                               java.lang.String groupName)
                        throws NoSuchRealmException,
                               BadRealmException,
                               NoSuchGroupException

Get member count in a group.

Parameters:

realmName - the realm name.

groupName - the group name.

Returns:

the member count in specified group.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

Since:

server 7.1

addUserIntoGroup

public java.lang.String addUserIntoGroup(java.lang.String realmName,
                                         java.lang.String submitter,
                                         java.lang.String userName,
                                         java.lang.String groupName)
                                  throws NoSuchRealmException,
                                         BadRealmException,
                                         NoSuchGroupException,
                                         NoSuchUserException

Add a user into a group as sub user

Parameters:

realmName - the realm name

submitter - the user who request this action.

userName - the user name

groupName - the group name

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

NoSuchUserException - if user does not exist.

Since:

ServerV7.1

addSubGroupIntoGroup

public java.lang.String addSubGroupIntoGroup(java.lang.String realmName,
                                             java.lang.String submitter,
                                             java.lang.String subGroupName,
                                             java.lang.String groupName)
                                      throws NoSuchRealmException,
                                             BadRealmException,
                                             NoSuchGroupException

add a group into a group as sub group

Parameters:

realmName - the realm name

submitter - the user who request this action.

subGroupName - the sub group name

groupName - the group name

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

Since:

ServerV7.1

addGroupIntoRole

public java.lang.String addGroupIntoRole(java.lang.String realmName,
                                         java.lang.String submitter,
                                         java.lang.String groupName,
                                         java.lang.String roleName)
                                  throws NoSuchRealmException,
                                         BadRealmException,
                                         NoSuchGroupException,
                                         NoSuchRoleException

add a group to role as a memeber

Parameters:

realmName - the realm name

submitter - the user who request this action.

groupName - the group name

roleName - the role name

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

NoSuchRoleException - if role does not exist.

Since:

ServerV7.1

removeUserFromGroup

public java.lang.String removeUserFromGroup(java.lang.String realmName,
                                            java.lang.String submitter,
                                            java.lang.String userName,
                                            java.lang.String groupName)
                                     throws NoSuchRealmException,
                                            BadRealmException,
                                            NoSuchGroupException,
                                            NoSuchUserException

remove a user from the group

Parameters:

realmName - the realm name

submitter - the user who request this action.

userName - the user name

groupName - the group name

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

NoSuchUserException - if user does not exist.

Since:

ServerV7.1

removeSubGroupFromGroup

public java.lang.String removeSubGroupFromGroup(java.lang.String realmName,
                                                java.lang.String submitter,
                                                java.lang.String subGroupName,
                                                java.lang.String groupName)
                                         throws NoSuchRealmException,
                                                BadRealmException,
                                                NoSuchGroupException

remove a sub group from the group

Parameters:

realmName - the realm name

submitter - the user who request this action.

subGroupName - the sub group name

groupName - the group name

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

Since:

ServerV7.1

removeGroupFromRole

public java.lang.String removeGroupFromRole(java.lang.String realmName,
                                            java.lang.String submitter,
                                            java.lang.String groupName,
                                            java.lang.String roleName)
                                     throws NoSuchRealmException,
                                            BadRealmException,
                                            NoSuchGroupException,
                                            NoSuchRoleException

remove a group from the role

Parameters:

realmName - the realm name

submitter - the user who request this action.

groupName - the group name

roleName - the role name

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

NoSuchRoleException - if role does not exist.

Since:

ServerV7.1

getSubGroupsByGroup

public java.util.Vector getSubGroupsByGroup(java.lang.String realmName,
                                            java.lang.String submitter,
                                            java.lang.String groupName)
                                     throws NoSuchGroupException,
                                            NoSuchRealmException,
                                            BadRealmException

Get sub groups from the parent group

Parameters:

realmName - the realm name

submitter - the user who request this action.

groupName - the group name

Returns:

a Vector save the sub groups' names

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

Since:

ServerV7.1

getUsersByGroup

public java.util.Vector getUsersByGroup(java.lang.String realmName,
                                        java.lang.String submitter,
                                        java.lang.String groupName)
                                 throws NoSuchGroupException,
                                        NoSuchRealmException,
                                        BadRealmException

Get users' names from the parent group

Parameters:

realmName - the realm name

submitter - the user who request this action.

groupName - the group name

Returns:

a Vector save the sub users' names

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

Since:

ServerV7.1

getRolesByGroup

public java.util.Vector getRolesByGroup(java.lang.String realmName,
                                        java.lang.String submitter,
                                        java.lang.String groupName)
                                 throws NoSuchGroupException,
                                        NoSuchRealmException,
                                        BadRealmException

Get parent roles' names from the group

Parameters:

realmName - the realm name

submitter - the user who request this action.

groupName - the group name

Returns:

a Vector save the parent roles' names

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

Since:

ServerV7.1

getGroupsByRole

public java.util.Vector getGroupsByRole(java.lang.String realmName,
                                        java.lang.String submitter,
                                        java.lang.String roleName)
                                 throws NoSuchRoleException,
                                        NoSuchRealmException,
                                        BadRealmException

Get sub groups from the role

Parameters:

realmName - the realm name

submitter - the user who request this action.

roleName - the role name

Returns:

a Vector save the sub groups' names

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchRoleException - if role does not exist.

Since:

ServerV7.1

getUser

public User getUser(java.lang.String submitter,
                    java.lang.String realmName,
                    java.lang.String userName)
             throws NoSuchUserException,
                    NoSuchRealmException

Get a user

Parameters:

realmName - the realm name.

userName - the user name

Returns:

a User object

Throws:

NoSuchUserException - if there is no specific user in security manager.

NoSuchRealmException

Since:

V6

addUser

public java.lang.String addUser(java.lang.String realmName,
                                java.lang.String userName,
                                java.lang.String password,
                                java.lang.String fullName,
                                java.lang.String description,
                                java.lang.String email,
                                boolean passNeverExpire,
                                int passExpireTime,
                                boolean passPermitBlank,
                                int passMinLength,
                                boolean disabledAccount,
                                java.lang.String submitter)
                         throws NoSuchRealmException,
                                BadRealmException,
                                NoSuchUserException,
                                InUseException,
                                java.io.IOException

Deprecated. This method is not effective since V6.

Add a new user into the realm.

Parameters:

realmName - the realm name.

userName - the user name.

password - the new user password.

fullName - the new user full name.

description - the new user description.

email - the new user email.

passNeverExpire - whether the password can be expired, true if password is not expired.

passExpireTime - if passNeverExpire is false, represent after how long time password will be expired .

passPermitBlank - whether the password can be blank, true if blank is permited.

passMinLength - if password can not be blank, represent the password's minimum length.

disabledAccount - whether this user account can be used.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

InUseException - if attempting to delete an object, such as a user or group, which is in use as part of the realm's security policy.

java.io.IOException - if error occurs when try to save data.

Since:

addUser

public java.lang.String addUser(java.lang.String realmName,
                                java.lang.String submitter,
                                java.lang.String userName,
                                java.lang.String password,
                                java.lang.String fullName,
                                java.lang.String description,
                                java.lang.String email,
                                boolean passNeverExpire,
                                int passExpireTime,
                                boolean passPermitBlank,
                                int passMinLength,
                                boolean disabledAccount)
                         throws NoSuchRealmException,
                                UserExistException

Add a new user into the realm.

Parameters:

realmName - the realm name.

submitter - the user who request this action.

userName - the user name.

password - the new user password.

fullName - the new user full name.

description - the new user description.

email - the new user email.

passNeverExpire - whether the password can be expired, true if password is not expired.

passExpireTime - if passNeverExpire is false, represent after how long time password will be expired .

passPermitBlank - whether the password can be blank, true if blank is permited.

passMinLength - if password can not be blank, represent the password's minimum length.

disabledAccount - whether this user account can be used.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

UserExistException - if user specified by userName exist.

NoSuchRealmException

UserExistException

Since:

V6

removeUser

public java.lang.String removeUser(java.lang.String realmName,
                                   java.lang.String userName,
                                   java.lang.String submitter)
                            throws NoSuchRealmException,
                                   BadRealmException,
                                   NoSuchUserException,
                                   InUseException

Remove a user from the realm.

Parameters:

realmName - the realm name.

userName - the user name.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

InUseException - if attempting to delete an object, such as a user or group, which is in use as part of the realm's security policy.

Since:

getUserFullname

public java.lang.String getUserFullname(java.lang.String realmName,
                                        java.lang.String userName)
                                 throws NoSuchRealmException,
                                        BadRealmException,
                                        NoSuchUserException

Get user's full name.

Parameters:

realmName - the realm name.

userName - the user name.

Returns:

user's full name.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

getUserDescription

public java.lang.String getUserDescription(java.lang.String realmName,
                                           java.lang.String userName)
                                    throws NoSuchRealmException,
                                           BadRealmException,
                                           NoSuchUserException

Get user's description.

Parameters:

realmName - the realm name.

userName - the user name.

Returns:

user's full name.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

getUserEmail

public java.lang.String getUserEmail(java.lang.String realmName,
                                     java.lang.String userName)
                              throws NoSuchRealmException,
                                     BadRealmException,
                                     NoSuchUserException

Get user's email address.

Parameters:

realmName - the realm name.

userName - the user name.

Returns:

user's full name.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

isUserAccountDisable

public boolean isUserAccountDisable(java.lang.String realmName,
                                    java.lang.String userName)
                             throws NoSuchRealmException,
                                    BadRealmException,
                                    NoSuchUserException

Check whether user account is disabled.

Parameters:

realmName - the realm name.

userName - the user name.

Returns:

user's full name.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

isUserPasswordNeverExpire

public boolean isUserPasswordNeverExpire(java.lang.String realmName,
                                         java.lang.String userName)
                                  throws NoSuchRealmException,
                                         BadRealmException,
                                         NoSuchUserException

Check if user password is never expire.

Parameters:

realmName - the realm name.

userName - the user name.

Returns:

user's full name.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

getUserPasswordExpireTime

public int getUserPasswordExpireTime(java.lang.String realmName,
                                     java.lang.String userName)
                              throws NoSuchRealmException,
                                     BadRealmException,
                                     NoSuchUserException

Get user password expire time

Parameters:

realmName - the realm name.

userName - the user name.

Returns:

user's full name.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

isUserPasswordPermitBlank

public boolean isUserPasswordPermitBlank(java.lang.String realmName,
                                         java.lang.String userName)
                                  throws NoSuchRealmException,
                                         BadRealmException,
                                         NoSuchUserException

Check if user password permit blank.

Parameters:

realmName - the realm name.

userName - the user name.

Returns:

user's full name.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

getUserPasswordMinLength

public int getUserPasswordMinLength(java.lang.String realmName,
                                    java.lang.String userName)
                             throws NoSuchRealmException,
                                    BadRealmException,
                                    NoSuchUserException

Get user password minimum length.

Parameters:

realmName - the realm name.

userName - the user name.

Returns:

user's full name.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

changePassword

public java.lang.String changePassword(java.lang.String realmName,
                                       java.lang.String userName,
                                       java.lang.String subPwd,
                                       java.lang.String newPwd,
                                       java.lang.String submitter)
                                throws NoSuchRealmException,
                                       BadRealmException,
                                       NoSuchUserException

Change user password.

Parameters:

realmName - the realm name.

userName - the user name.

subPwd - submitter's password

newPwd - new password

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

Since:

editLDAPUser

public java.lang.String editLDAPUser(java.lang.String realmName,
                                     java.lang.String userName,
                                     java.lang.String fullName,
                                     java.lang.String description,
                                     java.lang.String email,
                                     java.lang.String submitter)
                              throws NoSuchRealmException,
                                     BadRealmException,
                                     NoSuchUserException,
                                     InUseException,
                                     java.io.IOException

Edit the specified user.

Parameters:

realmName - the realm name.

userName - the user name.

fullName - the new user full name.

description - the new user description.

email - the new user email.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

InUseException - if attempting to delete an object, such as a user or group, which is in use as part of the realm's security policy.

java.io.IOException - if error occurs when try to save data.

Since:

V6

editUser

public java.lang.String editUser(java.lang.String realmName,
                                 java.lang.String userName,
                                 java.lang.String fullName,
                                 java.lang.String description,
                                 java.lang.String email,
                                 boolean passNeverExpire,
                                 int passExpireTime,
                                 boolean passPermitBlank,
                                 int passMinLength,
                                 boolean disabledAccount,
                                 java.lang.String submitter)
                          throws NoSuchRealmException,
                                 BadRealmException,
                                 NoSuchUserException,
                                 InUseException,
                                 java.io.IOException

Edit the specified user.

Parameters:

realmName - the realm name.

userName - the user name.

fullName - the new user full name.

description - the new user description.

email - the new user email.

passNeverExpire - whether the password can be expired, true if password is not expired.

passExpireTime - if passNeverExpire is false, represent after how long time password will be expired .

passPermitBlank - whether the password can be blank, true if blank is permited.

passMinLength - if password can not be blank, represent the password's minimum length.

disabledAccount - whether this user account can be used.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

InUseException - if attempting to delete an object, such as a user or group, which is in use as part of the realm's security policy.

java.io.IOException - if error occurs when try to save data.

Since:

getAllUserNames

public java.util.Enumeration getAllUserNames(java.lang.String realmName)
                                      throws NoSuchRealmException,
                                             BadRealmException

Get all user name list in the realm.

Parameters:

realmName - the realm name.

Returns:

the enumeration represent all user name list in the realm.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

Since:

getAllUser

public java.util.Vector getAllUser(java.lang.String realmName,
                                   java.lang.String submitter)
                            throws NoSuchRealmException,
                                   BadRealmException

Get all users set in the realm.

Parameters:

realmName - the realm name.

submitter - the user who request this action.

Returns:

the enumeration represent all user name list in the realm.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

Since:

V6

getAllUserNames

public java.util.Enumeration getAllUserNames(java.lang.String realmName,
                                             java.lang.String groupName)
                                      throws NoSuchRealmException,
                                             BadRealmException,
                                             NoSuchGroupException

Deprecated. This method was not effective since Server V6.0

Get all user name list in the group.

Parameters:

realmName - the realm name.

groupName - the group name.

Returns:

the enumeration represent all user name list in the realm.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

Since:

getAllUserNamesByRole

public java.util.Enumeration getAllUserNamesByRole(java.lang.String submitter,
                                                   java.lang.String realmName,
                                                   java.lang.String roleName)
                                            throws NoSuchRealmException,
                                                   BadRealmException,
                                                   NoSuchRoleException

Get all user name list in the role.

Parameters:

submitter - the user who request this action.

realmName - the realm name.

roleName - the role name.

Returns:

the enumeration represent all user name list in the realm.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchRoleException - if role does not exist.

Since:

V6

getParentRolesByUser

public java.util.Vector getParentRolesByUser(java.lang.String realmName,
                                             java.lang.String submitter,
                                             java.lang.String userName)
                                      throws NoSuchUserException,
                                             NoSuchRealmException

Get roles which specific user has

Parameters:

realmName - the realm name.

submitter - user id who sends this request

userName - the user name

Returns:

a Vector object contains role names which specific user has, or null if submitter has not permission for get roles by this user.

Throws:

NoSuchUserException - if user does not exist.

NoSuchRealmException

Since:

V6

getGroupsByUser

public java.util.Vector getGroupsByUser(java.lang.String realmName,
                                        java.lang.String submitter,
                                        java.lang.String userName)
                                 throws NoSuchUserException,
                                        NoSuchRealmException

Get the groups which specifie user has

Parameters:

realmName - the realm name

submitter - the user who request this action.

userName - the user name

Returns:

a Vector object contains group names which specific user has, or null if submitter has not permission for get groups by this user.

Throws:

NoSuchUserException - if the user does not exist

NoSuchRealmException - if the realm does not exist

Since:

server V7.1

addNewParentRolesToUser

public java.lang.String addNewParentRolesToUser(java.lang.String realmName,
                                                java.lang.String submitter,
                                                java.lang.String userName,
                                                java.lang.String roleName)
                                         throws NoSuchRoleException,
                                                NoSuchUserException,
                                                NoSuchRealmException

Add some new parent role to a user.

Parameters:

realmName - the realm name.

submitter - the submitter's name

userName - the name of user that will be added some new parent role

roleName - the new parent role's name.

Returns:

the operation information.

Throws:

NoSuchUserException - if user does not exist.

NoSuchRoleException - if role does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

Since:

V6

addMemberIntoGroup

public java.lang.String addMemberIntoGroup(java.lang.String realmName,
                                           java.lang.String groupName,
                                           java.lang.String memberName,
                                           java.lang.String submitter)
                                    throws NoSuchRealmException,
                                           BadRealmException,
                                           NoSuchGroupException,
                                           NoSuchUserException,
                                           java.io.IOException

Deprecated. This method was not effective since V6.

Add a member into a group, the member can be a user or a group in same realm.

Parameters:

realmName - the realm name.

groupName - the group name that add member into.

memberName - the member name, can be a user name or a group name.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

NoSuchUserException - if user does not exist.

java.io.IOException - if error occurs when try to save data.

Since:

addUserIntoRole

public java.lang.String addUserIntoRole(java.lang.String realmName,
                                        java.lang.String roleName,
                                        java.lang.String userName,
                                        java.lang.String submitter)
                                 throws NoSuchRealmException,
                                        BadRealmException,
                                        NoSuchUserException,
                                        NoSuchRoleException

Add a user into a role.

Parameters:

realmName - the realm name.

roleName - the group name that add member into.

userName - the user name.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchRoleException - if role does not exist.

NoSuchUserException - if user does not exist.

Since:

V6

removeMemberFromGroup

public java.lang.String removeMemberFromGroup(java.lang.String realmName,
                                              java.lang.String groupName,
                                              java.lang.String memberName,
                                              java.lang.String submitter)
                                       throws NoSuchRealmException,
                                              BadRealmException,
                                              NoSuchGroupException,
                                              NoSuchUserException,
                                              java.io.IOException

Deprecated. This method was not effective since V6.

Remove a member from the group.

Parameters:

realmName - the realm name.

groupName - the group name that add member into.

memberName - the member name, can be a user name or a group name.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchGroupException - if group does not exist.

NoSuchUserException - if user does not exist.

java.io.IOException - if error occurs when try to save data.

Since:

removeUserFromRole

public java.lang.String removeUserFromRole(java.lang.String realmName,
                                           java.lang.String roleName,
                                           java.lang.String userName,
                                           java.lang.String submitter)
                                    throws NoSuchRealmException,
                                           BadRealmException,
                                           NoSuchRoleException,
                                           NoSuchUserException

Deprecated. This method was not effective since Server V7.0

Remove a user from the role.

Parameters:

realmName - the realm name.

roleName - the role name that remove from role.

userName - the user name.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchRoleException - if role does not exist.

NoSuchUserException - if user does not exist.

Since:

V6

getUserParentRolesCount

public int getUserParentRolesCount(java.lang.String realmName,
                                   java.lang.String userName)
                            throws NoSuchUserException

Get the count if a user's parent roles' count

Parameters:

realmName - the realm name.

userName - the user's name

Returns:

the count of parent roles, if have errors happening, it will return -1

Throws:

NoSuchUserException - if user does not exist.

Since:

V6

getUserParentGroupsCount

public int getUserParentGroupsCount(java.lang.String realmName,
                                    java.lang.String userName)
                             throws NoSuchRealmException,
                                    NoSuchUserException

Get the count if a user's parent groups count

Parameters:

realmName - the realm name

userName - the user's name

Returns:

the count of parent groups

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

NoSuchUserException - if user does not exist.

Since:

server 7.1

removeParentRolesFromUser

public java.lang.String removeParentRolesFromUser(java.lang.String realmName,
                                                  java.lang.String submitter,
                                                  java.lang.String userName,
                                                  java.lang.String roleName)
                                           throws NoSuchUserException,
                                                  NoSuchRoleException,
                                                  NoSuchRealmException

Remove a parent role from a user

Parameters:

realmName - the realm name.

submitter - the user who request this action.

userName - the name of user that will be deleted a parent role

roleName - the new parent role's name.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchUserException - if user does not exist.

NoSuchRoleException - if role does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

Since:

V6.

addAcl

public java.lang.String addAcl(java.lang.String realmName,
                               java.lang.String aclName,
                               java.lang.String submitter)
                        throws NoSuchRealmException,
                               BadRealmException,
                               java.io.IOException

Deprecated. This method was not effective since V6.

Add a new Acl into the realm.

Parameters:

realmName - the realm name.

aclName - the new Acl name.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

java.io.IOException - if error occurs when try to save data.

Since:

removeAcl

public java.lang.String removeAcl(java.lang.String realmName,
                                  java.lang.String aclName,
                                  java.lang.String submitter)
                           throws NoSuchRealmException,
                                  BadRealmException,
                                  NoSuchAclException

Deprecated. This method was not effective since V6.

Remove a Acl from the realm.

Parameters:

realmName - the realm name.

aclName - the new Acl name.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchAclException - if acl does not exist.

Since:

addMemberIntoAcl

public java.lang.String addMemberIntoAcl(java.lang.String realmName,
                                         java.lang.String aclName,
                                         java.lang.String memberName,
                                         java.lang.String submitter)
                                  throws NoSuchRealmException,
                                         BadRealmException,
                                         NoSuchAclException,
                                         java.security.acl.NotOwnerException,
                                         java.io.IOException

Deprecated. This method was not effective since V6.

Add a member into the Acl, the member can be a user or a group in same realm.

Parameters:

realmName - the realm name.

aclName - the new Acl name.

memberName - the member name, can be a user name or a group name.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchAclException - if acl does not exist.

java.security.acl.NotOwnerException - if the Principal attempting the modification is not an owner.

java.io.IOException - if error occurs when try to save data.

Since:

setMemberPermissions

public java.lang.String setMemberPermissions(java.lang.String realmName,
                                             java.lang.String aclName,
                                             java.lang.String memberName,
                                             java.util.Vector permissions,
                                             boolean isNegative,
                                             java.lang.String submitter)
                                      throws NoSuchRealmException,
                                             BadRealmException,
                                             NoSuchAclException,
                                             java.security.acl.NotOwnerException,
                                             java.io.IOException

Deprecated. This method was not effective since V6.

Specify the member's permissions.

Parameters:

realmName - the realm name.

aclName - the new Acl name.

memberName - the member name, can be a user name or a group name.

permissions - the permissions that set to this user. permissions contained in Vector are defined in jet.server.api.Permissions.

isNegative - whether the permissions is negative.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchAclException - if acl does not exist.

java.security.acl.NotOwnerException - if the Principal attempting the modification is not an owner.

java.io.IOException - if error occurs when try to save data.

Since:

See Also:

Permissions

removeMemberFromAcl

public java.lang.String removeMemberFromAcl(java.lang.String realmName,
                                            java.lang.String aclName,
                                            java.lang.String memberName,
                                            java.lang.String submitter)
                                     throws NoSuchRealmException,
                                            BadRealmException,
                                            NoSuchAclException,
                                            java.security.acl.NotOwnerException,
                                            java.io.IOException

Deprecated. This method was not effective since V6.

Remove a member from the Acl.

Parameters:

realmName - the realm name.

aclName - the new Acl name.

memberName - the member name, can be a user name or a group name.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchAclException - if acl does not exist.

java.security.acl.NotOwnerException - if the Principal attempting the modification is not an owner.

java.io.IOException - if error occurs when try to save data.

Since:

getAclNames

public java.util.Enumeration getAclNames(java.lang.String realmName)
                                  throws NoSuchRealmException,
                                         BadRealmException

Deprecated. This method was not effective since V6.

Get all Acl name list in the realm.

Parameters:

realmName - the realm name.

Returns:

the enumeration that represent Acl name list in the realm.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

Since:

getAcls

public java.util.Enumeration getAcls(java.lang.String realmName)
                              throws NoSuchRealmException,
                                     BadRealmException

Deprecated. This method was not effective since V6.

Get all Acl list in the real.

Parameters:

realmName - the realm name.

Returns:

the enumeration that represent Acl list in the realm.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

Since:

getAcl

public java.security.acl.Acl getAcl(java.lang.String realmName,
                                    java.lang.String aclName)
                             throws NoSuchRealmException,
                                    BadRealmException,
                                    NoSuchAclException

Deprecated. This method was not effective since V6.

Get an Acl specified by aclName.

Parameters:

realmName - the realm name.

aclName - the Acl name.

Returns:

An Acl that request.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchAclException - if acl does not exist.

Since:

getProtections

public java.util.Enumeration getProtections(java.lang.String realmName)
                                     throws NoSuchRealmException,
                                            BadRealmException

Deprecated. This method is not effective since V6.

Get all protections in specified realm. A protection combines a resource node (Not for a virtual resource node) with an ACL, which means that the access of the resource node is controlled by that ACL.

Parameters:

realmName - the realm name.

Returns:

the enumeration that represent resource path name of protection list in the realm.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

getCombinedAclName

public java.lang.String getCombinedAclName(java.lang.String realmName,
                                           java.lang.String resourcePath)
                                    throws NoSuchRealmException,
                                           BadRealmException

Deprecated. This method was not effective since V6.

Get acl name that combined with specified resource path in a protection.

Parameters:

realmName - the realm name.

resourcePath - the resource node represented by path.

Returns:

the acl name.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

addProtection

public java.lang.String addProtection(java.lang.String realmName,
                                      java.lang.String resourcePath,
                                      java.lang.String aclName,
                                      java.lang.String submitter)
                               throws NoSuchRealmException,
                                      BadRealmException,
                                      java.io.IOException

Deprecated. This method was not effective since V6.

Add a protection into the realm. A protection combines a resource node (Not for a virtual resource node) with an ACL, which means that the access of the resource node is controlled by that ACL.

Parameters:

realmName - the realm name.

resourcePath - the resource node represented by path.

aclName - the Acl name.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

java.io.IOException - if error occurs when try to save data.

Since:

removeProtection

public java.lang.String removeProtection(java.lang.String realmName,
                                         java.lang.String resourcePath,
                                         java.lang.String submitter)
                                  throws NoSuchRealmException,
                                         BadRealmException,
                                         java.io.IOException

Deprecated. This method was not effective since V6.

Remove a protection from the realm. A protection combines a resource node (Not for a virtual resource node) with an ACL, which means that the access of the resource node is controlled by that ACL.

Parameters:

realmName - the realm name.

resourcePath - the resource node represented by path.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

java.io.IOException - if error occurs when try to save data.

Since:

editProtection

public java.lang.String editProtection(java.lang.String realmName,
                                       java.lang.String resourcePath,
                                       java.lang.String aclName,
                                       java.lang.String submitter)
                                throws NoSuchRealmException,
                                       BadRealmException,
                                       NoSuchAclException

Deprecated. This method was not effective since V6.

Edit a protection from the realm. A protection combines a resource node (Not for a virtual resource node) with an ACL, which means that the access of the resource node is controlled by that ACL.

Parameters:

realmName - the realm name.

resourcePath - the resource node represented by path.

aclName - the Acl name.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchAclException

Since:

setNoAudit

public java.lang.String setNoAudit(java.lang.String realmName,
                                   java.lang.String userName,
                                   boolean b,
                                   java.lang.String submitter)
                            throws NoSuchRealmException,
                                   BadRealmException,
                                   NoSuchUserException,
                                   java.io.IOException

Set whether no event to be audited for the user. These audit settings can point out whether report server logs users' MANAGE and/or ACCESS actions. If those settings are disabled (say, set to false), the actions of that user will not be logged. The audit setting takes effect when the log level in the report server's configuration is turned on. If the log level is none, then the settings will be ignored.

Parameters:

realmName - the realm name.

userName - the user name.

b - whether logs this user's MANAGE and ACCESS actions.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

java.io.IOException - if error occurs when try to save data.

Since:

setAuditFileAccessSuccess

public java.lang.String setAuditFileAccessSuccess(java.lang.String realmName,
                                                  java.lang.String userName,
                                                  boolean b,
                                                  java.lang.String submitter)
                                           throws NoSuchRealmException,
                                                  BadRealmException,
                                                  NoSuchUserException,
                                                  java.io.IOException

Set whether audit successful ACCESS actions for the user.

Parameters:

realmName - the realm name.

userName - the user name.

b - whether logs this user's successful ACCESS actions.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

java.io.IOException - if error occurs when try to save data.

Since:

setAuditFileAccessFail

public java.lang.String setAuditFileAccessFail(java.lang.String realmName,
                                               java.lang.String userName,
                                               boolean b,
                                               java.lang.String submitter)
                                        throws NoSuchRealmException,
                                               BadRealmException,
                                               NoSuchUserException,
                                               java.io.IOException

Set whether audit failing ACCESS actions for the user.

Parameters:

realmName - the realm name.

userName - the user name.

b - whether logs this user's failing ACCESS actions.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

java.io.IOException - if error occurs when try to save data.

Since:

setAuditManageSuccess

public java.lang.String setAuditManageSuccess(java.lang.String realmName,
                                              java.lang.String userName,
                                              boolean b,
                                              java.lang.String submitter)
                                       throws NoSuchRealmException,
                                              BadRealmException,
                                              NoSuchUserException,
                                              java.io.IOException

Set whether audit successful MANAGE actions for the user.

Parameters:

realmName - the realm name.

userName - the user name.

b - whether logs this user's MANAGE actions.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

java.io.IOException - if error occurs when try to save data.

Since:

setAuditManageFail

public java.lang.String setAuditManageFail(java.lang.String realmName,
                                           java.lang.String userName,
                                           boolean b,
                                           java.lang.String submitter)
                                    throws NoSuchRealmException,
                                           BadRealmException,
                                           NoSuchUserException,
                                           java.io.IOException

Set whether audit failing MANAGE actions for the user.

Parameters:

realmName - the realm name.

userName - the user name.

b - whether logs this user's failing MANAGE actions.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

java.io.IOException - if error occurs when try to save data.

Since:

isNoAudit

public boolean isNoAudit(java.lang.String realmName,
                         java.lang.String userName)
                  throws NoSuchRealmException,
                         BadRealmException,
                         NoSuchUserException

Check if does not audit any ACCESS or MANAGE event for the user.

Parameters:

realmName - the realm name.

userName - the user name.

Returns:

true if does not audit any event, otherwise false.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

Since:

isAuditFileAccessSuccess

public boolean isAuditFileAccessSuccess(java.lang.String realmName,
                                        java.lang.String userName)
                                 throws NoSuchRealmException,
                                        BadRealmException,
                                        NoSuchUserException

Check if audit successful ACCESS event for the user.

Parameters:

realmName - the realm name.

userName - the user name.

Returns:

true if need audit successful ACCESS event, otherwise false.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

Since:

isAuditFileAccessFail

public boolean isAuditFileAccessFail(java.lang.String realmName,
                                     java.lang.String userName)
                              throws NoSuchRealmException,
                                     BadRealmException,
                                     NoSuchUserException

Check if audit failing ACCESS event for the user.

Parameters:

realmName - the realm name.

userName - the user name.

Returns:

true if need audit failing ACCESS event, otherwise false.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

Since:

isAuditManageSuccess

public boolean isAuditManageSuccess(java.lang.String realmName,
                                    java.lang.String userName)
                             throws NoSuchRealmException,
                                    BadRealmException,
                                    NoSuchUserException

Check if audit successful MANAGE event for the user.

Parameters:

realmName - the realm name.

userName - the user name.

Returns:

true if need audit successful MANAGE event, otherwise false.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

Since:

isAuditManageFail

public boolean isAuditManageFail(java.lang.String realmName,
                                 java.lang.String userName)
                          throws NoSuchRealmException,
                                 BadRealmException,
                                 NoSuchUserException

Check if audit failing MANAGE event for the user.

Parameters:

realmName - the realm name.

userName - the user name.

Returns:

true if need audit failing MANAGE event, otherwise false.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchUserException - if user does not exist.

Since:

addRole

public java.lang.String addRole(java.lang.String realmName,
                                java.lang.String roleName,
                                java.lang.String description,
                                java.lang.String parentRoleName,
                                java.lang.String submitter)
                         throws NoSuchRealmException,
                                BadRealmException,
                                RoleExistsException

Deprecated. This method is not effective since V7.0 .

Add a new role into the realm.

Parameters:

realmName - the realm name.

roleName - the new role name.

description - the new role description.

parentRoleName - the role's parent role name.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

RoleExistsException - if role exist.

Since:

V6

addRole

public java.lang.String addRole(java.lang.String realmName,
                                java.lang.String roleName,
                                java.lang.String description,
                                java.lang.String submitter)
                         throws NoSuchRealmException,
                                BadRealmException,
                                RoleExistsException

Add a new role into the realm.

Parameters:

realmName - the realm name.

roleName - the new role name.

description - the new role description.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

RoleExistsException - if role exist.

Since:

V7.0

removeRole

public java.lang.String removeRole(java.lang.String realmName,
                                   java.lang.String roleName,
                                   java.lang.String submitter)
                            throws NoSuchRealmException,
                                   BadRealmException,
                                   NoSuchRoleException

Remove a role from the realm.

Parameters:

realmName - the realm name.

roleName - the new role name.

submitter - the user who request this action.

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchRoleException - if role does not exist.

Since:

V6

getAllRoles

public java.util.Vector getAllRoles(java.lang.String realmName,
                                    java.lang.String submitter)
                             throws NoSuchRealmException,
                                    BadRealmException

Get all role set in the realm.

Parameters:

realmName - the realm name.

submitter - the user who request this action.

Returns:

the enumeration represent all role list.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

Since:

V6

getAllRoleNames

public java.util.Vector getAllRoleNames(java.lang.String realmName,
                                        java.lang.String submitter)
                                 throws NoSuchRealmException,
                                        BadRealmException

Get all role name list in the realm.

Parameters:

realmName - the realm name.

submitter - the user who request this action.

Returns:

the enumeration represent all group name list.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

Since:

V6

getRole

public Role getRole(java.lang.String submitter,
                    java.lang.String realmName,
                    java.lang.String roleName)
             throws NoSuchRealmException,
                    BadRealmException,
                    NoSuchRoleException

Get a role specified by roleName.

Parameters:

submitter - the user who request this action.

realmName - the realm name.

roleName - the role name.

Returns:

a role that request.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchRoleException - if role does not exist.

Since:

V6

getRoleMemberCount

public int getRoleMemberCount(java.lang.String realmName,
                              java.lang.String roleName)
                       throws NoSuchRealmException,
                              BadRealmException,
                              NoSuchRoleException

Get member count in a role.

Parameters:

realmName - the realm name.

roleName - the role name.

Returns:

the member count in specified role.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchRoleException - if role does not exist.

Since:

V6

getSubRolesByRole

public java.util.Vector getSubRolesByRole(java.lang.String realmName,
                                          java.lang.String submitter,
                                          java.lang.String roleName)
                                   throws NoSuchRoleException,
                                          NoSuchRealmException,
                                          BadRealmException

Get the set of a role's sub roles.

Parameters:

realmName - the realm name.

submitter - the submitter's name

roleName - the role's name

Returns:

the sub roles' set

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchRoleException - if role does not exist.

Since:

V6

getSubUsersByRole

public java.util.Vector getSubUsersByRole(java.lang.String realmName,
                                          java.lang.String submitter,
                                          java.lang.String roleName)
                                   throws NoSuchRoleException,
                                          NoSuchRealmException,
                                          BadRealmException

Get the set of a role's sub users

Parameters:

realmName - the realm name.

submitter - the submitter's name

roleName - the role's name

Returns:

the sub users' set

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchRoleException - if role does not exist.

Since:

V6

removeRoleFromParentRole

public java.lang.String removeRoleFromParentRole(java.lang.String submitter,
                                                 java.lang.String realmName,
                                                 java.lang.String roleName,
                                                 java.lang.String parentRoleName)
                                          throws NoSuchRoleException,
                                                 NoSuchRealmException,
                                                 BadRealmException

Remove a role from a parent role

Parameters:

submitter - the submitter's name

realmName - the realm name.

roleName - the name of role that will be remove from a parent role.

parentRoleName - the parent role's name

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchRoleException - if role does not exist.

Since:

V6

removeUserFromParentRole

public java.lang.String removeUserFromParentRole(java.lang.String submitter,
                                                 java.lang.String realmName,
                                                 java.lang.String userName,
                                                 java.lang.String parentRoleName)
                                          throws NoSuchRoleException,
                                                 NoSuchUserException,
                                                 NoSuchRealmException,
                                                 BadRealmException

Remove a user from a parent role

Parameters:

submitter - the submitter's name

realmName - the realm name.

userName - the name of user that will be remove from a parent role.

parentRoleName - the parent role's name

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchRoleException - if role does not exist.

NoSuchUserException - if user does not exist.

Since:

V6

getSubUsersNameByRole

public java.util.Vector getSubUsersNameByRole(java.lang.String realmName,
                                              java.lang.String submitter,
                                              java.lang.String roleName)
                                       throws NoSuchRoleException,
                                              NoSuchRealmException,
                                              BadRealmException

Get the set of a role's sub users' names

Parameters:

realmName - the realm name.

submitter - the submitter's name

roleName - the role's name

Returns:

the sub users' names set

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

NoSuchRoleException - if role does not exist.

Since:

V6

addSubUserToRole

public java.lang.String addSubUserToRole(java.lang.String realmName,
                                         java.lang.String submitter,
                                         java.lang.String subUserName,
                                         java.lang.String roleName)
                                  throws NoSuchRoleException,
                                         NoSuchUserException,
                                         NoSuchRealmException,
                                         BadRealmException

Add a sub user to a role

Parameters:

realmName - the realm name.

submitter - the submitter's name

subUserName - the sub user's name

roleName - the role's name

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchUserException - if user does not exist.

NoSuchRoleException - if role does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

Since:

V6

addSubRoleToRole

public java.lang.String addSubRoleToRole(java.lang.String realmName,
                                         java.lang.String submitter,
                                         java.lang.String subRoleName,
                                         java.lang.String roleName)
                                  throws NoSuchRoleException,
                                         NoSuchRealmException,
                                         BadRealmException

Add a sub role to a role

Parameters:

realmName - the realm name.

submitter - the submitter's name

subRoleName - the sub role's name

roleName - the role's name

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRoleException - if role does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

Since:

V6

getReferUsers

public java.util.Vector getReferUsers(java.lang.String realmName,
                                      java.lang.String userName)
                               throws NoSuchUserException,
                                      NoSuchRealmException

Parameters:

realmName - the realm name.

userName - the user name

Returns:

The users' name that have same role or group with the user

Throws:

NoSuchUserException - if the user specified by userName not exist.

NoSuchRealmException - if the realm specified by realmName does not exist.

getReferRoles

public java.util.Vector getReferRoles(java.lang.String realmName,
                                      java.lang.String userName)
                               throws NoSuchUserException,
                                      NoSuchRealmException

Parameters:

realmName - the realm name

userName - the user name

Returns:

The roles name that have some relationships wiht the user. For instance: all roles that belong to this user.

Throws:

NoSuchUserException - if the user specified by userName not exist.

NoSuchRealmException - if the realm specified by realmName does not exist.

isAdminUser

public boolean isAdminUser(java.lang.String userName)

Check the user is adminisitrator or not

Parameters:

userName - the user's name

Returns:

if the user is administrator return true, otherwise return false

setUserPrivileges

public void setUserPrivileges(java.lang.String userName,
                              java.util.Vector privileges)

Deprecated. Server V7.1 replaced by setUserPrivileges(String realmName, String submitter, String userName, Vector privileges) throws NoSuchUserException, NoSuchRealmException;.

set privileges for user

Parameters:

userName - the user name

privileges - a Vector save the available privilege such as APIConst.PRIVILEGE_DEPLOY_REPORT

setUserPrivileges

public java.lang.String setUserPrivileges(java.lang.String realmName,
                                          java.lang.String submitter,
                                          java.lang.String userName,
                                          java.util.Vector privileges)
                                   throws NoSuchUserException,
                                          NoSuchRealmException

set privileges for user

Parameters:

realmName - the realm name

submitter - the submitter name

userName - the user's name

privileges - privileges a Vector save the available privilege such as APIConst.PRIVILEGE_DEPLOY_REPORT

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchUserException - if user does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

Since:

Server V7.1

setRolePrivileges

public void setRolePrivileges(java.lang.String roleName,
                              java.util.Vector privileges)

Deprecated. Server V7.1 replaced by setRolePrivileges(String realmName, String submitter, String roleName, Vector privileges) throws NoSuchRoleException, NoSuchRealmException;.

set privileges for role

Parameters:

roleName - the user name

privileges - a Vector save available privileges such as APIConst.PRIVILEGE_DEPLOY_REPORT

setRolePrivileges

public java.lang.String setRolePrivileges(java.lang.String realmName,
                                          java.lang.String submitter,
                                          java.lang.String roleName,
                                          java.util.Vector privileges)
                                   throws NoSuchRoleException,
                                          NoSuchRealmException,
                                          BadRealmException

set privileges for role

Parameters:

realmName - the realm'a name

submitter - the submitter's name

roleName - roleName the user name

privileges - a Vector save available privileges such as APIConst.PRIVILEGE_DEPLOY_REPORT

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRoleException - if role does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException

Since:

Server V7.1

setGroupPrivileges

public java.lang.String setGroupPrivileges(java.lang.String realmName,
                                           java.lang.String submitter,
                                           java.lang.String groupName,
                                           java.util.Vector privileges)
                                    throws NoSuchGroupException,
                                           NoSuchRealmException,
                                           BadRealmException

set privileges for group

Parameters:

realmName - the realm'a name

submitter - the submitter's name

groupName - groupName the group name

privileges - a Vector save available privileges such as APIConst.PRIVILEGE_DEPLOY_REPORT

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchGroupException - if group does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException

Since:

Server V7.1

getUserPrivileges

public java.util.Vector getUserPrivileges(java.lang.String userName)

Deprecated. Server V7.1 replaced by getUserPrivileges(String realmName, String submitter, String userName,) throws NoSuchUserException, NoSuchRealmException;.

get user's privileges

Parameters:

userName - the user name

Returns:

privileges a Vector save available privileges such as APIConst.PRIVILEGE_DEPLOY_REPORT

getUserPrivileges

public java.util.Vector getUserPrivileges(java.lang.String realmName,
                                          java.lang.String submitter,
                                          java.lang.String userName)
                                   throws NoSuchUserException,
                                          NoSuchRealmException

get user's privileges

Parameters:

realmName - the realm's name

submitter - the submitter's name

userName - the user's name

Returns:

privileges a Vector save available privileges such as APIConst.PRIVILEGE_DEPLOY_REPORT

Throws:

NoSuchUserException - if user does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

Since:

Server V7.1

getRolePrivileges

public java.util.Vector getRolePrivileges(java.lang.String roleName)

Deprecated. Server V7.1 replaced by getRolePrivileges(String realmName, String submitter, String roleName,) throws NoSuchRoleException, NoSuchRealmException;.

get role's privileges

Parameters:

roleName - the role name

Returns:

privileges a Vector save available privileges such as APIConst.PRIVILEGE_DEPLOY_REPORT

getRolePrivileges

public java.util.Vector getRolePrivileges(java.lang.String realmName,
                                          java.lang.String submitter,
                                          java.lang.String roleName)
                                   throws NoSuchRoleException,
                                          NoSuchRealmException,
                                          BadRealmException

get user's privileges

Parameters:

realmName - the realm's name

submitter - the submitter's name

roleName - the role's name

Returns:

privileges a Vector save available privileges such as APIConst.PRIVILEGE_DEPLOY_REPORT

Throws:

NoSuchRoleException - if role does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException

Since:

Server V7.1

getGroupPrivileges

public java.util.Vector getGroupPrivileges(java.lang.String realmName,
                                           java.lang.String submitter,
                                           java.lang.String groupName)
                                    throws NoSuchGroupException,
                                           NoSuchRealmException,
                                           BadRealmException

get user's privileges

Parameters:

realmName - the realm's name

submitter - the submitter's name

groupName - the group's name

Returns:

privileges a Vector save available privileges such as APIConst.PRIVILEGE_DEPLOY_REPORT

Throws:

NoSuchGroupException - if group does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException

Since:

Server V7.1

getPrivilegedUsers

public java.util.Vector getPrivilegedUsers(java.lang.String privilege)

Deprecated. Server V7.1 replaced by getPrivilegedUsers(String realmName, String submitter, String privilege,) throws NoSuchRealmException;.

get all users who have the privilege

Parameters:

privilege - the available privilege APIConst.PRIVILEGE_DEPLOY_REPORT

Returns:

users a Vector save the users' names

getPrivilegedUsers

public java.util.Vector getPrivilegedUsers(java.lang.String realmName,
                                           java.lang.String submitter,
                                           java.lang.String privilege)
                                    throws NoSuchRealmException

get all users who have the privilege

Parameters:

realmName - the realm's name

submitter - the submitter's name

privilege - the available privilege APIConst.PRIVILEGE_DEPLOY_REPORT

Returns:

users a Vector save the users' names

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

Since:

Server V7.1

getPrivilegedRoles

public java.util.Vector getPrivilegedRoles(java.lang.String privilege)

Deprecated. Server V7.1 replaced by getPrivilegedRoles(String realmName, String submitter, String privilege,) throws NoSuchRealmException;.

get all roles who have the privilege

Parameters:

privilege - the available privilege APIConst.PRIVILEGE_DEPLOY_REPORT

Returns:

roles a Vector save the roles' names

getPrivilegedRoles

public java.util.Vector getPrivilegedRoles(java.lang.String realmName,
                                           java.lang.String submitter,
                                           java.lang.String privilege)
                                    throws NoSuchRealmException

get all roles who have the privilege

Parameters:

realmName - the realm's name

submitter - the submitter's name

privilege - the available privilege APIConst.PRIVILEGE_DEPLOY_REPORT

Returns:

roles a Vector save the roles' names

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

Since:

Server V7.1

getPrivilegedGroups

public java.util.Vector getPrivilegedGroups(java.lang.String realmName,
                                            java.lang.String submitter,
                                            java.lang.String privilege)
                                     throws NoSuchRealmException

get all groups who have the privilege

Parameters:

realmName - the realm's name

submitter - the submitter's name

privilege - the available privilege APIConst.PRIVILEGE_DEPLOY_REPORT

Returns:

groups a Vector save the groups' names

Throws:

NoSuchRealmException - if realm specified by realmName does not exist.

Since:

Server V7.1

addPrivilegedUsers

public void addPrivilegedUsers(java.lang.String privilege,
                               java.util.Vector users)

Deprecated. Server V7.1 replaced by addPrivilegedUsers(String realmName, String submitter, String privilege, Vector users) throws NoSuchUserException, NoSuchRealmException;.

add users to have this privilege

Parameters:

privilege - the available privilege APIConst.PRIVILEGE_DEPLOY_REPORT

users - a Vector save the users' names

addPrivilegedUsers

public java.lang.String addPrivilegedUsers(java.lang.String realmName,
                                           java.lang.String submitter,
                                           java.lang.String privilege,
                                           java.util.Vector users)
                                    throws NoSuchUserException,
                                           NoSuchRealmException

add users to have this privilege

Parameters:

realmName - the realm's name

submitter - the submitter's name

privilege - the available privilege APIConst.PRIVILEGE_DEPLOY_REPORT

users - a Vector save the users' names

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchUserException - if user specified by users does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

Since:

Server V7.1

addPrivilegedRoles

public void addPrivilegedRoles(java.lang.String privilege,
                               java.util.Vector roles)

Deprecated. Server V7.1 eplaced by addPrivilegedRoles(String realmName, String submitter, String privilege, Vector groups) throws NoSuchGroupException, NoSuchRealmException, BadRealmException;.

add roles to have this privilege

Parameters:

privilege - the available privilege APIConst.PRIVILEGE_DEPLOY_REPORT

roles - a Vector save the roles' names

addPrivilegedRoles

public java.lang.String addPrivilegedRoles(java.lang.String realmName,
                                           java.lang.String submitter,
                                           java.lang.String privilege,
                                           java.util.Vector roles)
                                    throws NoSuchRoleException,
                                           NoSuchRealmException,
                                           BadRealmException

add roles to have this privilege

Parameters:

realmName - the realm's name

submitter - the submitter's name

privilege - the available privilege APIConst.PRIVILEGE_DEPLOY_REPORT

roles - a Vector save the roles' names

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRoleException - if role specified by roles does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

Since:

Server V7.1

addPrivilegedGroups

public java.lang.String addPrivilegedGroups(java.lang.String realmName,
                                            java.lang.String submitter,
                                            java.lang.String privilege,
                                            java.util.Vector groups)
                                     throws NoSuchGroupException,
                                            NoSuchRealmException,
                                            BadRealmException

add roles to have this privilege

Parameters:

realmName - the realm's name

submitter - the submitter's name

privilege - the available privilege APIConst.PRIVILEGE_DEPLOY_REPORT

groups - a Vector save the groups' names

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchGroupException - if group specified by groups does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException - if specified realm data structures are bad.

Since:

Server V7.1

removePrivilegedUsers

public java.lang.String removePrivilegedUsers(java.lang.String privilege,
                                              java.util.Vector users)

Deprecated. Server V7.1 replaced by removePrivilegedUsers(String realmName, String submitter, String privilege, Vector users) throws NoSuchUserException, NoSuchRealmException;.

remove users from users who have the privilege

Parameters:

privilege - the available privilege APIConst.PRIVILEGE_DEPLOY_REPORT

users - a Vector save the users' names

Returns:

message if success return null else return error message

removePrivilegedUsers

public java.lang.String removePrivilegedUsers(java.lang.String realmName,
                                              java.lang.String submitter,
                                              java.lang.String privilege,
                                              java.util.Vector users)
                                       throws NoSuchUserException,
                                              NoSuchRealmException

remove users from users who have the privilege

Parameters:

realmName - the realm's name

submitter - the submitter's name

privilege - the available privilege APIConst.PRIVILEGE_DEPLOY_REPORT

users - a Vector save the users' names

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchUserException - if user specified by users does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

Since:

Server V7.1

removePrivilegedRoles

public java.lang.String removePrivilegedRoles(java.lang.String privilege,
                                              java.util.Vector roles)

Deprecated. Server V7.1 replaced by removePrivilegedRoles(String realmName, String submitter, String privilege, Vector roles) throws NoSuchRoleException, NoSuchRealmException;.

remove roles from roles who have the privilege

Parameters:

privilege - the available privilege APIConst.PRIVILEGE_DEPLOY_REPORT

roles - a Vector save the roles' names

Returns:

message if success return null else return error message

removePrivilegedRoles

public java.lang.String removePrivilegedRoles(java.lang.String realmName,
                                              java.lang.String submitter,
                                              java.lang.String privilege,
                                              java.util.Vector roles)
                                       throws NoSuchRoleException,
                                              NoSuchRealmException,
                                              BadRealmException

remove roles from roles who have the privilege

Parameters:

realmName - the realm's name

submitter - the submitter's name

privilege - the available privilege APIConst.PRIVILEGE_DEPLOY_REPORT

roles - a Vector save the roles' names

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchRoleException - if role specified by roles does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException

Since:

Server V7.1

removePrivilegedGroups

public java.lang.String removePrivilegedGroups(java.lang.String realmName,
                                               java.lang.String submitter,
                                               java.lang.String privilege,
                                               java.util.Vector groups)
                                        throws NoSuchGroupException,
                                               NoSuchRealmException,
                                               BadRealmException

remove groups from groups who have the privilege

Parameters:

realmName - the realm's name

submitter - the submitter's name

privilege - the available privilege APIConst.PRIVILEGE_DEPLOY_REPORT

groups - a Vector save the groups' names

Returns:

error message if any error occurs but does not throw exception, or null if success.

Throws:

NoSuchGroupException - if group specified by groups does not exist.

NoSuchRealmException - if realm specified by realmName does not exist.

BadRealmException

Since:

Server V7.1