jet.server.userman
Interface UserAuthenticator

public interface UserAuthenticator

Customized Authentication

JReport Enterprise Server provides the ability to use customized user authentication scheme. A customized user authentication scheme must implement the interface jet.server.UserAuthenticator, and import the customized class file by modifying the following JReport Enterprise Server's properties file:
<SERVER PATH>/bin/classes.properties

When using customized user authentication scheme, user should:
1. Write a class which implements the interface jet.server.UserAuthenticator.
2. Put the class into CLASSPATH which used by launching JReport Enterprise Server
3. Edit file <SERVER PATH>/bin/classes.properties, let name UserAuthenticator point to the customized class
4. Restart JReport Enterprise Server and the customized user authentication is working.

ACCESS

static final int ACCESS

See Also:

Constant Field Values

MANAGE

static final int MANAGE

See Also:

Constant Field Values

changePassword

java.lang.String changePassword(java.lang.String realmName,
                                java.lang.String implUserName,
                                java.lang.String userName,
                                java.lang.String oldPwd,
                                java.lang.String newPwd)

Changes user password.

Parameters:

realmName - the realm name

implUserName - the user name who invoked the action

userName - the user name whose password needs to be changed

oldPwd - the old password

newPwd - the new password

Returns:

error message if failed, or null if successful.

changePasswordEx

java.lang.String changePasswordEx(java.lang.String realmName,
                                  java.lang.String implUserName,
                                  java.lang.String userName,
                                  java.lang.String oldPwd,
                                  java.lang.String newPwd)
                                  throws InvalidPasswordException

Changes user password.

Parameters:

realmName - the realm name

implUserName - the user name who invoked the action

userName - the user name whose password needs to be changed

oldPwd - the old password

newPwd - the new password

Returns:

error message if failed, or null if successful.

Throws:

InvalidPasswordException - if password not match advanced password rule

isPermissionOk

boolean isPermissionOk(java.lang.String realmName,
                       java.lang.String userName,
                       java.lang.String uri,
                       java.lang.String cmd)

Checks if the user has the permission to do the action

Parameters:

realmName - the realm name

userName - the user name

uri - the request URI the uri equals a special string APIConst.PRIVILEGE_URI which means this method is used to check privileges. For example, if this method is used to check privileges, it will be invoked as: isPermissionOk(realmName, userName, APIConst.PRIVILEGE_URI, cmd);

cmd - the action needed to be invoked. see brsow2cmd.htm for detailed information

Returns:

true if the user has the permission

isPermissionOk

boolean isPermissionOk(java.lang.String realmName,
                       java.lang.String userName,
                       java.lang.String uri,
                       int versionNumber,
                       java.lang.String cmd)

Checks if the user has the permission to do the action on a specific version of resource

Parameters:

realmName - the realm name

userName - the user name

uri - the request URI

versionNumber - version number of the resource specified by URI

cmd - the action needed to be invoked. see brsow2cmd.htm for detailed information

Returns:

true if the user has the permission

isValidUser

boolean isValidUser(java.lang.String realmName,
                    java.lang.String userName,
                    java.lang.String password)

Checks if the user is a valid one. A valid user must exist and provide valid password.

Parameters:

realmName - the realm name

userName - the user name

password - the user password

Returns:

true if the user exists and the password is true

isValidAdminUser

boolean isValidAdminUser(java.lang.String realmName,
                         java.lang.String userName,
                         java.lang.String password)

Checks if the user can access the administration tools.

Parameters:

realmName - the realm name

userName - the user name

password - the user password

Returns:

true if the user can access the administration tools.

getPassword

java.lang.String getPassword(java.lang.String realmName,
                             java.lang.String userName)

Gets the user password

Parameters:

realmName - the realm name

userName - the user name

Returns:

the user password, null if any error occurs.

getRealmNames

java.util.Enumeration getRealmNames()

Gets the realm list. Almost everything, including user, group, resource and schedule, is defined within a realm. Users are different if they have same names but in different realms. We must use user name and realm name together to define a user.

Returns:

the realm names. Each element is a String.

java.util.Enumeration getUserNames(java.lang.String realmName)

boolean getAuditState(java.lang.String realmName,
                      java.lang.String userName,
                      int type,
                      boolean success)

UserMailList getMailList()