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 形式で出力します（プログラムやエージェントでの利用に便利です）
--yes	確認プロンプトをスキップします（対話モードを回避します）