This page explains record-level security and how to configure it on your record types with data sync enabled.

Overview

Securing your enterprise data is a critical and often difficult experience, especially when you need to control who can see which rows of your data. Configuring this type of row-level security often requires technical leads and data experts to implement and maintain your security logic—but that's not the case with Appian Records. We make it easy to secure your enterprise data at this granular level using record-level security.

You can configure record-level security directly on your record types with data sync enabled. This means you can configure your security more dynamically since you can leverage record fields, groups, constants, and more to define your security logic. Since you're leveraging your synced data, you can also use related record fields in your configurations so you can define your security requirements using data from different systems.

Once you configure your security requirements and save your record type, Appian will automatically and performantly enforce your security anywhere you reference the record type. With record-level security, you can focus on building your interfaces, reports, and queries, while Appian takes care of ensuring users can only see the appropriate data.

About record-level security

Record-level security allows you to specify who can view which records.

By default, any user with Viewer permissions in the record type can see all available records. However, your enterprise may have more strict guidelines around who can see which data.

For example, in a support case application, administrators should be able to see all cases, but support engineers should only see their assigned cases, and account managers should only see cases related to their customers.

To determine which users can see specific records, you can configure record-level security on your record types with data sync enabled.

Record-level security is layered on top of your object security. This means that users must have permission to view the record type and permission to view the records. For example, if an Administrator has Administrator permission for the record type, but is not included in the record-level security, then they will not see any records.

By applying record-level security on top of your object security, you can control security at a more granular level and ensure your data is only visible to the appropriate users.

For example, if you apply record-level security to the support case example above, administrators and support engineers would see different records when looking at the same Case Burndown report.

Records visible to an administrator:

Records visible to a support engineer:

You can configure record-level security on your record types using one of the following options:

• Security rules: Allows you to configure even your most complex security requirements using a simple and easy-to-maintain experience.
• Security expression: Allows you to configure an expression using a series of filter conditions to define who can see which records.

The table below outlines the key differences between these two options:

Security rules

Security rules allow you to translate your complex security requirements into plain language by answering two questions: who is a part of this rule? and which records can they view?

Who is a part of this rule?

The first element of a security rule is defining who is a part of your rule.

In this section, you can specify the users assigned to a security rule by selecting one of the three options:

• Users found in groups
• Users found in fields
• Users who can view related records

Let's look at some examples of when you'd use one membership option versus another.

Users found in groups

The Users found in groups option allows you to assign users found in one or more groups to your security rule. When you select more than one group, the security rule will be applied to any user who belongs to any of the selected groups.

Consider using this option when you want to assign multiple users to a security rule.

For example, in a support application, you want administrators and executives to be able to see all cases in the Case record type. To configure this security requirement, you can create a security rule that specifies that any users found in the Administrators group or the Executives group can see all cases.

Any time you add new users to your groups, they will be automatically assigned to the security rule.

Users found in fields

The Users found in fields option assigns any users found in a User or Group field to your security rule.

This provides a more dynamic configuration option since your security requirements are defined by your data. You can select record fields or related record fields in your configuration.

For example, in a support case application, you only want support engineers to view cases that they're assigned to. In the Case record type, you can add a new security rule that specifies that if a user is found in the assignedEngineer field (which is type User), then they can see the case.

With this configuration, support engineers will only ever see their assigned cases. If the data changes, and a support engineer is no longer assigned to a support case, the security rule will automatically reflect your data change so they can no longer see the case.

To learn how to configure a record field as type User or Group, see Change record field names and data types.

Users who can view related records

The Users who can view related records option assigns any users who can see related records to the security rule. This option leverages your record type relationships so you can extend the existing security rules on a related record type to the base record type.

For example, in a support case application, let's say you only want account managers to view cases related to their customers. The security rules on the Customer record type define which account managers can see which customers. If you select this option on the Case record type, then select the customer relationship, you can extend the Customer security rules to the Case record type.

Now, any user who can view a customer can also see that customer's cases.

If you select a one-to-many relationship in your security rule, then users who can see at least one related record can also see the base record.

For example, let's say you need to extend security rules from the Case record type to the Customer record type. On the Customer record type, you can use this option and select the case relationship so any users who can see at least one case can also see the customer.

With this option, you can avoid recreating security rules across numerous record types by simply inheriting the security rules from a related record type.

Which records can they view?

Once you've assigned users to the security rule, you can add security conditions to define which records they can view.

Depending on how you assigned users to the security rule, Appian applies certain default security conditions:

These default conditions are automatically applied and cannot be modified. You can, however, add additional conditions as necessary.

For example, let's say you only want account managers to view customer cases created in the last month.

To configure this security requirement, you would first select the Users who can view related records option so any user who can view a customer can also see their cases. Then, you can add an additional security condition so that those users can only see cases greater than or equal to the beginning of last month.

As shown in the image above, security conditions are made up of fields, operators, and values. Depending on the selected field, your operator and value options will change.

Fields

The field picker contains all record fields and relationships defined in the record type. However, depending on how you assigned users to the security rule, the fields available for selection will vary:

If you create multiple conditions against fields from the same one-to-many relationship, then Appian will combine those filters using the AND_ALL operator.

For example, let's say you only want support engineers to view a customer if they are assigned to an active case for that customer and that case has a service-level agreement (SLA) status of "On Time."

The security rule configuration would look something like this:

Since the security conditions reference fields from the same one-to-many relationship, the AND_ALL operator will be applied so that only users who meet all of the security conditions can see the record.

