---
title: ログイン
description: ブラウザで承認して、CLI 用のキーを受け取る。
---

`cozeni login` はブラウザでの承認を経て CLI 用のキーを受け取ります。キーは発行から30日で失効し、自分のマシンの設定フォルダに保存されます。プロジェクトの中には保存されません。

## ログインの流れ

1. **ログインを始める**

    ```sh
    npx cozeni login --json
    ```

    コードと承認用の URL を表示して、すぐに終わります。

2. **ブラウザで承認する**

    ブラウザで URL を開き、表示されたコードが `login` の出力と同じことを確かめてから承認します。コードの期限は10分です。

3. **ログインを終える**

    ```sh
    npx cozeni login --complete --json
    ```

    承認を確かめて、キーを保存します。最長90秒待ちます。承認される前なら、終了コード6で戻ります。ブラウザで承認してから、同じコマンドを打ち直します。

人が操作するターミナル（AI エージェントや CI の環境以外）で、`--json` を付けずに `npx cozeni login` を実行すると、1回で完了します。コードを表示したあと、Enter を押すとブラウザが開きます。

ログインできたかは `whoami` で確かめられます。接続先、クリエイター、キーの期限が表示されます。キーの値は表示されません。詳しくは [コマンド一覧の whoami](/integrate/cli/reference#whoami) を見てください。

```sh
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 キーの一覧を開き、前のキーの状態を確認し、有効な場合は失効させてください。

:::note
保存済みのキーがまだ使え、期待するクリエイターと一致し、期限まで7日以上あるときは、`login` は承認を求めずに成功します。
:::

## 保存先

| ファイル | 内容 |
| --- | --- |
| `credentials.json` | 接続先ごとのキーです。平文で保存されます。所有者だけが読める権限（ファイル 0600、フォルダ 0700）で書かれます。 |
| `config.json` | 既定の接続先と、接続先ごとに期待するクリエイターです。秘密は含みません。 |
| `pending/` | ログインの待ち状態、商品を作るときの冪等キー、返金していないテスト購入の記録です。権限は `credentials.json` と同じです。 |

保存先は `$XDG_CONFIG_HOME/cozeni/` です。`XDG_CONFIG_HOME` が未設定か相対パスなら、`~/.config/cozeni/` を使います。

保存先のフォルダやファイルの権限が所有者以外にも与えられているとき、またはシンボリックリンクのときは、CLI は読み書きせずに `insecure_storage`（終了コード1）で止まります。`error.hint` に従って権限を直してください。

:::caution
Windows では、CLI はファイルの権限を確かめません。`XDG_CONFIG_HOME` を共有フォルダや同期フォルダに向けないでください。
:::

## 接続先（プロファイル）

| プロファイル | 接続先 |
| --- | --- |
| `production` | 本番です。 |
| `sandbox` | サンドボックスです。 |

どちらの接続先も変えられません。保存したキーは発行された接続先にだけ送られます。キーの接頭辞（`cozeni_sk_sandbox_` か `cozeni_sk_`）と `--profile` が一致しないときは、CLI はキーを送らずに `environment_mismatch`（終了コード2）で止まります。

## 環境変数 COZENI_API_KEY

`COZENI_API_KEY` を設定すると、保存したキーより優先して使われます。CI などでの利用を想定しています。

:::caution
アプリ用のキーを、CLI を実行するシェルの環境変数 `COZENI_API_KEY` に設定しないでください。CLI はこの環境変数のキーをログインで保存したキーより優先して使います。機能フラグを使うサイトのキーは、サイトのサーバーの環境変数だけに置きます。
:::

`logout` は `COZENI_API_KEY` のキーを失効させません。使わなくなったら、管理画面で失効させます。

## ログアウト

```sh
npx cozeni logout --json
```

サーバーでキーを失効させ、保存したキーを消します。サーバーでの失効に失敗したときは、警告が出ます。その場合は、管理画面の API キーの一覧から失効させてください。

:::note
AI エージェントに `credentials.json` を読ませないでください。キーの値は CLI の出力にも表示されません。
:::
