コンテンツにスキップ

認証

背景

Cloudflareのシステムでは、ユーザーは複数のアカウントとゾーンを持つことができます。そのため、ユーザーは単一のCloudflareトークンを介して、マシン上でグローバルに構成されます。アカウントとゾーンはプロジェクトごとに構成されますが、すべてのAPI呼び出しを認証するためにCloudflareトークンを使用します。構成ファイルは、コンピュータのホームディレクトリ内の.wranglerディレクトリに作成されます。


コマンドの使用

Cloudflareユーザーと連携するためにWranglerを設定するには、以下のコマンドを使用します。

  • login: Wranglerを認証するためにCloudflareアカウントのログインページを開くコマンドです。
  • config: loginの代替として、emailapiキーを入力するように促します。
  • whoami: このコマンドを実行して、構成が適切に設定されていることを確認します。成功すると、このコマンドはプロジェクトのwrangler.tomlファイルに必要なアカウントのメールアドレスとaccount_idを出力します。

環境変数の使用

環境変数を使用してグローバルユーザーを構成することもできます。これは、CI(継続的インテグレーション)環境でWranglerを使用するための推奨方法です。

Wranglerが使用する認証トークンをカスタマイズするには、任意のWranglerコマンドを実行する際にCF_ACCOUNT_IDCF_API_TOKEN環境変数を提供できます。アカウントIDはCloudflareダッシュボードの概要から取得でき、APIトークンを作成または再利用することができます

Terminal window
CF_ACCOUNT_ID=accountID CF_API_TOKEN=veryLongAPIToken wrangler publish

または、代わりにCF_EMAILCF_API_KEY環境変数の組み合わせを使用することもできます:

Terminal window
CF_EMAIL=cloudflareEmail CF_API_KEY=veryLongAPI wrangler publish

CF_ZONE_ID環境変数を定義することで、ターゲットゾーンIDを指定または上書きすることもできます。

インラインで環境変数を定義すると、wrangler configまたはwrangler.tomlファイルに保存されているデフォルトの資格情報が上書きされます。


トークンの生成

APIトークン

  1. 概要で、APIトークンを取得を選択します。
  2. プロフィールページに移動したら、トークンを作成を選択します。
  3. APIトークンテンプレートセクションで、Cloudflare Workersを編集テンプレートを見つけて、テンプレートを使用を選択します。
  4. 残りのフィールドを入力し、要約に進むを選択します。ここでトークンを作成を選択して、使用するトークンを発行します。

グローバルAPIキー

  1. 概要で、APIトークンを取得を選択します。
  2. プロフィールページに移動したら、APIキーまでスクロールします。
  3. 表示を選択して、グローバルAPIキーをコピーします。*

トークンの使用

トークンまたはキーを取得した後、wrangler configを実行してローカルマシンにデフォルトの資格情報を設定できます:

Terminal window
wrangler config
APIトークンを入力してください:
superlongapitoken

--api-keyフラグを使用して、メールとグローバルAPIキーで構成することもできます:

Terminal window
wrangler config --api-key
メールアドレスを入力してください:
testuser@example.com
グローバルAPIキーを入力してください:
superlongapikey