Hanzo
PlatformHanzo KMSIntegrationsApp Connections

Cloudflare Connection

Learn how to configure a Cloudflare Connection for Hanzo KMS.

Hanzo KMS supports connecting to Cloudflare using API tokens and Account ID for secure access to your Cloudflare services.

Configure API Token and Account ID for Hanzo KMS

Navigate to your Cloudflare dashboard and go to Profile.

Navigate Cloudflare Profile

Click API Tokens > Create Token to generate a new API token.

Create API Token

Configure your API token with the necessary permissions for your Cloudflare services.

Depending on your use case, add one or more of the following permission sets to your API token:

Use the following permissions to grant Hanzo KMS access to sync secrets to Cloudflare Pages:

Configure Token

Required Permissions:

  • Account - Cloudflare Pages - Edit
  • Account - Account Settings - Read

Add these permissions to your API token and click Continue to summary, then Create Token to generate your API token.

Use the following permissions to grant Hanzo KMS access to sync secrets to Cloudflare Workers:

Configure Token

Required Permissions:

  • Account - Workers Scripts - Edit
  • Account - Account Settings - Read

Add these permissions to your API token and click Continue to summary, then Create Token to generate your API token.

Use the following permissions to grant Hanzo KMS access to verify certificates using DNS TXT records with ACME:

Configure Token

Required Permissions:

  • Account - Account Settings - Read
  • Zone - DNS - Edit

Add these permissions to your API token and click Continue to summary, then Create Token to generate your API token.

Use the following permissions to grant Hanzo KMS access to sync certificates to Cloudflare as Custom SSL certificates:

Configure Token

Required Permissions:

  • Account - Account Settings - Read
  • Zone - SSL and Certificates - Edit

These permissions allow Hanzo KMS to upload, update, and delete custom SSL certificates in your Cloudflare zones.

Add these permissions to your API token and click Continue to summary, then Create Token to generate your API token.

After creation, copy and securely store your API token as it will not be shown again.

Generated API Token

Keep your API token secure and do not share it. Anyone with access to this token can manage your Cloudflare resources based on the permissions granted.

From your Cloudflare Account Home page, click on the account information dropdown and select Copy account ID.

Account ID

Save your Account ID for use in the next step.

Setup Cloudflare Connection in Hanzo KMS

Navigate to the Integrations tab in the desired project, then select App Connections. App Connections
Tab

Select the Cloudflare Connection option from the connection options modal. Select Cloudflare
Connection

Enter your Cloudflare API token and Account ID in the provided fields and click Connect to Cloudflare to establish the connection. Connect to
Cloudflare

Your Cloudflare Connection is now available for use in your Hanzo KMS projects. Cloudflare Connection
Created

API token connections require manual token rotation when your Cloudflare API token expires or is regenerated. Monitor your connection status and update the token as needed.

How is this guide?

Last updated on

On this page