org.cyclos.security.access

Class AccessClientServiceSecurity

java.lang.Object

org.cyclos.impl.AbstractServerComponent

org.cyclos.impl.AbstractNetworkedServerComponent

org.cyclos.security.BaseServiceSecurity

org.cyclos.security.CRUDServiceSecurity<AccessClientDTO,AccessClient,AccessClientData,AccessClientDataParams>

org.cyclos.security.access.AccessClientServiceSecurity

All Implemented Interfaces:

AccessClientService, CRUDService<AccessClientDTO,AccessClientData,AccessClientDataParams>, CRUDWithConfirmationPasswordService<AccessClientDTO,AccessClientData,AccessClientDataParams>, Service

@Security
public class AccessClientServiceSecurity
extends CRUDServiceSecurity<AccessClientDTO,AccessClient,AccessClientData,AccessClientDataParams>
implements AccessClientService

Security layer for AccessClientService

Author:

luis

Field Summary

Fields inherited from class org.cyclos.security.CRUDServiceSecurity

entityClass

Constructor Summary

Constructors

Constructor and Description
AccessClientServiceSecurity()

Method Summary

Modifier and Type	Method and Description
ActivateAccessClientDTO	activate(java.lang.String activationCode, java.lang.String prefix) Activates an access client for the current user, using the given activation code.
void	block(AccessClientActionParams params) Blocks the given an access client
protected void	checkCreateNew(AccessClientDataParams params) Checks whether creating new entities with the given context parameters is allowed, throwing PermissionDeniedException if not
protected void	checkSearch()
protected void	customizeData(AccessClientData data) Can be overridden in order to process the returned data object for the given entity
protected boolean	doHasAccess(AccessClient entity, com.querydsl.core.types.Path<java.lang.Boolean> path)
protected boolean	doHasAccess(AccessClient entity, com.querydsl.core.types.Path<java.lang.Boolean> path, boolean forCreate)
protected boolean	doHasAccess(User user, AccessClientPrincipalType type, com.querydsl.core.types.Path<java.lang.Boolean> path)
protected boolean	doHasAccess(User user, AccessClientPrincipalType type, com.querydsl.core.types.Path<java.lang.Boolean> path, boolean forCreate)
protected boolean	doHasManageAccess(AccessClient entity) Should be implemented in order to return whether the caller is allowed to manage the given entity, for the given operation
boolean	doHasViewAccess(AccessClient entity) Should be implemented in order to return whether the caller is allowed to view the given entity.
java.lang.String	getActivationCode(AccessClientActionParams params) Returns the code which can be used to activate the access client, connecting an application
protected CRUDServiceLocal<AccessClient,AccessClientDTO,AccessClientData,AccessClientDataParams>	getImplementation() Should be implemented in order to return the actual implementation of the service
AccessClientsListData	getListData(PrincipalTypeVO principalTypeVO, UserLocatorVO locator) Returns data for listing access clients of a given type and user
AccessClientsSearchData	getSearchData() Returns data for searching access clients
java.util.List<AccessClientTypeData>	getTypeData(UserLocatorVO locator, ChannelVO channel) Returns data each access client type the authenticated user can see for the given user.
boolean	isAccessible(SessionData sessionData, AccessClient entity) Must be implemented in order to determine whether the given entity is accessible for the given session data.
AccessClientVO	locate(AccessClientLocator locator) Returns an access client by either id or token, but only if it belongs (or is managed by) the authenticated user
Page<AccessClientDetailedVO>	search(AccessClientQuery query) Searches for access clients according to the given criteria
void	unassign(AccessClientActionParams params) Unassigns the given access client from its connected application
void	unassignCurrent(ActionWithConfirmationPassword action) Unassigns the access client in the current authorization.
void	unblock(AccessClientActionParams params) Unblocks the given access client

Methods inherited from class org.cyclos.security.CRUDServiceSecurity

canPerformOperation, canViewHistoryLog, checkManageAccess, checkOperation, checkViewAccess, find, getConfirmationPasswordInputForRemove, getData, getDataForNew, getEntityClass, hasManageAccess, hasViewAccess, load, onBeforeSave, remove, removeAll, removeAllWithConfirmationPassword, removeWithConfirmationPassword, resolveEntityCheck, save, saveWithConfirmationPassword

