mcpField
T
tigris-authentication

tigris-authentication

github.com/tigrisdata云与 DevOps185 次安装31 周前更新
代码仓库

关于 tigris-authentication

介绍如何使用 Tigris CLI 进行身份验证和访问配置,涵盖登录方式、凭据检查、组织选择及适用于脚本工作流的机器可读输出。

主要功能

  1. 01OAuth 和凭据登录
  2. 02持久化凭据配置
  3. 03身份与凭据检查
  4. 04组织管理
  5. 05JSON 命令输出
  6. 06环境变量凭据

适用场景

  1. 01在终端登录 Tigris
  2. 02为重复使用 CLI 配置凭据
  3. 03检查对存储桶的访问权限
  4. 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 oauthlogin o使用 OAuth2 设备流程通过浏览器登录
login credentialslogin 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-eTigris 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 listorgs l列出所有组织并以交互方式选择一个
orgs create <name>orgs c创建一个新组织
orgs select <name>orgs s将指定组织设为当前活动组织

环境变量

通过环境变量设置凭证时,其优先级高于 ~/.tigris/config.json 和会话状态。这在 CI/CD 和无服务器环境中很常见。

Tigris
变量说明
TIGRIS_STORAGE_ACCESS_KEY_IDTigris 访问密钥 ID(例如 tid_AaBb)
TIGRIS_STORAGE_SECRET_ACCESS_KEYTigris 访问密钥(例如 tsec_XxYy)
TIGRIS_STORAGE_ENDPOINTTigris 端点(https://t3.storage.dev)
TIGRIS_STORAGE_BUCKET默认存储桶名称

全局标志

以下标志可用于所有 tigris 命令:

标志说明
--json以 JSON 格式输出(便于程序或 Agent 使用)
--yes跳过确认提示(避免进入交互模式)

评论

支持 Markdown