Operators

The operator list displays all of the operators that can be applied to the selected field. Only operators that are compatible with the data type of the selected field display.

The following tables explains the behavior of each available operator:

Values

You can select how you want to pass in the condition value using the value context menu. The options in the context menu change based on the data type of the selected field. You can enter a static text value, or use a constant to determine the value the field must evaluate to in order for users to view the record.

Add security rules

To add a security rule:

1. In the record type, go to Record-Level Security.
2. Click NEW SECURITY RULE. The Create New Security Rule dialog opens.
3. Choose Who is a part of the rule:
   • Users found in groups.
   • Users found in fields.
   • Users who can view related records.

4. Determine Which records can they view by adding one or more security conditions. Depending on the members you assigned to the security rule, your configuration may differ:

   If you selected…	Then…
   Users found in groups	Select Only records where… to configure a security condition.
   Users found in fields	A default security condition is applied where users can only see records where they are listed as the user or group in that field. To add more conditions, click + Add Additional Conditions.
   Users who can view related records	A default security condition is applied where users can only see records if they can see the related record in the related record type. To add more conditions, click + Add Additional Conditions.

5. To configure a security condition:
   • Use the field picker to choose a record field or related record field.
   • Select an operator to apply to the selected field.
   • Enter a static text value, or use a constant to determine the value the field must evaluate to in order for users to view the record.
   • Click + Add Condition to add additional security conditions. Use the OR/AND operator to determine how the security conditions are evaluated.
   • Click Add Condition Set to compare a set of conditions against another set of conditions.

6. Click CREATE.

   Tip:  If you want to add another security rule immediately after creating one, click CREATE AND ADD ANOTHER RULE instead.

7. To add additional security rules, click NEW SECURITY RULE.
8. In Test Security Rules, enter the name of a user in your environment.
9. Click TEST to see the number of records visible to the selected user.

10. Click PREVIEW RECORDS to see a list of records visible to the selected user.

    Note:  When previewing record data, you can only see records that both you and the selected user have access to view.

    

    

11. Click SAVE CHANGES to save and apply your security rules.

Manage security rules

Once you create a security rule, you can disable, edit, or delete the rule as needed.

Disable security rules

To disable or enable a security rule:

1. In the record type, go to Record-Level Security.
2. Use the toggle next to a security rule to disable and enable the security rule.

When a security rule is disabled, it will not be evaluated when testing the rules or anywhere throughout the application. If you disable all security rules, any user with Viewer permissions for the record type can view all records.

Edit security rules

To edit a security rule:

1. In the record type, go to Record-Level Security.
2. Next to the security rule, click the icon.
3. Update any necessary configurations.
4. Click OK.
5. Click SAVE CHANGES to save and apply your updated security rule.

Delete security rules

To delete a security rule:

1. In the record type, go to Record-Level Security.
2. Next to the security rule, click the icon.
3. Click DELETE.
4. Click SAVE CHANGES to update your record-level security.

If you delete all security rules, any user with Viewer permission for the record type can view all records.

Security expression

Although security rules allow you to configure the majority of use cases, you may choose to configure a security expression if you need to create more complex conditions.

Security expressions allow you to create a series of filter conditions using a!queryFilter() or a!queryLogicalExpression() to define which records are available to users based on the conditions you specify.

Each filter defines a condition that must be true for a record to appear in queries to the record type. If you have multiple conditions, the record must meet all conditions in order to appear.

For example, in a support case application, let’s say you only want users to see all unassigned cases if they are a member of the Support group, and are not currently assigned to a case. Since the membership conditions are more complex, you could configure a security expression on the Case record type that looks something like this:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
if(
    and(
        a!isUserMemberOfGroup(loggedInUser(), cons!CSA_SUPPORT_GROUP),
        not(recordType!Case.fields.assignedEngineer)
    ),
    a!queryFilter(
        field: recordType!Case.fields.assignedEngineer,
        operator: "is null"
    ),
    a!queryFilter(
        field: recordType!Case.fields.assignedEngineer,
        operator: "=",
        value: loggedInUser()
    )
)

However, there are two limitations to using a security expression:

• You cannot also configure security rules in the record type.
• Related record types cannot inherit this security like they can with security rules.

This means that you would need to expand your security expression to include all possible users, like account managers and administrators, so they only see the appropriate records. Additionally, related record types like the Customer record type, cannot inherit the security expression.

For easy maintenance, we recommend using security rules on your record types.

Add a security expression

To add a security expression:

1. In the record type, go to Record-Level Security.
2. Click Configure a security expression.
3. In the expression editor, enter an expression that returns a list of queryFilter or queryLogicalExpression.
4. Click CREATE.
5. Click SAVE CHANGES to save and apply your security expression to the record type.

Edit the security expression

Once you define your security expression, you can edit it at any time.

To edit the security expression:

1. In the record type, go to Record-Level Security.
2. In the Expression, make any necessary updates to your security expression.
3. Click SAVE CHANGES to save and apply your updated security expression.

Replace a security expression with security rules

If you decide that you'd rather maintain your record-level security using security rules, you can remove the security expression and use security rules instead.

To replace a security expression with security rules:

1. In the record type, go to Record-Level Security.
2. Select the Security Rules radio button at the top of the page. A banner will appear that mentions your security expression will be removed and replaced by security rules.
3. Add a new security rule.
4. Click SAVE CHANGES to save and apply your security rules.