Methods inherited from class org.cyclos.security.BaseServiceSecurity

checkGuest, checkId, checkIds, checkInternalName, checkLoggedIn, checkManagesUser, checkRelatesToUser, checkVO, checkVOs, doInitialize, getEntityCheckRegistry, getUser, initialize

Methods inherited from class org.cyclos.impl.AbstractNetworkedServerComponent

canManage, checkManagesUser, checkPermission, checkRelatesToUser, checkValue, clearAlreadyValidated, getAccountHandler, getAuthHandler, getBaseEntityManagerHandler, getChannelConfiguration, getConfiguration, getConversionHandler, getCustomFieldValueHandler, getEntityManagerHandler, getGroupsHandler, getLoggedBasicUser, getLoggedUser, getProducts, getProductsHandler, getReportHandler, getTranslatedName, getTranslatedValue, getUserLocatorHandler, getValidationResult, hasPermission, hasValue, inSameNetwork, inSameNetworkOrGlobal, isAdmin, isAlreadyValidated, isBroker, isGlobalAdmin, isGlobalAdminInNetwork, isGuest, isLoggedIn, isMember, isNetworkAdmin, isOperator, isRelatedToUser, isSystem, isUserManager, isUserManagerOf, message, message, permission, permission, permissionOptionalValue, permissionOptionalValue, toDate, toDateTime, validate

Methods inherited from class org.cyclos.impl.AbstractServerComponent

delete, detach, find, flush, from, getApplicationContext, getConfigurationHandler, getDataTranslationHandler, getFormatter, getFormatter, getFormatter, getLogger, getNotificationHandler, getProfileFieldHandler, getRemoteAddress, getSessionData, getTransactionHandler, getTranslationHandler, message, message, persist, processBatch, refresh, remove, subQuery, update

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.cyclos.services.CRUDService

getData, getDataForNew, load, remove, removeAll, save

Constructor Detail

AccessClientServiceSecurity

public AccessClientServiceSecurity()

Method Detail

activate

public ActivateAccessClientDTO activate(java.lang.String activationCode,
                                        java.lang.String prefix)
                                 throws FrameworkException

Description copied from interface: AccessClientService

Activates an access client for the current user, using the given activation code. It is possible to pass in a prefix (optional) to have it appended before the activation code itself. Returns a dto containing the principal type and a token which is then used to identify the remote application. The prefix is not returned. So, if for example, "123" is passed as prefix, and "ABCDEF", the token needed to be used on web service requests will be "123ABCDEF", but only "ABCDEF" is returned. If the prefix is null, no prefix is used.

Specified by:

activate in interface AccessClientService

Throws:

FrameworkException

block

public void block(AccessClientActionParams params)
           throws FrameworkException

Description copied from interface: AccessClientService

Blocks the given an access client

Specified by:

block in interface AccessClientService

Throws:

IllegalActionException - When the status is not active

FrameworkException

doHasViewAccess

public boolean doHasViewAccess(AccessClient entity)

Description copied from class: CRUDServiceSecurity

Should be implemented in order to return whether the caller is allowed to view the given entity.

Specified by:

doHasViewAccess in class CRUDServiceSecurity<AccessClientDTO,AccessClient,AccessClientData,AccessClientDataParams>

getActivationCode

public java.lang.String getActivationCode(AccessClientActionParams params)
                                   throws FrameworkException

Description copied from interface: AccessClientService

Returns the code which can be used to activate the access client, connecting an application

Specified by:

getActivationCode in interface AccessClientService

Throws:

IllegalActionException - When the status is not unassigned

FrameworkException

getListData

public AccessClientsListData getListData(PrincipalTypeVO principalTypeVO,
                                         UserLocatorVO locator)
                                  throws FrameworkException

Description copied from interface: AccessClientService

Returns data for listing access clients of a given type and user

Specified by:

getListData in interface AccessClientService

Throws:

FrameworkException

getSearchData

public AccessClientsSearchData getSearchData()
                                      throws FrameworkException

Description copied from interface: AccessClientService

Returns data for searching access clients

Specified by:

getSearchData in interface AccessClientService

Throws:

FrameworkException

getTypeData

public java.util.List<AccessClientTypeData> getTypeData(UserLocatorVO locator,
                                                        ChannelVO channel)
                                                 throws FrameworkException

Description copied from interface: AccessClientService

