org.eclipse.scada.core.server.common

Class ServiceCommon<S extends Session,SI extends AbstractSessionImpl>

java.lang.Object

org.eclipse.scada.core.server.common.ServiceCommon<S,SI>

All Implemented Interfaces:

Service<S>, org.eclipse.scada.utils.lifecycle.LifecycleAware

Direct Known Subclasses:

AbstractServiceImpl, HiveCommon

public abstract class ServiceCommon<S extends Session,SI extends AbstractSessionImpl>
extends Object
implements Service<S>

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.eclipse.scada.sec.AuthorizationResult	DEFAULT_RESULT

Constructor Summary

Constructors

Constructor and Description
ServiceCommon()

Method Summary

Methods

Modifier and Type	Method and Description
protected org.eclipse.scada.utils.concurrent.NotifyFuture<org.eclipse.scada.sec.AuthorizationReply>	authorize(org.eclipse.scada.sec.AuthorizationRequest request, org.eclipse.scada.sec.callback.CallbackHandler callbackHandler)
protected org.eclipse.scada.utils.concurrent.NotifyFuture<org.eclipse.scada.sec.AuthorizationReply>	authorize(org.eclipse.scada.sec.AuthorizationRequest request, org.eclipse.scada.sec.callback.CallbackHandler callbackHandler, org.eclipse.scada.sec.AuthorizationResult defaultResult) Authorize an operation
protected Set<String>	extractPrivileges(Properties properties)
protected void	fillSessionProperties(org.eclipse.scada.sec.UserInformation userInformation, Map<String,String> sessionResultProperties)
protected org.eclipse.scada.utils.concurrent.NotifyFuture<org.eclipse.scada.sec.UserInformation>	loginUser(Properties properties, org.eclipse.scada.sec.callback.CallbackHandler callbackHandler) Wraps the call to #authenticate(Properties) so that the correct exceptions are thrown for a #createSession(Properties) call.
protected org.eclipse.scada.utils.concurrent.NotifyFuture<org.eclipse.scada.sec.UserInformation>	makeEffectiveUserInformation(AbstractSessionImpl session, String targetUser, org.eclipse.scada.sec.callback.CallbackHandler handler)
void	setAuditLogService(org.eclipse.scada.sec.audit.AuditLogService auditLogService)
protected void	setAuthenticationImplementation(org.eclipse.scada.sec.AuthenticationImplementation authenticationImplementation)
protected void	setAuthorizationImplementation(org.eclipse.scada.sec.AuthorizationImplementation authorizationImplementation)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.scada.core.server.Service

closeSession, createSession

Methods inherited from interface org.eclipse.scada.utils.lifecycle.LifecycleAware

start, stop

Field Detail

DEFAULT_RESULT

protected static final org.eclipse.scada.sec.AuthorizationResult DEFAULT_RESULT

Constructor Detail

ServiceCommon

public ServiceCommon()

Method Detail

setAuditLogService

public void setAuditLogService(org.eclipse.scada.sec.audit.AuditLogService auditLogService)

setAuthenticationImplementation

protected void setAuthenticationImplementation(org.eclipse.scada.sec.AuthenticationImplementation authenticationImplementation)

setAuthorizationImplementation

protected void setAuthorizationImplementation(org.eclipse.scada.sec.AuthorizationImplementation authorizationImplementation)

extractPrivileges

protected Set<String> extractPrivileges(Properties properties)

loginUser

protected org.eclipse.scada.utils.concurrent.NotifyFuture<org.eclipse.scada.sec.UserInformation> loginUser(Properties properties,
                                                                                               org.eclipse.scada.sec.callback.CallbackHandler callbackHandler)

Wraps the call to #authenticate(Properties) so that the correct exceptions are thrown for a #createSession(Properties) call.

Parameters:

properties - the user session properties

callbackHandler - the callback handler which handles callbacks

sessionResultProperties - the map will be filled with the resulting session properties

Returns:

the user information returned by #authenticate(Properties)

Since:

1.1

See Also:

#authenticate(Properties)

fillSessionProperties

protected void fillSessionProperties(org.eclipse.scada.sec.UserInformation userInformation,
                         Map<String,String> sessionResultProperties)

Since:

1.1

authorize

protected org.eclipse.scada.utils.concurrent.NotifyFuture<org.eclipse.scada.sec.AuthorizationReply> authorize(org.eclipse.scada.sec.AuthorizationRequest request,
                                                                                                  org.eclipse.scada.sec.callback.CallbackHandler callbackHandler)

Since:

1.1

authorize

protected org.eclipse.scada.utils.concurrent.NotifyFuture<org.eclipse.scada.sec.AuthorizationReply> authorize(org.eclipse.scada.sec.AuthorizationRequest request,
                                                                                                  org.eclipse.scada.sec.callback.CallbackHandler callbackHandler,
                                                                                                  org.eclipse.scada.sec.AuthorizationResult defaultResult)

Authorize an operation

The default implementation grants everything. Override to change according to your needs.

Parameters:

objectType - the type of the object the operation takes place

objectId - the id of the object the operation takes place

userInformation - the user information

context - the context information

defaultResult - the default result that should be returned if no one votes, must not be null

Returns:

the authorization result, never returns null

Since:

1.1

makeEffectiveUserInformation

protected org.eclipse.scada.utils.concurrent.NotifyFuture<org.eclipse.scada.sec.UserInformation> makeEffectiveUserInformation(AbstractSessionImpl session,
                                                                                                                  String targetUser,
                                                                                                                  org.eclipse.scada.sec.callback.CallbackHandler handler)

Since:

1.1