> ## Documentation Index
> Fetch the complete documentation index at: https://dify-6c0370d8-docs-new-agent-experience.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 認証

> CLI から Dify ホストにサインインし、token の保存場所を確認し、セッションを管理する

> このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/cli/authenticate) を参照してください。

サインインは OAuth 2.0 デバイスフローを使ってブラウザ経由で行います。`difyctl` がパスワードを受け取ることはありません。

## サインイン

<Steps>
  <Step title="ログインコマンドの実行">
    Dify ホストの URL を渡します。Dify Cloud の場合は `https://cloud.dify.ai` を、セルフホスト環境では [コンソール API URL](/ja/self-host/deploy/configuration/environments#console_api_url) を使用します。

    ```bash theme={null}
    difyctl auth login --host https://cloud.dify.ai
    ```

    `difyctl` はワンタイムコードを表示し、既定のブラウザで検証 URL を開いて待機します。

    ```text theme={null}
    ! Copy this one-time code: WDJP-XKLM
      Open: https://cloud.dify.ai/device
    ```

    <Tip>
      自動で開かないようにするには、`--no-browser` を渡します。
    </Tip>

    ブラウザが開かない場合（SSH 経由やヘッドレスセッションでは通常の動作です）、任意のデバイスで URL を自分で開きます。
  </Step>

  <Step title="ブラウザでのサインイン承認">
    開いたブラウザタブで、Dify の認証情報を使ってサインインし、ワンタイムコードを入力します。

    コードは 15 分後に失効します。失効した場合は、`difyctl auth login` を再実行して新しいコードを取得します。
  </Step>

  <Step title="セッションの確認">
    ターミナルに戻ります。

    ```text theme={null}
    ✓ Logged in to cloud.dify.ai as <your-email> (<your-name>)
      Workspace: <your-workspace>
    ```

    2 行目に表示されているのがワークスペースです。
  </Step>
</Steps>

## 再サインイン

コマンドが `auth_expired`（終了コード 4）で失敗した場合、サーバー側でセッションが失効または取り消されています。

`difyctl auth login` をもう一度実行します。先にサインアウトする必要はなく、新しいサインインによって保存済みの token が更新されます。

## サインイン中のアカウントの確認

```bash theme={null}
difyctl auth whoami
```

```text theme={null}
<your-email> (<your-name>)
```

スクリプトから ID 情報を読み取るには、`--json` を追加します。

```bash theme={null}
difyctl auth whoami --json
```

同じフィールドが JSON オブジェクトとして返され、さらにアカウント ID も含まれます。

```json theme={null}
{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","email":"<your-email>","name":"<your-name>"}
```

## サインアウト

```bash theme={null}
difyctl auth logout
```

```text theme={null}
✓ Logged out of cloud.dify.ai
```

これによりサーバー上のセッションが取り消され、token とセッションエントリがマシンから削除されます。サーバー側の取り消しに失敗した場合でも、ローカルの認証情報は必ず消去されます。

## Token の保存場所

サインインすると OAuth bearer token が保存されます。`dfoa_` プレフィックスで識別できます。この token はあなた自身を表すため、アカウントがワークスペースでできる操作は、そのまま CLI からも実行できます。

`difyctl` は、オペレーティングシステムの認証情報ストアが利用できる場合はそこに token を保存します。macOS では Keychain、Windows では Credential Manager、Linux では Secret Service です。利用できる認証情報ストアがない場合は、`difyctl` 設定ディレクトリ内のパーミッション `0600` の `tokens.yml` ファイルにフォールバックします。

`difyctl` はサインイン時に一度ストアを選択し、以降のセッションはそれを使用します。セッションのメタデータ（ホスト、アカウント、ワークスペース）は token とともに `hosts.yml` に保存されます。

設定ディレクトリは、macOS と Linux では `~/.config/difyctl`（Linux は `XDG_CONFIG_HOME` に従います）、Windows では `%APPDATA%\difyctl` です。[`DIFY_CONFIG_DIR`](/ja/cli/reference/environment-variables) を設定すると、この場所を上書きできます。

## トラブルシューティング

| 問題                            | 対処方法                                                                                                          |
| :---------------------------- | :------------------------------------------------------------------------------------------------------------ |
| ブラウザがまったく開かない                 | ターミナルから URL をコピーし、任意のデバイスで開く。                                                                                 |
| ホストが拒否される                     | 受け付けるのは `https://` ホストのみ。スキームのないホストは `https://` として扱われる。プレーンな `http://` ホスト（ローカル開発のみ）の場合は、`--insecure` を追加する。 |
| 後続のコマンドが `auth_expired` で失敗する | セッションが失効または取り消された。[再サインイン](#再サインイン) する。                                                                       |

その他の問題については、[トラブルシューティング](/ja/cli/troubleshooting) ページ全体を参照してください。