关于 tigris-authentication
介绍如何使用 Tigris CLI 进行身份验证和访问配置,涵盖登录方式、凭据检查、组织选择及适用于脚本工作流的机器可读输出。
主要功能
- 01OAuth 和凭据登录
- 02持久化凭据配置
- 03身份与凭据检查
- 04组织管理
- 05JSON 命令输出
- 06环境变量凭据
适用场景
- 01在终端登录 Tigris
- 02为重复使用 CLI 配置凭据
- 03检查对存储桶的访问权限
- 04在脚本中选择组织
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ tigrisdata/ tigris-agents-plugins --skill tigris-authentication安装后在 Claude Code 中输入/tigris-authentication确认已加载。
详细介绍
Tigris 身份验证与设置
安装 CLI
npm install -g @tigrisdata/cli
tigris --version
CLI 也可通过 t3 使用(它是 tigris 的别名)。
快速开始
tigris login # authenticate via browser
tigris whoami # verify identity
tigris ls # list your buckets
命令
tigris login
通过 OAuth(默认方式)或临时凭证启动会话。退出登录时会清除会话状态。
tigris login # interactive — choose OAuth or credentials
tigris login oauth # browser-based OAuth2 device flow
tigris login credentials # access key + secret (prompts if not provided)
tigris login credentials --access-key tid_AaBb --access-secret tsec_XxYy
| 子命令 | 别名 | 描述 |
|---|---|---|
login(默认) | l | 交互式选择登录方式 |
login oauth | login o | 使用 OAuth2 设备流程通过浏览器登录 |
login credentials | login c | 使用访问密钥和密钥登录(临时会话) |
login credentials 标志:
| 标志 | 别名 | 描述 |
|---|---|---|
--access-key | --key | 访问密钥 ID(未提供时会提示输入) |
--access-secret | --secret | 访问密钥(未提供时会提示输入) |
tigris configure
将访问密钥凭证保存到 ~/.tigris/config.json,以便在所有命令中持久使用。
tigris configure --access-key tid_AaBb --access-secret tsec_XxYy
tigris configure --endpoint https://custom.endpoint.dev
| 标志 | 别名 | 描述 |
|---|---|---|
--access-key | --key | 你的 Tigris 访问密钥 ID |
--access-secret | --secret | 你的 Tigris 访问密钥 |
--endpoint | -e | Tigris API 端点(默认值:https://t3.storage.dev) |
tigris whoami
显示当前通过身份验证的用户、组织和身份验证方式。
tigris whoami
tigris whoami --json
| 标志 | 别名 | 描述 |
|---|---|---|
--format | -f | 输出格式(json、table;默认值:table) |
--json | 以 JSON 格式输出 |
tigris logout
结束当前会话并清除登录状态。通过 configure 保存的凭证会保留。
tigris logout
tigris credentials test
验证当前凭证是否有效。也可以检查对指定存储桶的访问权限。
tigris credentials test
tigris credentials test --bucket my-bucket
| 标志 | 别名 | 描述 |
|---|---|---|
--bucket | -b | 要测试访问权限的存储桶名称(可选) |
--format | -f | 输出格式(json、table;默认值:table) |
--json | 以 JSON 格式输出 |
tigris orgs list / create / select
列出、创建组织并在组织之间切换。
tigris orgs list # list orgs + interactively select one
tigris orgs list --json # list orgs as JSON
tigris orgs create my-org # create a new organization
tigris orgs select my-org # set active organization
| 命令 | 别名 | 描述 |
|---|---|---|
orgs list | orgs l | 列出所有组织并以交互方式选择一个 |
orgs create <name> | orgs c | 创建一个新组织 |
orgs select <name> | orgs s | 将指定组织设为当前活动组织 |
环境变量
通过环境变量设置凭证时,其优先级高于 ~/.tigris/config.json 和会话状态。这在 CI/CD 和无服务器环境中很常见。
Tigris
| 变量 | 说明 |
|---|---|
TIGRIS_STORAGE_ACCESS_KEY_ID | Tigris 访问密钥 ID(例如 tid_AaBb) |
TIGRIS_STORAGE_SECRET_ACCESS_KEY | Tigris 访问密钥(例如 tsec_XxYy) |
TIGRIS_STORAGE_ENDPOINT | Tigris 端点(https://t3.storage.dev) |
TIGRIS_STORAGE_BUCKET | 默认存储桶名称 |
全局标志
以下标志可用于所有 tigris 命令:
| 标志 | 说明 |
|---|---|
--json | 以 JSON 格式输出(便于程序或 Agent 使用) |
--yes | 跳过确认提示(避免进入交互模式) |
评论
支持 Markdown