認証
Backlog CLI は API キーと OAuth 2.0 の2つの認証方式をサポートしています。
API キー
Section titled “API キー”最もシンプルな認証方式です。Backlog の個人設定から API キーを発行して使用します。
backlog auth login --method api-keyパイプで API キーを渡すこともできます。
echo "YOUR_API_KEY" | backlog auth login --with-tokenOAuth 2.0
Section titled “OAuth 2.0”OAuth 2.0 による認証も利用可能です。
backlog auth login --method oauthOAuth トークンの有効期限が切れた場合はリフレッシュできます。
backlog auth refresh認証状態の確認
Section titled “認証状態の確認”backlog auth status特定のスペースの認証状態を確認する場合は、次のコマンドを実行します。
backlog auth status --hostname your-space.backlog.comトークンを表示する場合は、次のコマンドを実行します。
backlog auth status --show-token複数スペースの管理
Section titled “複数スペースの管理”複数の Backlog スペースに認証できます。
# スペース A に認証backlog auth login --hostname space-a.backlog.com
# スペース B に認証backlog auth login --hostname space-b.backlog.comデフォルトスペースの切り替え
Section titled “デフォルトスペースの切り替え”backlog auth switch --hostname space-b.backlog.comコマンド実行時のスペース指定
Section titled “コマンド実行時のスペース指定”--space グローバルフラグで一時的にスペースを切り替えられます。
backlog issue list --project PROJ --space space-b.backlog.comスペース解決の優先順位
Section titled “スペース解決の優先順位”--spaceフラグ /BACKLOG_SPACE環境変数 / 設定ファイルのdefaultSpace+ 設定ファイルの認証情報BACKLOG_API_KEY+BACKLOG_SPACE環境変数（フォールバック）
環境変数による認証（CI/AI ワークフロー向け）
Section titled “環境変数による認証（CI/AI ワークフロー向け）”backlog auth login を実行できない非インタラクティブ環境（CI パイプライン、AI エージェント等）では、環境変数のみで認証できます。
export BACKLOG_SPACE=your-space.backlog.comexport BACKLOG_API_KEY=your-api-key
# backlog auth login なしで利用可能backlog issue list --project YOUR_PROJECTBACKLOG_API_KEY は設定ファイルの認証情報より優先度が低いため、~/.backlogrc にスペースが設定されている場合はそちらが使われます。
認証情報の保存場所
Section titled “認証情報の保存場所”認証情報は ~/.backlogrc ファイルに保存されます。
# デフォルトスペースからログアウトbacklog auth logout
# 特定のスペースからログアウトbacklog auth logout --hostname your-space.backlog.com