Introduction
On this page all the generic security filters are listed, In general, they can be applied to all possible DB entities of the CoreOne Suite.
Filter
GenericFullAccessFilter
This filter will give you unrestricted access to the entity for the chosen DB operation.
/// <typeparam name="TDtoType">The interface type of the db entity the full access should be applied to</typeparam> GenericNoAccessFilter<TDtoType>
Example
new GenericNoAccessFilter<ICoreIdentity>()
GenericNoAccessFilter
This filter will give you no access to the entity for the chosen DB operation
/// <typeparam name="TDtoType">The interface type of the db entity the no access should be applied to</typeparam> new GenericNoAccessFilter<TDtoType>();
Example
new GenericNoAccessFilter<ICoreIdentity>()
Sub Filters
The sub-filters will give you access to an entity based on the configured security of a related entity.
For example, because I have read rights to the core identity, I’m allowed to read its attribute values.
GenericSubFiltersFilter
This filter will give access to the DB entity only when the filter for the referenced object matches the chosen security mode as well.
This filter can be used for up to four reference types, then all four security filters have to match in an and combination.
/// <typeparam name="TDtoType">The interface type of the db entity this security filter should be applied to</typeparam> /// <typeparam name="TReferenceDtoType">The interface type of the db entity where the security should be taken from</typeparam> /// <param name="referenceSecurityMode">What security mode should be check for TReferenceDtoType</param> /// <param name="referenceProperty">How the system can resolve TReferenceDtoType from TDtoType</param> GenericSubFiltersFilter<TDtoType, TReferenceDtoType>(SecurityMode referenceSecurityMode, Expression<Func<TDtoType, TReferenceDtoType>> referenceProperty) GenericSubFiltersFilter<TDtoType, TReferenceDtoType1, TReferenceDtoType2>(SecurityMode referenceSecurityMode, Expression<Func<TDtoType, TReferenceDtoType1>> referenceProperty, SecurityMode referenceSecurityMode2, Expression<Func<TDtoType, TReferenceDtoType2>> referenceProperty2) ... GenericSubFiltersFilter<TDtoType, TReferenceDtoType1, TReferenceDtoType2, TReferenceDtoType3, TReferenceDtoType4>(SecurityMode referenceSecurityMode1, Expression<Func<TDtoType, TReferenceDtoType1>> referenceProperty1, SecurityMode referenceSecurityMode2,Expression<Func<TDtoType, TReferenceDtoType2>> referenceProperty2, SecurityMode referenceSecurityMode3, Expression<Func<TDtoType, TReferenceDtoType3>> referenceProperty3, SecurityMode referenceSecurityMode4,Expression<Func<TDtoType, TReferenceDtoType3>> referenceProperty4)
Example
new GenericSubFiltersFilter<IOrganizationUnitAttributeValue, IOrganizationUnit>(SecurityMode.Update, a => a.OrganizationUnit)
GenericCollectionSubFiltersFilter
This filter will give access to the DB entity only when the filter for the referenced object matches a least one item in the collection of referenced objects.
/// <typeparam name="TDtoType">The interface type of the db entity this security filter should be applied to</typeparam> /// <typeparam name="TReferenceCollectionDtoType1">The interface type of the db entity where the security should be taken from</typeparam> /// <param name="referenceDtoTypeSecurityMode">What security mode should be check for TReferenceCollectionDtoType1</param> /// <param name="referenceProperty">How the system can resolve TReferenceCollectionDtoType1 from TDtoType</param> GenericCollectionSubFiltersFilter<TDtoType, TReferenceCollectionDtoType1>(SecurityMode referenceDtoTypeSecurityMode, Expression<Func<TDtoType, IEnumerable<TReferenceCollectionDtoType1>>> referenceProperty)
Example
new GenericCollectionSubFiltersFilter<IEventHandlerType, IEventHandler>(SecurityMode.Read, n => n.EventHandlers)
Property Chain Filter
The property chain filters give access to the DB entity when the resolved value of the property of the chain matches the one of the filter values.
GenericPropertyChainFilter
/// <typeparam name="TDtoObject">The interface type of the db entity this security filter should be applied to</typeparam> /// <typeparam name="TFilterPropertyType">The type of the filters</typeparam> /// <param name="propertyChain">The path from the entity to the property that should be compared with the filter values</param> /// <param name="filterValues">The filter values that have to match with the property value</param> GenericPropertyChainFilter<TDtoObject, TFilterPropertyType>(Expression<Func<TDtoObject, TFilterPropertyType>> propertyChain, params TFilterPropertyType[] filterValues)
Example
new GenericPropertyChainFilter<IActivityButton, bool>(m => m.AllowExecutionAsOwner, true)
GenericPropertyChainStringFilter
This filter allows us to check the security with a text filter with some search behaviors like contains or start with.
/// <typeparam name="TDtoObject">The interface type of the db entity this security filter should be applied to</typeparam> /// <param name="propertyChain">The path from the entity to the property that should be compared with the filter values</param> /// <param name="stringFilterBehaviour">The behaviour how the filter will be applied to the property</param> /// <param name="filterValue">The filter string value</param> GenericPropertyChainStringFilter<TDtoObject> (Expression<Func<TDtoObject, string>> propertyChain, StringFilterBehaviour stringFilterBehaviour, string filterValue)
Possible values for stringFilterBehaviour
Equals, StartsWith, EndsWith, Contains
Example
new GenericPropertyChainStringFilter<ICoreIdentity, bool>(m => m.ReadOnlyDisplayName, StringFilterBehaviour.Contains,"Test")
GenericCollectionPropertyChainFilter
This filter allows checking a reference collection if one of these objects matches the filter value.
/// <typeparam name="TDtoObject">The interface type of the db entity this security filter should be applied to</typeparam> /// <typeparam name="TDtoCollectionObject">The interface type of the db entity of the related collection</typeparam> /// <typeparam name="TFilterPropertyType">The type of the filters</typeparam> /// <param name="propertyChain">The path from the entity to the property that should be compared with the filter values</param> /// <param name="subPropertyChain">The path to the collection of type TDtoCollectionObject</param> /// <param name="filterValues">The filter values that have to match with the property value</param> GenericCollectionPropertyChainFilter<TDtoObject, TDtoCollectionObject, TFilterPropertyType> (Expression<Func<TDtoObject, IEnumerable<TDtoCollectionObject>>> propertyChain, Expression<Func<TDtoCollectionObject, TFilterPropertyType>> subPropertyChain, params TFilterPropertyType[] filterValues)
My core identity filters
GenericMyCoreIdentityFilter / GenericMyCoreIdentityStringValueFilter
This filter gives you permission for the entity type only when your core identity id matches the value of the property chain.
/// <typeparam name="TDtoObject">The interface type of the db entity this security filter should be applied to</typeparam> /// <param name="propertyChain">The path to the property that will be compared it to the current core identity id</param> GenericMyCoreIdentityFilter<TDtoObject> (Expression<Func<TDtoObject, uint>> propertyChain) GenericMyCoreIdentityStringValueFilter<TDtoObject> (Expression<Func<TDtoObject, string>> propertyChain)
Example:
new GenericMyCoreIdentityFilter<IRoleAssignmentApproval>(i => i.CoreIdentity.Id))
GenericMyCoreIdentityCollectionFilter
This filter gives you permission for the entity type only when your core identity id is present in a related collection.
/// <typeparam name="TDtoObject">The interface type of the db entity this security filter should be applied to</typeparam> /// <typeparam name="TDtoCollectionObject">The interface type of the db entity of the related collection</typeparam> /// <param name="propertyChain">The path from the TDtoObject to the collection of TDtoCollectionObject</param> /// <param name="subPropertyChain">The path to the property that will be compared to the current core identity id</param> GenericMyCoreIdentityCollectionFilter<TDtoObject, TDtoCollectionObject> (Expression<Func<TDtoObject, IEnumerable<TDtoCollectionObject>>> propertyChain, Expression<Func<TDtoCollectionObject, uint>> subPropertyChain
Example:
new GenericMyCoreIdentityCollectionFilter<ICoreIdentityTypeAttributeMapping, ICoreIdentity>(ct => ct.CoreIdentityType.CoreIdentities, c => c.Id)
My user filters
GenericMyUserValueFilter/ GenericMyUserStringValueFilter
This filter gives you permission for the entity type only when your user id matches the value of the property chain.
/// <typeparam name="TDtoObject">The interface type of the db entity this security filter should be applied to</typeparam> /// <param name="propertyChain">The path to the property that will be compared it to the current user id</param> GenericMyUserValueFilter<TDtoObject> (Expression<Func<TDtoObject, uint>> propertyChain) GenericMyCoreIdentityStringValueFilter<TDtoObject> (Expression<Func<TDtoObject, string>> propertyChain)
Example:
new GenericMyUserValueFilter<IUser>(u => u.Id)
GenericMyUserCollectionFilter
This filter gives you permission for the entity type only when your user id is present in a related collection.
/// <typeparam name="TDtoObject">The interface type of the db entity this security filter should be applied to</typeparam> /// <typeparam name="TDtoCollectionObject">The interface type of the db entity of the related collection</typeparam> /// <param name="propertyChain">The path from the TDtoObject to the collection of TDtoCollectionObject</param> /// <param name="subPropertyChain">The path to the property that will be compared it to the current user id</param> GenericMyUserCollectionFilter<TDtoObject, TDtoCollectionObject> (Expression<Func<TDtoObject, IEnumerable<TDtoCollectionObject>>> propertyChain, Expression<Func<TDtoCollectionObject, uint>> subPropertyChain)
Example:
new GenericMyUserCollectionFilter<IRoleClaim, IUser>(r => r.Users, u => u.Id)
Context filter
The context filter allows structuring the security based on the context this filter was assigned with.
For example, based on the organization unit tree I get a security role assigned in the context of the current organization and this should allow me to read this one organization unit.
For the definition of what context should be compared to what property value the class ContextPropertyFilterDefintion is used.
/// <typeparam name="TDtoObject">The type of the entity you want to filter</typeparam> /// <param name="propertyChain">The path to the property you want to compare with the context</param> /// <param name="contextType">The context type you want to use as filter</param> ContextPropertyFilterDefintion<TDtoObject> (Expression<Func<TDtoObject, uint>> propertyChain, CoreLoginAssignmentContextTypes contextType)
Example:
new ContextPropertyFilterDefintion<IEventHandler>(e => e.EventHandlerType.Id, CoreLoginAssignmentContextTypes.OrganizationUnit),
This example compares the value of the EventHandlerType.Id from IEventHandler to the context identifier of the type organization unit.
Possible context types:
OrganizationUnit, User
GenericContextPropertyChainFilter
This security filter gives you access to an entity when all property filters match the context this security filter was assigned with.
/// <typeparam name="TDtoObject">The interface type of the db entity this security filter should be applied to</typeparam> /// <param name="filter">The definition off what you want to filter</param> GenericContextPropertyChainFilter<TDtoObject> (ContextPropertyFilter<TDtoObject> filter)
Example:
new GenericContextPropertyChainFilter<IEventHandler>(new ContextPropertyFilter<IEventHandler>(new[]
{
new ContextPropertyFilterDefintion<IEventHandler>(e => e.EventHandlerType.Id, CoreLoginAssignmentContextTypes.OrganizationUnit),
new ContextPropertyFilterDefintion<IEventHandler>(e => e.Id, CoreLoginAssignmentContextTypes.User)
}));
GenericContextCollectionPropertyChainFilter
This security filter works similarly to the GenericContextPropertyChainFilter, with the difference that not the entity itself has to match the property filter, but the filter will be applied with an any to a related collection of entities.
/// <typeparam name="TDtoObject">The interface type of the db entity this security filter should be applied to</typeparam> /// <typeparam name="TDtoCollectionObject">The interface type of the db entity of the related collection</typeparam> /// <param name="propertyChain">The path from the TDtoObject to the collection of TDtoCollectionObject</param> /// <param name="filter">The definition off what you want to filter</param> GenericContextCollectionPropertyChainFilter<TDtoObject, TDtoCollectionObject> (Expression<Func<TDtoObject, IEnumerable<TDtoCollectionObject>>> propertyChain, ContextPropertyFilter<TDtoCollectionObject> filter)
Example
new GenericContextCollectionPropertyChainFilter<IEventHandler, IEventSubscription>(e => e.EventSubscriptions, new ContextPropertyFilter<IEventSubscription>(new[]
{
new ContextPropertyFilterDefintion<IEventSubscription>(e => e.EventHandler.Id, CoreLoginAssignmentContextTypes.OrganizationUnit),
new ContextPropertyFilterDefintion<IEventSubscription>(e => e.Id, CoreLoginAssignmentContextTypes.User)
}));