Returns data each access client type the authenticated user can see for the given user. If a channel is passed in, will only return types that can be used to access it.

Specified by:

getTypeData in interface AccessClientService

Throws:

FrameworkException

isAccessible

public boolean isAccessible(SessionData sessionData,
                            AccessClient entity)

Description copied from class: CRUDServiceSecurity

Must be implemented in order to determine whether the given entity is accessible for the given session data. This method shouldn't check the same condition as CRUDServiceSecurity.hasViewAccess(BaseEntity). If the only condition for an entity is CRUDServiceSecurity.hasViewAccess(BaseEntity), this method should return false.

Specified by:

isAccessible in class CRUDServiceSecurity<AccessClientDTO,AccessClient,AccessClientData,AccessClientDataParams>

locate

public AccessClientVO locate(AccessClientLocator locator)
                      throws FrameworkException

Description copied from interface: AccessClientService

Returns an access client by either id or token, but only if it belongs (or is managed by) the authenticated user

Specified by:

locate in interface AccessClientService

Throws:

FrameworkException

search

public Page<AccessClientDetailedVO> search(AccessClientQuery query)
                                    throws FrameworkException

Description copied from interface: AccessClientService

Searches for access clients according to the given criteria

Specified by:

search in interface AccessClientService

Throws:

FrameworkException

unassign

public void unassign(AccessClientActionParams params)
              throws FrameworkException

Description copied from interface: AccessClientService

Unassigns the given access client from its connected application

Specified by:

unassign in interface AccessClientService

Throws:

IllegalActionException - When the status is unassigned

FrameworkException

unassignCurrent

public void unassignCurrent(ActionWithConfirmationPassword action)
                     throws FrameworkException

Description copied from interface: AccessClientService

Unassigns the access client in the current authorization. No-op if not authorized as an access client.

Specified by:

unassignCurrent in interface AccessClientService

Throws:

FrameworkException

unblock

public void unblock(AccessClientActionParams params)
             throws FrameworkException

Description copied from interface: AccessClientService

Unblocks the given access client

Specified by:

unblock in interface AccessClientService

Throws:

IllegalActionException - When the status is not blocked

FrameworkException

checkCreateNew

protected void checkCreateNew(AccessClientDataParams params)

Description copied from class: CRUDServiceSecurity

Checks whether creating new entities with the given context parameters is allowed, throwing PermissionDeniedException if not

Specified by:

checkCreateNew in class CRUDServiceSecurity<AccessClientDTO,AccessClient,AccessClientData,AccessClientDataParams>

checkSearch

protected void checkSearch()

customizeData

protected void customizeData(AccessClientData data)

Description copied from class: CRUDServiceSecurity

Can be overridden in order to process the returned data object for the given entity

Overrides:

customizeData in class CRUDServiceSecurity<AccessClientDTO,AccessClient,AccessClientData,AccessClientDataParams>

doHasAccess

protected boolean doHasAccess(AccessClient entity,
                              com.querydsl.core.types.Path<java.lang.Boolean> path)

doHasAccess

protected boolean doHasAccess(AccessClient entity,
                              com.querydsl.core.types.Path<java.lang.Boolean> path,
                              boolean forCreate)

doHasAccess

protected boolean doHasAccess(User user,
                              AccessClientPrincipalType type,
                              com.querydsl.core.types.Path<java.lang.Boolean> path)

doHasAccess

protected boolean doHasAccess(User user,
                              AccessClientPrincipalType type,
                              com.querydsl.core.types.Path<java.lang.Boolean> path,
                              boolean forCreate)

doHasManageAccess

protected boolean doHasManageAccess(AccessClient entity)

Description copied from class: CRUDServiceSecurity

Should be implemented in order to return whether the caller is allowed to manage the given entity, for the given operation

Specified by:

doHasManageAccess in class CRUDServiceSecurity<AccessClientDTO,AccessClient,AccessClientData,AccessClientDataParams>

getImplementation

protected CRUDServiceLocal<AccessClient,AccessClientDTO,AccessClientData,AccessClientDataParams> getImplementation()

Description copied from class: CRUDServiceSecurity

Should be implemented in order to return the actual implementation of the service

Specified by:

getImplementation in class CRUDServiceSecurity<AccessClientDTO,AccessClient,AccessClientData,AccessClientDataParams>