> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# 認証

> BRICKS ワークスペースにログインしてプロファイルを管理する

BRICKS CLI は認証プロファイルを使用してワークスペースに接続します。各プロファイルには、特定のワークスペースに紐付いたトークンが保存されます。

## ログイン

[BRICKS Controller](/ja/controller) からワンタイムパスコードを取得して、ログインに使用します：

```bash theme={null}
bricks auth login <passcode>
```

ワークスペースの **Manage API Tokens** からワンタイムパスコードを生成してください。パスコードは 5 分後に有効期限が切れ、一度しか使用できません。ワークスペーストークンを使って直接ログインすることもできます：

```bash theme={null}
bricks auth login-token -t <token>
```

[BRICKS Controller](/ja/controller/workspaces) の **Manage API Tokens** からワークスペーストークンを生成またはコピーしてください。

## プロファイル

プロファイルを使用すると、複数のワークスペース接続を管理できます。ログインするたびにプロファイルが作成または更新されます。

```bash theme={null}
# ログインして名前付きプロファイルに保存する
bricks auth login <passcode> -p my-workspace

# すべてのプロファイルを一覧表示する
bricks auth list

# アクティブなプロファイルを切り替える
bricks auth use <profile>

# どのプロファイルがアクティブか確認する
bricks auth status
```

### コマンドごとのプロファイル上書き

`-ap` または `--auth-profile` を使用すると、切り替えなしに異なるプロファイルで任意のコマンドを実行できます：

```bash theme={null}
bricks -ap staging device list
bricks --auth-profile production app list
```

**解決順序：** `--auth-profile` フラグ > `BRICKS_PROFILE` 環境変数 > 保存済みのアクティブプロファイル。

## ログアウト

```bash theme={null}
# 現在のプロファイルのトークンを削除する
bricks auth logout

# 特定のプロファイルを削除する
bricks auth logout -p my-workspace

# すべてのプロファイルを削除する
bricks auth logout -a
```