SuperAPI AI 工具集

configuring-tauri-scopes

安全与审计

查看项目

更新于 10-15 16:52

技能介绍

用途:该技能用于在 Tauri v2 应用(A)中配置命令作用域(scopes),实现对命令与资源的细粒度授权控制,属于应用安全配置范畴。

主要能力:理解并配置 allow(显式允许)与 deny(显式禁止)作用域,deny 优先;文件系统插件的路径作用域(glob 模式,例如 $APPDATA/databases/、$DOCUMENT/**/.txt);HTTP 插件的 URL 模式(如 https://*.tauri.app);使用 $APPDATA、$HOME、$DOCUMENT 等运行时路径变量;通过 TOML 定义带作用域的自定义权限与权限集;用 Rust 的 FsExt trait 在运行时动态扩展作用域(allow_directory、allow_file);配置远程 URL 能力(remote.urls)以限制可访问命令的来源域。

使用方式:在 src-tauri/capabilities/default.json 及其他 capability 文件中配置 permissions,示例条目如 {"identifier": "fs:scope", "allow": [{"path": "$APPDATA"}]};命令级限制用 fs:allow-read-text-file、fs:allow-write-text-file 等;HTTP 用 http:default 配 url 规则;权限可在 TOML 中用 [[permission]]、[[permission.scope.allow]]、[[set]] 定义;开发时用 pnpm tauri dev 或 cargo tauri dev 观察权限报错。

适用场景:需要限制应用可读写文件目录、限制网络请求目标域名、按窗口或平台分配权限、为插件或自定义命令定义作用域的桌面应用开发。

限制与注意:作用域由命令实现负责校验和执行,开发者须正确实现校验以防绕过;Tauri 阻止路径穿越(如 ../path、/usr/path/../file 不被允许);动态扩展作用域须先验证路径,尽量避免依赖未经校验的用户输入,优先静态配置。资料未提供价格、平台支持细节或具体版本要求之外的信息。