com.saperion.ngc.model.authorization

Class AuthClassicConnectorService

java.lang.Object

com.saperion.ngc.model.ClassicConnectorService

com.saperion.ngc.model.authorization.AuthClassicConnectorService

All Implemented Interfaces:

AuthorizationService, Service

public class AuthClassicConnectorService
extends ClassicConnectorService
implements AuthorizationService

Classic connector based authentication service class.

Field Summary

Fields

Modifier and Type	Field and Description
static List<LogonProvider>	PROVIDER Logon provider list.
static String	SAPV_TECH_PASS SapViewer login techpass password.
static String	SAPV_TECH_SYSTEM SapViewer login techsystem system.
static String	SAPV_TECH_USER SapViewer login techuser.

Constructor Summary

Constructors

Constructor and Description
AuthClassicConnectorService() Creates a new AuthClassicConnectorService.
AuthClassicConnectorService(ConnectionProvider<com.saperion.connector.SaClassicConnector> connectionProvider) Creates an AuthClassicConnectorService, given the connection provider .
AuthClassicConnectorService(ConnectionProvider<com.saperion.connector.SaClassicConnector> connectionProvider, javax.servlet.http.HttpSession session) Creates an AuthClassicConnectorService, given the connection provider .
AuthClassicConnectorService(javax.servlet.http.HttpSession session) Creates a new AuthClassicConnectorService.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	autoLogon() This function tries to automatic logon with SSO or NTLM.
User	changePassword(User user, String newPassword) Changes the password of the given user.
User	getCurrentUser()
String	getLastUser()
SystemType	getSystemType() Get the system type.
List<UserType>	getUserTypes() Get available user types.
ModelConnectionStatus	isConnected() Check connection status.
void	logoff() Logoff from service.
User	logon(AuthenticationInformation info) Logon to service.
User	logonTech(String tenant) Logon with a technical user.
User	logonTech(String tenant, javax.servlet.http.HttpSession session) Logon with a technical user.
void	setCurrentUserPresent(boolean present) Sets whether the current user is present.
void	setCurrentUserSubstituteAccessEnabled(boolean accessEnabled) Sets whether the current user's substitute has access to the users workflow-inbox.
void	setLastUser(String user) Sets the last user name.
void	setLocale(Locale locale) Sets the locale for the underlying connection to the backend.

Methods inherited from class com.saperion.ngc.model.ClassicConnectorService

convertAuthenticationException, getConnectionProvider, getSession, getWfConnectionProvider, isActive

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SAPV_TECH_USER

public static final String SAPV_TECH_USER

SapViewer login techuser. userName.

See Also:

Constant Field Values

SAPV_TECH_PASS

public static final String SAPV_TECH_PASS

SapViewer login techpass password.

See Also:

Constant Field Values

SAPV_TECH_SYSTEM

public static final String SAPV_TECH_SYSTEM

SapViewer login techsystem system.

See Also:

Constant Field Values

PROVIDER

public static final List<LogonProvider> PROVIDER

Logon provider list.

Constructor Detail

AuthClassicConnectorService

public AuthClassicConnectorService()

Creates a new AuthClassicConnectorService.

AuthClassicConnectorService

public AuthClassicConnectorService(ConnectionProvider<com.saperion.connector.SaClassicConnector> connectionProvider)

Creates an AuthClassicConnectorService, given the connection provider .

Parameters:

connectionProvider - the connection provider

AuthClassicConnectorService

public AuthClassicConnectorService(javax.servlet.http.HttpSession session)

Creates a new AuthClassicConnectorService. Use this constructor when using this auth-service from outside of ZK-context (e.g. in a servlet).

Parameters:

session - the session to use in this auth-service

AuthClassicConnectorService

public AuthClassicConnectorService(ConnectionProvider<com.saperion.connector.SaClassicConnector> connectionProvider,
                           javax.servlet.http.HttpSession session)

Creates an AuthClassicConnectorService, given the connection provider . Use this constructor when using this auth-service from outside of ZK-context (e.g. in a servlet).

Parameters:

connectionProvider - the connection provider

session - the session to use in this auth-service

Method Detail

logon

public final User logon(AuthenticationInformation info)
                 throws AuthenticationException,
                        SystemException

Logon to service.

Specified by:

logon in interface AuthorizationService

Parameters:

info - authentication information

Returns:

the currently logged on user

Throws:

AuthenticationException - when authentication to the backend has failed

SystemException - system exception when logging on

See Also:

(com.saperion.ngc.model.authorization.User)

logonTech

public final User logonTech(String tenant)
                     throws AuthenticationException,
                            SystemException

