Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

You can create customized ACL rules to secure allow securing access to objects and operations depending on your needs while handling your daily tasks.

Tip

Role required: security_admin.

Elevate your privileges to this role to create or perform any other operations with ACL rules.

To create an ACL rule, please complete the following steps:

  1. Navigate to the System Security → Access Control (ACL).
  2. Click New and fill in the fields.
  3. Click Save or Save and Exit to apply changes.
Tip

ACL check is performed using three fields combined:

  1. Roles
  2. Condition
  3. Script.

If the user does not have any role specified in the Role ID field, after this Roles field of the ACL rule is empty, the next step is the condition check, if there is any specific condition was put down. If the condition Condition field is empty, then the Script field is to check for the specific conditions, attributes, or checks.

If any of these steps fail, then the ACL check fails, too.

This basic scheme can be helpful for understanding.The scheme below represents the ACL check process:


Access control fields

FieldMandatoryDescription
NameYrecord name or the table and field names.

This field is read-only and will be populated automatically by the system after saving the record.

The

name of the object to secure, either the 

word in square brackets indicates the operation. The name after the first period indicates the secured table, and the column (if there is one specified in the Column field) after another period:

[Delete].sys_history

[Read].sys_history.created_by

Info

This field supports wildcard character asterisk (*) in place of a record, table, or field name

to select all objects that match

, which allows selecting all objects matching a record type, all tables, or all fields.

A wildcard character and a text search cannot be combined.

For example, pro* is not a valid ACL rule name, but

Good

problem.*

and

*.task

are valid ACL rule names.

Badpro*



OperationY

Select the operation

this ACL secures

to secure. Available options:

  • create
  • read
  • write
  • delete.
Info

One ACL rule can secure only one operation. To secure over one operation, create a separate ACL rule for each of them.


Any TablesNIf Select this checkbox is selected, then the ACL rule will secure ALL to secure all tables in the system. When it checkedselected, the table Table field will be hidden until unchecked.
TableYSelect

Specify a table to be secured.

If you want to

Info

One ACL rule can secure only one table. To secure over one table, create a separate ACL rule for each of them.

This field is mandatory.


DescriptionNEnter a description of the object or permissions this ACL rule secures.
RolesN

Specify the role that the user must have required to pass this the ACL check. After  After the role is specified, the users that who do not have this role will not pass this check.

More than one role can be selectedYou can select several roles.

Info

Roles are chosen out of the Roles (sys_role) dictionary.


ActiveNIf this checkbox is selected, then this ACL rule is active.
Admin OverridesN

If Select this checkbox is selected, then users for the system administrators (with the admin role automatically ) to pass the permissions check for this ACL rule automatically. Admin users pass will access the object or operation regardless of what script or role restrictions applythe existing restrictions.

Clear this checkbox if these users must take security checks specified in this ACL rule to get access to to have the system administrators take the security checks to access the secured object. Use

Define filters in the condition builder or in the Script field to create a permissions check that administrators must passadmin users must meet to get access.

Any FieldsNIf this checkbox is selected, then the ACL rule will secure ALL all columns in the system. When it checked, the column Column field will be hidden until unchecked,.
ColumnN

Select a column to be secured.

Info

One ACL rule can secure only one column. If you want to secure over one column, create a separate ACL rule for each of them.


ConditionNUse this condition builder to select the

Define permissions to be met by selecting fields and values

that must be met for users to access the object

in the condition builder.

ScriptNHere you can enter

Specify a

custom

script

describing

implementing the permissions

required

to

access the object

be met. The script must return

an answer variable set to a value of true or false.

an answer variable equal to 'true' or 'false'.

Image AddedImage Removed