Skip to content

Access - *.access

Declarative URL access rules. Synchronizer: AccessSynchronizer. Engine: engine-security. Enforced at request dispatch before any controller, JS module, or static resource is invoked.

File format

json
{
    "constraints": [
        {
            "path": "/services/ts/myproject/admin/*",
            "method": "*",
            "scope": "HTTP",
            "roles": ["admin", "ops"]
        },
        {
            "path": "/services/ts/myproject/public/*",
            "method": "GET",
            "scope": "HTTP",
            "roles": []
        }
    ]
}

Fields

FieldNotes
pathURL pattern. Supports * wildcards.
methodHTTP method, "*" for any.
scope"HTTP" for URL routes; other scopes reserved for future use.
rolesAny-of role list. Empty list -> publicly accessible.

Evaluation

Rules are matched in declaration order; the first match wins. Super-roles DEVELOPER and ADMINISTRATOR pass any check. Anonymous mode short-circuits roles evaluation - see /help/concepts/security-model.

For controller-method-level checks prefer the @Roles annotation - see /help/develop/security-and-roles.

Editor

Authored via the Access editor or raw JSON in Monaco.

See also

Released under the EPL-2.0 License.