Logon with a technical user.

Parameters:

tenant - Mandant

Returns:

User instance or null, if failed.

Throws:

AuthenticationException - Authentication failed

SystemException - System failure

logonTech

public final User logonTech(String tenant,
             javax.servlet.http.HttpSession session)
                     throws AuthenticationException,
                            SystemException

Logon with a technical user.

Parameters:

tenant - Mandant

session - the current session

Returns:

User instance or null, if failed.

Throws:

AuthenticationException - Authentication failed

SystemException - System failure

logoff

public final void logoff()
                  throws AuthenticationException,
                         DocumentLockException,
                         SystemException

Logoff from service.

Specified by:

logoff in interface AuthorizationService

Throws:

AuthenticationException - authentication to the backend has failed

DocumentLockException - when a locked document could not be unlocked

SystemException - when logoff has failed

See Also:

AuthorizationService.logoff()

getUserTypes

public final List<UserType> getUserTypes()

Get available user types.

Specified by:

getUserTypes in interface AuthorizationService

Returns:

Usertypes

See Also:

AuthorizationService.getUserTypes()

getSystemType

public final SystemType getSystemType()
                               throws SystemException

Get the system type.

Specified by:

getSystemType in interface AuthorizationService

Returns:

System type

Throws:

SystemException - when the system type can not be determined

See Also:

AuthorizationService.getSystemType()

autoLogon

public boolean autoLogon()
                  throws AuthenticationException,
                         SystemException

This function tries to automatic logon with SSO or NTLM.

Specified by:

autoLogon in interface AuthorizationService

Returns:

true, if automatic logon could be used, false, if no automatic data is set!

Throws:

AuthenticationException - when authentication to the backend has failed

SystemException - system exception when logging on

See Also:

AuthorizationService.autoLogon()

isConnected

public final ModelConnectionStatus isConnected()
                                        throws SystemException

Check connection status.

Specified by:

isConnected in interface AuthorizationService

Returns:

Connection status

Throws:

SystemException - when the connection status can not be determined

See Also:

AuthorizationService.isConnected()

getLastUser

public final String getLastUser()

Specified by:

getLastUser in interface AuthorizationService

Returns:

last user name

setCurrentUserPresent

public void setCurrentUserPresent(boolean present)
                           throws SystemException,
                                  AuthenticationException

Sets whether the current user is present.

Specified by:

setCurrentUserPresent in interface AuthorizationService

Parameters:

present - whether the current user is present

Throws:

SystemException - when a system exception while setting presence occurs

AuthenticationException - when authentication to the backend has failed

setCurrentUserSubstituteAccessEnabled

public void setCurrentUserSubstituteAccessEnabled(boolean accessEnabled)
                                           throws SystemException,
                                                  AuthenticationException

Sets whether the current user's substitute has access to the users workflow-inbox.

Specified by:

setCurrentUserSubstituteAccessEnabled in interface AuthorizationService

Parameters:

accessEnabled - whether the substitute has access

Throws:

SystemException - when a system exception while setting presence occurs

AuthenticationException - when authentication to the backend has failed

getCurrentUser

public User getCurrentUser()
                    throws AuthenticationException,
                           SystemException

Specified by:

getCurrentUser in interface AuthorizationService

Returns:

Information about the currently logged in User. The instance obtained will not contain information about the authorization (getAuthenticationInformation() will return null).

Throws:

AuthenticationException - when authentication to the backend has failed

SystemException - when a system exception while obtaining the information occurs

changePassword

public User changePassword(User user,
                  String newPassword)
                    throws SystemException,
                           AuthenticationException

Description copied from interface: AuthorizationService

Changes the password of the given user. The authentication information of the user needs to be given. This means that the password of the user has to be known.

Specified by:

changePassword in interface AuthorizationService

Parameters:

user - The user to change the password for. If the authentication information is not given, the call will fail, since the current password is needed to succeed.

newPassword - The new password for the user

Returns:

updated user information

Throws:

SystemException - when a system exception while obtaining the information occurs

AuthenticationException - when authentication to the backend has failed

setLastUser

public final void setLastUser(String user)

Sets the last user name.

Specified by:

setLastUser in interface AuthorizationService

Parameters:

user - last user name

setLocale

public void setLocale(Locale locale)
               throws AuthenticationException,
                      SystemException

Sets the locale for the underlying connection to the backend. Does not change the locale of the client!

Specified by:

setLocale in interface AuthorizationService

Parameters:

locale - locale to set

Throws:

AuthenticationException - authentication exception when setting locale

SystemException - system exception when setting locale

See Also:

AuthorizationService.setLocale(java.util.Locale)