Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

認証

最終更新 Markdown で表示Agent セットアップ

背景

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


コマンドを使う

Wrangler を自分の Cloudflare ユーザーで使えるようにするには、次のコマンドを使います。

  • login: Cloudflare アカウントのログインページを開き、Wrangler を認可するコマンドです。
  • config: login の代わりに、emailapi キーの入力を求めるコマンドです。
  • whoami: 設定が正しくできているかを確認するコマンドです。成功すると、アカウントのメールアドレスと、プロジェクトの Wrangler ファイルに必要な account_id が表示されます。

環境変数を使う

グローバルユーザーは、環境変数でも設定できます。CI(継続的インテグレーション)環境で Wrangler を使う場合は、この方法をおすすめします。

Wrangler が使う認証トークンをカスタマイズするには、Wrangler コマンドの実行時に CF_ACCOUNT_IDCF_API_TOKEN 環境変数を指定します。アカウント ID は Cloudflare ダッシュボードの Overview で確認できます。API トークンは 新規作成するか、既存のものを再利用 できます。

CF_ACCOUNT_ID=accountID CF_API_TOKEN=veryLongAPIToken wrangler publish

代わりに、CF_EMAILCF_API_KEY の組み合わせも使えます。

CF_EMAIL=cloudflareEmail CF_API_KEY=veryLongAPI wrangler publish

対象の Zone ID は、CF_ZONE_ID 環境変数で指定または上書きできます。

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


トークンを生成する

API トークン

  1. OverviewGet your API token を選びます。
  2. Profile ページに移動したら、Create token を選びます。
  3. API token templates セクションで Edit Cloudflare Workers テンプレートを見つけ、Use template を選びます。
  4. 残りの欄を入力し、Continue to summary を選びます。そこで Create Token を選び、トークンを発行します。

Global API Key

  1. OverviewGet your API token を選びます。
  2. Profile ページに移動したら、API Keys までスクロールします。
  3. View を選び、Global API Key をコピーします。*

トークンを使う

トークンまたはキーを取得したら、ローカルマシンで wrangler config を実行し、デフォルトの認証情報を設定できます。

wrangler config
Enter API token:
superlongapitoken

--api-key フラグを使うと、代わりに email と global API key で設定できます。

wrangler config --api-key
Enter email:
testuser@example.com
Enter global API key:
superlongapikey

役に立ちましたか?