Define access rules for an agentic workflow

task brazil Updated Oct 16, 2026 3 min read define-sec-aw-new.md
Raw file servicenow.com

Define security controls for an agentic workflow to determine which users can access it and what permissions they have.

Before you begin

Role required: sn_aia.admin

About this task

The Access rules section is divided into two parts: Which users can access this agentic workflow (ACLs) and Which data this agentic workflow can access. The former creates an ACL that determines who can discover or invoke the agentic workflow. The latter defines the data that the agentic workflow has access to once it's invoked.

See Security for AI agents for more information about creating ACLs and user identities for security for AI agents.

Procedure

  1. Define user access by selecting an option from the Allowed users dropdown.

    The dropdown menu options are:

    • Users with specified roles
    • Authenticated users
    • Public If you select Users with specified roles, you can select exactly which roles can access the agentic workflow.

    Agentic workflows installed with AI applications each require specific roles. To learn which roles are needed for agentic workflows associated with ServiceNow Otto applications, consult the documentation for the agentic workflow.

    Selecting Public means anyone who can reach the instance can invoke the agent. Use it only for agents that expose no record data. Public should be used sparingly.

    An access control list (ACL) is generated based on the roles you select. Saving triggers the creation of an ACL for your agentic workflow. If you want to make changes later, you can return to the guided setup and change the options here. If you have the correct elevated role, you can also make edits directly on the ACL table.

  2. Define data access by selecting a user identity type from the Identity type dropdown.

    The user identity determines what data the agentic workflow can read and write while it runs.

    The two options are Dynamic user and AI user. The dynamic user is the user invoking the agentic workflow or the dynamic user of the agentic workflow calling on the agentic workflow. An AI user is a dedicated user that has its own specified roles that allow access, which could be more than the dynamic user. Every invocation reads and writes with the AI user's roles regardless of who started it.

    If you do not have an AI user but want to use the AI user identity, you need to create a new record on the User table. See Create a user. Select AI user as the identity type.

    If you select Dynamic user, you can select the Approved roles that the agentic workflow runs with. By default, an agentic workflow runs as a dynamic user and has the roles of the invoking user. Select the approved roles to limit the data access that an agentic workflow could have. Role filtering must be applied for all AI agents and agentic workflows to run as dynamic users. If you don't select any roles, the agent inherits whatever roles the invoking user holds.

    To override the role filtering requirement for a specific agentic workflow or AI agent, admins with the correct elevated access can create an approved list of roles for a given agentic workflow. Then, they can access that role filtering record in the Agent Access Role Configurations table [sys_agent_access_role_configuration], and select the allow all roles check box. Taking these steps deactivates the requirement for a role filtering approved roles list in AI Agent Studio, so the AI admin can return to AI Agent Studio and continue to configure the agentic workflow or AI agent without role filtering applied.

    Note: Role filtering should be applied as security best practice and adherence to the principle of least privilege. Overriding the role filtering requirement isn't recommended.

    When testing an agentic workflow, run the agentic workflow with different roles to confirm that only the correct data is accessed for the user audience.

    [Omitted image "ai-setup-sec-controls-aw.png"] Alt text: Security controls configuration for agentic workflows showing user access and data access.

Result

You have created an ACL that determines who can discover and access your agentic workflow, and you have assigned a user identity (and role filtering, if relevant) to the agentic workflow to determine what data it can access.

What to do next

Scroll down to the next section of the guided setup, Triggers, to define specific conditions where the agentic workflow should run. Adding triggers is optional.

Search documentation
Search document titles and file paths on the brazil branch