プロファイル

SID・PAT・SA Key すべての認証情報を「プロファイル」として OS キーチェーンに統一管理します。

省略時のプロファイル名は default です。

プロファイルの作成

ログイン時に --profile でプロファイル名を指定します。

code:bash

# デフォルトプロファイルでログイン (SID)

cos auth login

# 別アカウントを "work" プロファイルとして登録

cos auth login --profile work

# PAT を "ci-readonly" プロファイルとして登録

cos auth login --pat "pat_xxxx..." --profile ci-readonly

# API 検証なしで直接保存 (CI / 自動化向け)

cos auth add --type sid --key "s%3Axxx..." --profile 個人

cos auth add --type pat --key-env MY_PAT_TOKEN --profile ci-readonly

cos auth add --type sa --key-stdin --project myproject --profile cs_myproject < sa-key.txt

プロファイルを確認する

code:bash

# 登録済みプロファイルの一覧を表示

cos auth list

# 現在どのプロファイルが使われているか確認 (解決経路付き)

cos auth status

# 全プロファイルの健全性チェック (API 疎通確認含む)

cos auth doctor

デフォルトプロファイルを切り替える

code:bash

# "個人" プロファイルをデフォルトに設定

cos auth use 個人

# defaultProfile 設定を解除 ("default" プロファイルへフォールバック)

cos auth use --unset

プロファイルを指定してコマンドを実行

各コマンドに --profile を付けるとそのプロファイルの認証情報を使います。

code:bash

cos auth whoami --profile work

cos page list --project myproject --profile work

環境変数で指定

COS_PROFILE 環境変数でデフォルトのプロファイルを切り替えられます。

code:bash

COS_PROFILE=work cos page list --project myproject

プロファイルの削除

code:bash

cos auth logout --profile work

認証解決の優先順位 (7段)

1. 環境変数 COS_PERSONAL_ACCESS_TOKEN → PAT

2. 環境変数 COS_SERVICE_ACCOUNT_KEY → SA キー

3. 環境変数 COS_SID (--profile 未指定時のみ)

4. --profile <name> フラグ → キーチェーン

5. COS_PROFILE 環境変数 → キーチェーン

6. config.defaultProfile → キーチェーン

7. "default" プロファイル → キーチェーン