Auth0 CLI

Auth0 CLI を使用してテナント設定を管理し、タスクを自動化し、Auth0 を開発およびデプロイのワークフローに統合する方法について説明します。

開始前に

Auth0 テナントを設定します。

Auth0 CLI は、Auth0 Management API に直接アクセスできるコマンドラインツールで、ターミナルから Auth0 テナントを管理できます。開発時に対話的に使用することを想定して設計されており、自動化のためにスクリプトに組み込むこともできます。

CLI コマンドの完全なリファレンスと詳細な利用方法については、Auth0 CLI Reference Documentation をご覧ください。

​

主な機能

• 対話形式の管理: コマンドラインから Auth0 リソースを作成、更新、管理
• 認証サポート: ユーザーログインや machine-to-machine の資格情報を含む、複数の認証方法に対応
• リソース管理: アプリケーション、API、接続、ユーザーなどに対する完全な CRUD 操作
• クロスプラットフォーム: macOS、Linux、Windows で利用可能
• JSON 出力: スクリプト作成や自動化に適した機械可読な出力

​

利用例

Auth0 CLIは、次のような用途に最適です。

• 開発ワークフロー: 開発中にAuth0リソースをすばやくセットアップして設定する
• テスト: 自動テスト用のテストアプリケーションやユーザーを作成する
• デバッグ: Auth0の設定をリアルタイムで確認・変更する
• スクリプト作成: シェルスクリプトを使って繰り返し作業を自動化する
• CI/CD連携: Auth0の設定をデプロイパイプラインに組み込む

​

他のツールとの比較

​

Auth0 CLI と Deploy CLI

• Auth0 CLI: 対話形式で、コマンドごとにリソースを管理します。開発や一時的な作業に最適です。
• Deploy CLI: 宣言型で、設定ファイルベースのテナント管理を行います。環境をまたいでテナント全体の構成を管理するのに最適です。

​

Auth0 CLI と Terraform Provider

• Auth0 CLI: 変更をすぐに反映するための命令型コマンド。状態管理は行いません。
• Terraform Provider: 状態を追跡する宣言型のインフラストラクチャ as code。Production 環境のインフラストラクチャ管理に最適です。

​

Auth0 CLI のインストール

​

macOS

Homebrew を使って設定します。

brew tap auth0/auth0-cli
brew install auth0

​

Linux

curl -sSfL https://raw.githubusercontent.com/auth0/auth0-cli/main/install.sh | sh -s -- -b /usr/local/bin

​

Windows

Scoop を使って設定します:

scoop bucket add auth0 https://github.com/auth0/scoop-auth0-cli.git
scoop install auth0

または、GitHubのリリースページから最新版をダウンロードしてください。

​

認証

Auth0 CLI を使用するには、認証が必要です。次のコマンドを実行すると、Auth0 アカウントにログインするためのブラウザーウィンドウが開きます。

auth0 login

Machine-to-Machine アプリケーションで認証するには、次のコマンドを使用します：

auth0 login --domain <your-domain> --client-id <client-id> --client-secret <client-secret>

​

よく使うコマンド

​

アプリケーションの管理

# すべてのアプリケーションを一覧表示する
auth0 apps list

# 新しいアプリケーションを作成する
auth0 apps create --name "My App" --type spa

# アプリケーションの詳細を表示する
auth0 apps show <app-id>

# アプリケーションを更新する
auth0 apps update <app-id> --callbacks "http://localhost:3000/callback"

# アプリケーションを削除する
auth0 apps delete <app-id>

​

APIの管理

# すべてのAPIを一覧表示する
auth0 apis list

# 新しいAPIを作成する
auth0 apis create --name "My API" --identifier "https://my-api.example.com"

# APIの詳細を表示する
auth0 apis show <api-id>

​

ユーザー管理

# ユーザーを一覧表示する
auth0 users list

# ユーザーの作成
auth0 users create --email "[e-mail]" --connection "Username-Password-Authentication"

# ユーザーの詳細を表示する
auth0 users show <user-id>

# ユーザーを更新
auth0 users update <user-id> --email "[e-mail]"

​

テナント設定の管理

# 現在のテナントを表示
auth0 tenants list

