UiPath Documentation
delegate
latest
false
Delegate & Cartographer user guide

Security settings reference

Fine-grained local security controls in Delegate and Cartographer — tool permissions, terminal and files, protected files, and UI automation — that extend beyond Approval mode.

These settings live under Settings → Security, organized into four areas: Tool permissions, Terminal and files, Protected files, and UI automation.

Tool permissions​

Configure when Delegate needs your approval. Tools are organized into four top-level categories, each showing how many tools or operations it covers:

CategoryCovers
ConnectorsSlack, GitHub, Notion, Linear, Jira, Microsoft 365, and more
OfficeWord, Excel, PowerPoint, Outlook, Teams
System toolsFilesystem, web search, computer use, memory, shell
MCP serversAny MCP servers you have connected

Expanding a category breaks it down further. System tools, for example, splits into four groups:

GroupCoversDefault
Read-onlyReading files, searching the web, inspecting UI elements — operations that don't change anythingAllow
Write & modifyCreating or editing files, downloading files, generating imagesAsk
UI automationClicking, typing, or otherwise interacting with an appAsk
Shell & scriptRunning a PowerShell or Bash commandAsk

Each group can be set independently to Allow (run automatically), Ask (prompt first), or Block (deny automatically), and expands further to set individual operations on their own.

Connectors and Office follow the same read-only vs. write-and-modify principle at their own scale: each app or service (Outlook, Slack, Excel, and so on) breaks down into its own operations, generally split the same way — for example, reading a Slack channel or an Excel range is read-only, while posting a message or writing to a range is write — each set to Allow, Ask, or Block the same way as System tools.

MCP servers are handled the same way as the other categories, except the operations available depend entirely on which servers your organization has configured.

Terminal and files​

Delegate can run shell commands and scripts through the Shell command sandbox, currently in BETA: a scope-aware sandbox manager using Windows AppContainer for kernel-level file system, network, process, and credential isolation. See Scripting and code execution in Security overview for how the sandbox works conceptually.

Kernel isolation​

A toggle that turns the sandbox on or off for shell commands. When off, commands run with full user rights instead of the confined environment described in Security overview.

Paths​

Shell commands can access only the paths listed here; everything else is blocked. Add your own paths beyond the defaults.

Capabilities​

Additional capabilities you can grant to sandboxed shell commands, since they're outside what the sandbox allows by default. Internet access, Private network, and Removable storage are off by default; Shell profile is on by default:

  • Internet access (off by default) — lets sandboxed commands make outbound network connections (HTTP, HTTPS, etc.).
  • Private network (off by default) — lets sandboxed commands reach your local network or LAN.
  • Removable storage (off by default) — lets sandboxed commands read or write USB drives and external disks.
  • Shell profile (on by default) — loads your shell's profile (.zshrc, .bash_profile, or PowerShell profile) before running commands, so your usual aliases and environment variables are available.

Changes to these may require restarting the app to take effect.

Blocked commands​

Block specific types of commands from running — click a suggestion to add it, or type a custom pattern (for example, shutdown, format c:, netstat). These patterns are checked before execution: the agent's command is matched against them as regex and blocked before it runs. This is a separate mechanism from Kernel isolation, and applies regardless of whether the sandbox is on.

Protected files​

Delegate needs approval before accessing these files, grouped into categories by what they protect:

CategoryProtectsExample patterns
SecretsEnvironment files and credential stores.env, .env.*, secrets/*, credentials/*, .npmrc, .pypirc
KeysSSH keys and certificates.ssh/*, *.pem, *.key, *.p12, id_rsa, id_ed25519
CloudCloud provider credentials.aws/*, .azure/*, .gcloud/*, service-account*.json
ConfigProject configuration files — reading is unrestricted, only writes need approvaltsconfig.json, .eslintrc*, Dockerfile, .github/workflows/*
DataLocal databases and history files*.sqlite, *.db, wallet.dat, .bash_history

You can add your own custom path or pattern beyond these.

Use case: Catch files that might contain credentials, cryptographic material, cloud account access, or other sensitive data, without having to enumerate every possible location yourself.

UI automation​

Controls which applications and websites Delegate can act on without asking, and which it must never touch.

Trusted apps and sites (auto-approve)​

  • Trusted apps — apps Delegate can use without asking. Quick-add by category (Code Editors, Terminals, Office Apps, File Managers, Notes & Docs), or type to select any individual app that's installed or currently running.
  • Trusted sites — sites Delegate can use without asking. Search or enter a domain; your browser history can help you pick.

Protected apps and sites (block)​

  • Blocked apps — apps Delegate won't open or interact with. Type or select an app to add it.
  • Blocked websites — sites Delegate won't access. Recommended for banking, payments, password managers, and anything sensitive. Quick-add an entire category with one click — Banking, Payments, Crypto, Password Manager, Government, Healthcare — which populates the list with a set of known sites for that category, or search/enter a domain to add one yourself.

Use case: Pre-approve trusted workflows (such as Microsoft Excel, Microsoft Word, or an internal site) so they do not trigger repeated confirmation prompts, and block specific applications or sites, or entire sensitive categories, so the agent can never read or act on them.

Permission setting best practices​

See Permission setting best practices for recommendations by role — individual users, IT administrators, and developers creating skills.

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated