Cloudflare API では、認証に API トークンを使うことを推奨しています。この記事では、GraphQL Analytics API の認証用に API トークンを作成する手順を説明します。
API トークンと、対応しているオプションの全体は、API トークンを作成する を参照してください。
GraphQL Analytics API の認証用 API トークンは、次の手順で作成します。
-
Cloudflare ダッシュボードで Account API tokens ページを開きます。
Account API tokens を開く ↗ -
Create Token を選びます。
Create API Token ページが表示されます。
次の節では、GraphQL Analytics API へアクセスするカスタムトークンの設定方法を説明します。
カスタムトークンは、次の手順で設定します。
- Create API Token ページの Custom token で Get started を選びます。
Create Custom Token ページが表示されます。
-
Token name に、トークンのわかりやすい名前を入力します。
-
GraphQL Analytics API へのアクセスは、Permissions のドロップダウンで設定します。
-
GraphQL Analytics API の権限を設定するには、1 つ目のドロップダウンで Account、2 つ目で Account Analytics、3 つ目で Read を選びます。
この例では、Analytics API への読み取りアクセスをアカウント単位で付与します。
- トークンがアクセスできるゾーンは、Zone Resources のドロップダウンで設定します。この例では、すべてのゾーンへのアクセスを付与します。
- API トークンを特定の IP アドレスに制限する場合は、Client IP Address Filtering を使います。
- トークンの有効期間は、TTL（time-to-live）の開始日と終了日で定義します。
- Continue to summary を選びます。
次の節では、API トークンの確認とテストの方法を説明します。
Continue to summary を選ぶと、API Token Summary ページが表示されます。
API Token Summary で、API トークンの権限とリソースが意図どおりかを、作成前に確認します。
設定を確認したら、Create Token を選びます。
新しいトークンを作成すると、トークンとカスタムの curl コマンドを含む確認ページが表示されます。
トークンをデバイスのクリップボードへコピーするには、Copy を選びます。
トークンをテストするには、curl コマンドをコピーしてターミナルに貼り付けます。
完了したら、View all API tokens を選びます。