tauri-config-security

Tauri Config And Security

Use this skill when changing tauri.conf.*, src-tauri/capabilities/*, permissions, CSP, plugin access, or any frontend-callable native API.

Security Baseline

• Every frontend-accessible native API needs an explicit permission story.
• Grant the minimum permission to the minimum window/webview label.
• Scope filesystem, shell, HTTP, opener, deep-link, and sidecar access.
• Never add broad $HOME/**, unrestricted shell, or unbounded network access as a convenience fix.
• Do not print, move, commit, or invent signing keys, tokens, .env values, cookies, Keychain data, or updater private keys.

Files To Inspect

python3 ../../scripts/tauri_project_probe.py .

Then inspect:

• src-tauri/tauri.conf.json, .json5, or .toml;
• platform configs such as tauri.macos.conf.json, tauri.windows.conf.json, tauri.linux.conf.json, tauri.android.conf.json, tauri.ios.conf.json;
• src-tauri/capabilities/*.json or *.toml;
• src-tauri/Cargo.toml;
• Rust window creation labels and plugin registration.

Capability Pattern

Prefer file-based capabilities under src-tauri/capabilities/:

{
  "$schema": "../gen/schemas/desktop-schema.json",
  "identifier": "main-window",
  "description": "Main window permissions",
  "windows": ["main"],
  "permissions": [
    "core:path:default",
    "core:event:default",
    "core:window:default",
    {
      "identifier": "fs:allow-exists",
      "allow": [{ "path": "$APPDATA/*" }]
    }
  ]
}

If app.security.capabilities is set in config, keep it synchronized with capability identifiers. Window labels are case-sensitive and are not titles.

Review Checklist

• Are core:* permissions namespaced correctly for Tauri 2?
• Does each window have only the permissions it needs?
• Are remote URLs, filesystem scopes, and shell commands scoped?
• Are plugin permissions registered in capabilities after adding a plugin?
• Does CSP allow only required script, style, image, asset, IPC, and network sources?
• Did a build/runtime error get "fixed" by adding permissions that are too broad? If so, replace with a narrower permission or command.

Verification

Run schema/build checks available in the project. At minimum, use:

cargo check --manifest-path src-tauri/Cargo.toml

Then run the local Tauri dev/build command if the changed permission affects runtime frontend calls.