​

auth

orc auth は、ブラウザーで本人のアカウントを認可するか、標準入力のAPIキーを保存してCLIの認証を設定するコマンドです。現在の資格情報をサーバーで検証し、保存したCLIセッションをログアウトできます。

orc login と orc logout は orc auth login と orc auth logout の短縮形です。本人のブラウザー認可とWorkspaceのAPIキーは異なる認証方式です。資格情報をシェル引数へ直接渡す --api-key は非推奨です。アカウント情報の確認は orc whoami、設定や接続の診断は orc status を使用してください。

ブラウザーでCLIを認可します。

対話端末ではOrchestorの認可画面を開きます。ターミナルと画面の確認コードが一致することを確認し、CLIを認可してください。未ログインの場合は通常のログイン・登録を完了して認可画面へ戻ります。既存のWebログイン状態は再利用します。APIキーは標準入力から読み込んで保存できます。この保存だけでAPIキーの有効性を検証したとは限らないため、auth status で確認してください。--web はブラウザー認可を明示します。

API key (deprecated; pipe via standard input instead)

型: string。任意。

Named credential profile to activate

型: string。任意。

Credential scope: org:admin

型: string。任意。

Browser authorization (explicit alias)

型: boolean。任意。

現在の資格情報を /v1/auth/validate で検証し、authenticated、valid、取得元 source、認証方式 kind、秘密値を含まない opaque_id、workspace_id、説明 detail を返します。有効なら終了コード0、それ以外は1です。auth status get と auth validate は互換エイリアスです。

保存されたCLIセッションのrefresh tokenがある場合は失効を要求してから、保存したAPIキー・access token・refresh token・期限を削除します。失効に失敗した場合は再試行してください。ORCHESTOR_API_KEY が環境変数に残っている場合は引き続き優先されるため、完全にログアウトするにはその設定も解除します。

現在解決される資格情報の秘密値を改行付きで標準出力へ出します。通常の診断出力とは異なる明示的な秘密情報の出力です。共有ターミナル、ログ、画面収録で実行しないでください。資格情報がない場合は終了コード2になります。

シェルの履歴に秘密値を直接入力せず、既存の安全な環境設定から渡します。保存後に orc auth status で検証してください。

APIキーを標準入力から保存します。

現在の認証をJSONで検証します。

名前付き組織管理プロファイルでブラウザー認可します。

ブラウザー認可はWebセッションとは独立したCLIセッションを作成します。認可リクエストは10分で期限切れになります。中断した場合は orc auth login を再実行します。

ブラウザー認可は認証情報を保存・読み戻し、Workspaceの準備状態と次の操作を返します。ベータ参加や初回設定が必要な場合も、ログイン済みの認証情報を後続操作に使えます。

--profile <name> は認証設定を分ける名前です。--scope org:admin には名前付きプロファイルが必要で、--workspace と併用できません。

orc auth では、次のグローバルオプションを使用できます。

各オプションの詳細と使用例は、グローバルオプションを参照してください。