Allowlists and Denylists#

sys-admin

VOSS Automate supports allowlists and denylists to specify parameters that cause the workflows attached to your data sync to run. These are defined via the system Global Settings; typically available to sysadmin users in the system.

Allowlists and denylists specify the fields on the device model that trigger workflows attached to a sync, when they change. The allowlist defines the fields that will trigger the workflow when they change, while all other fields are ignored. The denylist indicates the fields that will be ignored if they change, and won’t trigger the workflow.

Note

Allowlists and denylists affect “Update” workflows only, and are used to prevent unnecessary “Update” workflows from triggering on data syncs.

Workflows for “Add” or “Delete” are triggered regardless of any allowlist or denylist entries.

The allowlist takes priority over the denylist if both are defined for the model; thus, choose one approach or the other. The recommendation is to use allowlists, as these are more explicit regarding the fields that will trigger the change. Regardless if a workflow is running or not, the model is updated in Automate, so the changed field is pulled in - it just will not initiate a workflow to do anything further (e.g update data/User).

The system ships with a number of predefined allowlists and denylists, which provide a starting point for optimized syncs. See the Best Practices Guide for more guidance on using the lists for given technologies and the default behavior.

Allowlists and denylists are typically used to keep syncs efficient, particularly for high volume elements (such as users). There are a number of fields pulled in from the devices that are useful to view, but do not require any specific processing (for instance fields like last login time, etc). So the default lists are based on a typical setup and help provide out-of-the-box optimization. For the most part, these will not need to be adjusted, but can be if required to meet a specific need in a deployment.