关于 tigris-access-keys
介绍用于管理组织访问密钥的 Tigris CLI 命令,供开发者创建、查看、分配存储桶角色、列出和撤销密钥,并提供权限限制与密钥保护建议。
主要功能
- 01列出组织访问密钥
- 02创建和查看密钥
- 03分配存储桶级角色
- 04授予或撤销访问权限
- 05支持 JSON、表格和 XML 输出
- 06密钥处理指导
适用场景
- 01为应用创建密钥
- 02将密钥限制到指定存储桶
- 03检查密钥角色和元数据
- 04撤销或轮换旧密钥
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ tigrisdata/ tigris-agents-plugins --skill tigris-access-keys安装后在 Claude Code 中输入/tigris-access-keys确认已加载。
详细介绍
Tigris 访问密钥
访问密钥是用于 Tigris API 的程序化凭证。密钥 ID 使用 tid_ 前缀,密钥使用 tsec_ 前缀。
命令
tigris access-keys list(别名:l)
列出当前组织中的所有访问密钥。
tigris access-keys list
tigris access-keys list --json
| 标志 | 别名 | 描述 | 默认值 |
|---|---|---|---|
--format | -f | 输出格式(json、table、xml) | table |
--json | 以 JSON 格式输出 |
tigris access-keys create <name>(别名:c)
使用指定名称创建新的访问密钥。密钥只会显示一次——请立即保存。
tigris access-keys create my-ci-key
tigris access-keys create my-ci-key --json
| 标志 | 别名 | 描述 | 默认值 |
|---|---|---|---|
--format | -f | 输出格式(json、table) | table |
--json | 以 JSON 格式输出 |
tigris access-keys get <id>(别名:g)
显示访问密钥的详细信息,包括名称、创建日期和分配的存储桶角色。
tigris access-keys get tid_AaBbCcDdEeFf
tigris access-keys get tid_AaBbCcDdEeFf --json
| 标志 | 别名 | 描述 | 默认值 |
|---|---|---|---|
--format | -f | 输出格式(json、table) | table |
--json | 以 JSON 格式输出 |
tigris access-keys delete <id>(别名:d)
永久删除访问密钥。所有访问权限将立即撤销。
tigris access-keys delete tid_AaBbCcDdEeFf --force
| 标志 | 描述 |
|---|---|
--force | 跳过确认提示 |
--format / -f | 输出格式(json、table;默认值:table) |
--json | 以 JSON 格式输出 |
tigris access-keys assign <id>(别名:a)
为访问密钥分配存储桶级角色。将每个 --bucket 与一个 --role(Editor 或 ReadOnly)配对,或使用 --admin 获取组织范围的访问权限。
# Single bucket
tigris access-keys assign tid_AaBb --bucket my-bucket --role Editor
# Multiple buckets with different roles
tigris access-keys assign tid_AaBb --bucket a,b --role Editor,ReadOnly
# Org-wide admin access
tigris access-keys assign tid_AaBb --admin
# Revoke all roles
tigris access-keys assign tid_AaBb --revoke-roles
| 标志 | 别名 | 描述 |
|---|---|---|
--bucket | -b | 存储桶名称(可多个),以逗号分隔。每个存储桶按位置与一个 --role 值配对 |
--role | -r | 要分配的角色(Editor、ReadOnly),以逗号分隔。每个角色与对应的 --bucket 配对 |
--admin | 授予对组织中所有存储桶的管理员访问权限 | |
--revoke-roles | 撤销该访问密钥的所有存储桶角色 | |
--format | -f | 输出格式(json、table;默认值:table) |
--json | 以 JSON 格式输出 |
工作流
# 1. Create a key
tigris access-keys create my-app-key --json
# Save the tid_ and tsec_ values from the output!
# 2. Scope it to specific buckets
tigris access-keys assign tid_AaBb --bucket my-bucket --role Editor
# 3. Configure your environment (Tigris env vars)
export TIGRIS_STORAGE_ACCESS_KEY_ID=tid_AaBb
export TIGRIS_STORAGE_SECRET_ACCESS_KEY=tsec_XxYy
export TIGRIS_STORAGE_ENDPOINT=https://t3.storage.dev
export TIGRIS_STORAGE_BUCKET=my-bucket
安全最佳实践
- 限定到特定存储桶——除非确有需要,否则避免使用
--admin - 使用最低限度的角色——不需要写入时,优先使用
ReadOnly - 为每个应用单独使用密钥——为每个应用或环境创建专用密钥
- 定期轮换密钥——删除旧密钥并创建新密钥
- 切勿提交密钥——使用环境变量或密钥管理器,而不是源代码
评论
支持 Markdown