ACL

1. ACL Terminology

The Access Control List (ACL) can be understood using the analogy of a file system.

• ACL resource: Think of an ACL resource as a file or a directory in a file system. A resource can be any element in your component's template that has the *aclTag attached to it or any form control that is bound with the ACL engine in your component's form. A resource can also have children resources, so a resource could also be an entire Building Block or an entire page. Each resource has a name to identify it (think "file name", see below) and it has a path that includes the names of the parent resources (think "file path", see below).
• ACL resource name: A resource name is the ACL equivalent of a "file name". It is what you provide as the input to the *aclTag directive: <div *aclTag="'this-is-the-name'"> or the name of a form control. Every resource has to have a unique name in its current parent resource like a "file name" also has to be unique in its directory. There may be ACL resources with the same name if they exist under different parents, like section1/title and section2/title.
• ACL resource path: A resource path corresponds to a "file path". It uniquely identifies a given resource. Like in a (Unix) file system, it represents the hierarchy of resources that lead to the resource in question, separated by forward slashes: (e.g., page/building-block/section/title).