Global API key は、Cloudflare API を利用するための以前の認証方式です。可能な場合は、Global API key ではなく API トークン を使ってください。
新規発行およびローテーションした Global API key は、cfk_ プレフィックス付きの スキャン可能な形式 を使います。漏洩したキーを、資格情報スキャンツールが検出できます。
Global API key には、API トークンと比べて次の制限があります。
-
すべての Cloudflare リソースにアクセスできる - Global API key は、ユーザーが持つすべてのリソースにアクセスできます。そのため、本番リソースにもアクセスできるユーザーが、本番以外のリソースだけを安全に操作する用途には使えません。
-
権限がすべて付与される - 同様に、Global API key はユーザーとまったく同じ権限を持ちます。ユーザーがゾーンの削除や DNS レコードの変更ができる場合、Global API key でも同じ操作ができます。
-
ユーザーあたり 1 つだけ - Global API key はユーザーあたり 1 つしか発行できません。本番システムで Cloudflare API を使う場合、ローテーションに備えて 2 つのシークレットを用意するのが重要なことがあります。この制限はその運用を難しくします。
-
利用に対する高度な制限がない - API トークンは、特定の時間帯に限定したり、期限を設けたり、特定の IP 範囲からの利用に制限したりできます。
こうした理由から、新規利用では Global API key を推奨しません。すでに Global API key を使っている場合は、API トークンへ移行してください。
Global API key を取得する手順は次のとおりです。
-
Cloudflare ダッシュボードで、ユーザープロフィール > API トークン を選択します。
Account API tokens を開く ↗ -
API キー セクションで、Global API Key の
Viewを選択します。
API キーが漏洩した可能性がある場合は、API キーを変更します。
-
Cloudflare ダッシュボードにログインします。
Account home を開く ↗ -
My Profile > API Tokens を開きます。
-
API Keys セクションで、対象のキーを探します。
-
Change を選択します。