# テナント設定を更新
auth0 tenants-settings update set [flags]

​

スクリプトでの使用

Auth0 CLI は、スクリプトで簡単にパースできる JSON 出力をサポートしています。

# アプリケーションの詳細をJSONとして取得する
auth0 apps show <app-id> --json

# アプリを作成して出力をキャプチャする
auth0 apps create --name "My App" --type spa --json > app-details.json

​

Agent Modeの使用

Agent Modeを有効にすると、AIエージェントが人の介在なしにCLIを操作する際も、動作が予測可能になります。--agent-modeフラグまたはAUTH0_AGENT_MODE環境変数で有効にできます。

auth0 apps list --agent-mode

AUTH0_AGENT_MODE=true auth0 apps list

Agent Modeを使用すると、構造化されたJSON出力が有効になり、対話型のプロンプトと色付き表示が無効になります。また、失敗時には必ず0以外の終了コードが返されます。ほとんどの場合、明示的に設定する必要はありません。CLIは対話型ターミナルに接続されていないこと (たとえば、Claude Code、Cursor、CIジョブから実行された場合) を検出し、同じ動作を自動的に適用します。

Agent Modeでは、デフォルトでインデント付きのJSONが出力されます。大量の処理を行うワークフローや、トークン数を抑えたいワークフローでは、--json-compactを指定すると、余分な空白を省いた同じデータを取得できます。

auth0 apps list --agent-mode --json-compact

auth0 logs tail などのストリーミングコマンドは、Agent Modeでは常にコンパクト形式で出力されます。

​

コマンド体系を把握する

エージェントは、--help を1階層ずつたどらなくても、1回の呼び出しで CLI 全体を把握できます：

auth0 commands --flat

--detailed を付けると、各コマンドのフラグ、引数、デフォルト値、認証の要否も出力に含まれます。

​

送信前にペイロードの構造を確認する

--schema を指定すると、コマンドが受け付けるリクエストのペイロードを OpenAPI 仕様に基づいて出力します。

auth0 apps create --schema

--data はペイロードを単一の JSON オブジェクトとして送信し、リクエストが API に届く前にローカルで検証します。

# インラインJSONを使用する場合:
auth0 apps create --data '{"name":"My App","app_type":"spa"}'

# ファイルのJSONを使用する場合:
auth0 apps create --data @app.json

# `stdin` からパイプでJSONを渡す場合
jq .example app.json | auth0 apps create

​

構造化エラー

Agent Mode では、失敗時には常にプレーンテキストのメッセージではなく、JSON 形式のエラーエンベロープが返されます。

{
  "error": {
    "code": "validation",
    "reason": "local_validation",
    "message": "...",
    "details": [
      {
        "field": "name",
        "reason": "property \"name\" is missing"
      }
    ]
  }
}

error オブジェクトには以下が含まれます。

• code：失敗の分類です。取り得る値は usage、auth、validation、not_found、rate_limit、conflict、network、api、unknown (より具体的な分類に該当しない場合のフォールバック) の 9 種類です。
• reason：より詳細な失敗の分類です。reason の取り得る値はこれですべてではなく、CLI がより細かな失敗情報に対応するにつれて増えていきます。そのため、code は安定した仕様として、reason は補足的なコンテキストとして扱ってください。
• details：ペイロードがバリデーションに失敗した場合の、フィールド単位の情報です。

エージェントは、エラーメッセージの文章を解析しなくても、これらの値をもとに処理を分岐できます。

​

ターミナルからドキュメントを検索する

auth0 docs search を使用すると、ターミナルから離れることなく、認証も不要でAuth0の公開ドキュメントを検索できます：

auth0 docs search "organizations"

Agent Mode では、エージェントが直接取得できる raw Markdown の URL が検索結果に含まれます。

​

ドキュメントとサポート

完全なドキュメント、コマンドリファレンス、使用例については、以下をご覧ください。

• Auth0 CLI GitHub Repository
• Auth0 CLI ドキュメント

​

次のステップ

Deploy CLI

Deploy CLI を使用したテナント設定の管理について学ぶ

Terraform Provider

Terraform による infrastructure-as-code を確認する

Management API

Auth0 Management API に直接アクセスする