ログイン
ブラウザで承認して、CLI 用のキーを受け取る。
cozeni login はブラウザでの承認を経て CLI 用のキーを受け取ります。キーは発行から30日で失効し、自分のマシンの設定フォルダに保存されます。プロジェクトの中には保存されません。
ログインの流れ
ログインを始める
npx cozeni login --jsonコードと承認用の URL を表示して、すぐに終わります。
ブラウザで承認する
ブラウザで URL を開き、表示されたコードが login の出力と同じことを確かめてから承認します。コードの期限は10分です。
ログインを終える
npx cozeni login --complete --json承認を確かめて、キーを保存します。最長90秒待ちます。承認される前なら、終了コード6で戻ります。ブラウザで承認してから、同じコマンドを打ち直します。
人が操作するターミナル(AI エージェントや CI の環境以外)で、--json を付けずに npx cozeni login を実行すると、1回で完了します。コードを表示したあと、Enter を押すとブラウザが開きます。
ログインできたかは whoami で確かめられます。接続先、クリエイター、キーの期限が表示されます。キーの値は表示されません。詳しくは コマンド一覧の whoami を見てください。
npx cozeni whoami --json
発行されるキーの種類
| 項目 | 内容 |
|---|---|
| スコープ | products:read、products:write、checkout_links:read、checkout_links:write の4つです。 |
| 期限 | 発行から30日です。使っても延びません。 |
| 数 | 有効な CLI のキーは1クリエイターにつき5本までです。管理画面で発行するキーとは別に数えます。5本あるときにログインすると、最も古い CLI のキーが失効します。 |
ログインし直して新しいキーが発行された場合、CLI は新しいキーを保存してから前のキーの失効を試みます。通信の失敗などで前のキーを失効できなくても、新しいキーの保存とログインは成功します。
この場合は警告が出ます。--json を付けた実行では、data.warnings 配列に previous_key_not_revoked が入ります。管理画面の「開発者設定」で API キーの一覧を開き、前のキーの状態を確認し、有効な場合は失効させてください。
保存先
| ファイル | 内容 |
|---|---|
credentials.json |
接続先ごとのキーです。平文で保存されます。所有者だけが読める権限(ファイル 0600、フォルダ 0700)で書かれます。 |
config.json |
既定の接続先と、接続先ごとに期待するクリエイターです。秘密は含みません。 |
pending/ |
ログインの待ち状態、商品を作るときの冪等キー、返金していないテスト購入の記録です。権限は credentials.json と同じです。 |
保存先は $XDG_CONFIG_HOME/cozeni/ です。XDG_CONFIG_HOME が未設定か相対パスなら、~/.config/cozeni/ を使います。
保存先のフォルダやファイルの権限が所有者以外にも与えられているとき、またはシンボリックリンクのときは、CLI は読み書きせずに insecure_storage(終了コード1)で止まります。error.hint に従って権限を直してください。
接続先(プロファイル)
| プロファイル | 接続先 |
|---|---|
production |
本番です。 |
sandbox |
サンドボックスです。 |
どちらの接続先も変えられません。保存したキーは発行された接続先にだけ送られます。キーの接頭辞(cozeni_sk_sandbox_ か cozeni_sk_)と --profile が一致しないときは、CLI はキーを送らずに environment_mismatch(終了コード2)で止まります。
環境変数 COZENI_API_KEY
COZENI_API_KEY を設定すると、保存したキーより優先して使われます。CI などでの利用を想定しています。
logout は COZENI_API_KEY のキーを失効させません。使わなくなったら、管理画面で失効させます。
ログアウト
npx cozeni logout --json
サーバーでキーを失効させ、保存したキーを消します。サーバーでの失効に失敗したときは、警告が出ます。その場合は、管理画面の API キーの一覧から失効させてください。