tigris-access-keys について
組織のアクセスキーを管理するTigris CLIコマンドを解説するスキルです。キーの作成、確認、バケットロールの割り当て、一覧表示、削除に加え、権限範囲と秘密情報の扱い方も説明します。
主な機能
- 01組織のアクセスキー一覧
- 02キーの作成と確認
- 03バケット単位のロール割り当て
- 04アクセス権の付与と取り消し
- 05JSON、テーブル、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 Access Keys
アクセスキーは、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 対応