サービストークン

1. Cloudflare ダッシュボード ↗ で Zero Trust > Access controls > Service credentials > Service Tokens を開きます。

2. Create Service Token を選択します。

3. サービストークンに名前を付けます。名前があると、ログ内の関連イベントを識別しやすく、トークンを個別に取り消せます。

4. Service Token Duration を選びます。トークンの有効期限が決まります。

5. Generate token を選択します。サービストークンの Client ID と Client Secret、およびそれぞれのリクエストヘッダーが表示されます。

6. Client Secret をコピーします。

1. Access Service Tokens エンドポイントに POST リクエストを送ります。

   Required API token permissions

   At least one of the following token permissions is required:

   • Access: Service Tokens Write

   curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/access/service_tokens" \
   	--request POST \
   	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
   	--json '{
   		"name": "CI/CD token",
   		"duration": "8760h"
   	}'

2. レスポンスの client_id と client_secret の値をコピーします。

   "result": {
   	"client_id": "88bf3b6d86161464f6509f7219099e57.access",
   	"client_secret": "bdd31cbc4dec990953e39163fbbb194c93313ca9f0a6e420346af9d326b1d2a5",
   	"created_at": "2025-09-25T22:26:26Z",
   	"expires_at": "2026-09-25T22:26:26Z",
   	"id": "3537a672-e4d8-4d89-aab9-26cb622918a1",
   	"name": "CI/CD token",
   	"updated_at": "2025-09-25T22:26:26Z",
   	"duration": "8760h",
   	"client_secret_version": 1
   }

1. cloudflare_api_token ↗ に次の権限を追加します。

   • Access: Service Tokens Write

2. cloudflare_zero_trust_access_service_token ↗ リソースを設定します。

   resource "cloudflare_zero_trust_access_service_token" "example_service_token" {
   	account_id = var.cloudflare_account_id
   	name       = "Example service token"
   	duration  = "8760h"
   
   	lifecycle {
   		create_before_destroy = true
   	}
   }

3. サービストークンの Client ID と Client Secret を取得します。

   例: CLI に出力する

   1. Client ID と Client Secret を Terraform の state ファイルに出力します。

      output "example_service_token_client_id" {
      	value     = cloudflare_zero_trust_access_service_token.example_service_token.client_id
      }
      
      output "example_service_token_client_secret" {
      	value     = cloudflare_zero_trust_access_service_token.example_service_token.client_secret
      	sensitive = true
      }

   2. 構成を適用します。

      terraform apply

   3. Client ID と Client Secret を読み取ります。

      terraform output -raw example_service_token_client_id

      terraform output -raw example_service_token_client_secret

   例: HashiCorp Vault に保存する

   	resource "vault_generic_secret" "example_service_token" {
   		path         = "kv/cloudflare/example_service_token"
   
   		data_json = jsonencode({
   			"CLIENT_ID"     = cloudflare_access_service_token.example_service_token.client_id
   			"CLIENT_SECRET" = cloudflare_access_service_token.example_service_token.client_secret
   		})
   	}

Rotate a service token エンドポイントに POST リクエストを送ります。以前のシークレットの期限切れ日時は、previous_client_secret_expires_at に RFC 3339 のタイムスタンプで指定します。

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/access/service_tokens/$SERVICE_TOKEN_ID/rotate" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"previous_client_secret_expires_at": "2030-01-01T00:00:00Z"
	}'

以前のシークレットをすぐに無効にする場合は、リクエストから previous_client_secret_expires_at を省略します。

1. Cloudflare ダッシュボード ↗ で Zero Trust > Access controls > Service credentials > Service Tokens を開きます。
2. 更新するトークンを探します。
3. トークンの有効期間を 1 年延長するには、Refresh を選びます。
4. 1 年より長く延長するには、次の手順を行います。
   1. Edit を選びます。
   2. 新しい Service Token Duration を選びます。
   3. Save を選びます。有効期限は、選んだ期間だけ延長されます。

トークンの有効期間を 1 年延長するには、Refresh a service token エンドポイントに POST リクエストを送ります。

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/access/service_tokens/$SERVICE_TOKEN_ID/refresh" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

カスタム期間で延長するには、新しい duration を指定して Update a service token エンドポイントに PUT リクエストを送ります。

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/access/service_tokens/$SERVICE_TOKEN_ID" \
	--request PUT \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"duration": "17520h"
	}'

サービストークンを更新するには、cloudflare_zero_trust_access_service_token ↗ リソースの duration 属性を更新して適用します。Cloudflare は、更新時点を基準に有効期限をリセットします。

resource "cloudflare_zero_trust_access_service_token" "example_service_token" {
	account_id = var.cloudflare_account_id
	name       = "Example service token"
	duration   = "17520h"

	lifecycle {
		create_before_destroy = true
	}
}

Update a service token エンドポイントに PUT リクエストを送ります。トークンをオフにするには、enabled を false にします。

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/access/service_tokens/$SERVICE_TOKEN_ID" \
	--request PUT \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"name": "<TOKEN_NAME>",
		"enabled": false
	}'

トークンを再びオンにするには、enabled を true にします。

1. Cloudflare ダッシュボード ↗ で Zero Trust > Access controls > Service credentials > Service Tokens を開きます。
2. 取り消すトークンで Delete を選びます。

Delete a service token エンドポイントに DELETE リクエストを送ります。

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/access/service_tokens/$SERVICE_TOKEN_ID" \
	--request DELETE \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

サービストークンを取り消すには、設定から cloudflare_zero_trust_access_service_token ↗ リソースを削除して terraform apply を実行するか、破棄対象として指定します。

terraform destroy -target=cloudflare_zero_trust_access_service_token.example_service_token