Cloudflare Pages sync

Prerequisites:

Set up and add secrets to Infisical Cloud
Create a Cloudflare Connection

Infisical UI
API

Navigate to Project > Integrations and select the Secret Syncs tab. Select the Add Sync button.
Select the Cloudflare Pages option.
Configure the Source from where secrets should be retrieved, then click Next.

Environment: The project environment to retrieve secrets from.
Secret Path: The folder path to retrieve secrets from.

If you need to sync secrets from multiple folder locations, check out secret imports.

Configure the Destination to where secrets should be deployed, then click Next.

Cloudflare Connection: The Cloudflare Connection to authenticate with.
Cloudflare Pages Project: Choose the Cloudflare Pages project you want to sync secrets to.
Environment: Select the deployment environment (preview or production).

Configure the Sync Options to specify how secrets should be synced, then click Next.

Initial Sync Behavior: Determines how Infisical should resolve the initial sync.
- Overwrite Destination Secrets: Removes any secrets at the destination endpoint not present in Infisical.
Key Schema: Template that determines how secret names are transformed when syncing, using {{secretKey}} as a placeholder for the original secret name and {{environment}} for the environment.
Auto-Sync Enabled: If enabled, secrets will automatically be synced from the source location when changes occur. Disable to enforce manual syncing only.
Disable Secret Deletion: If enabled, Infisical will not remove secrets from the sync destination. Enable this option if you intend to manage some secrets manually outside of Infisical.
Variable type: How Cloudflare stores each synced secret
- Secret: Encrypted, so you can’t read the value in the Cloudflare dashboard
- Text: Plain text that you can read in the Cloudflare dashboard

If a secret already exists in the environment as the other type, the sync fails with an error that names it, and nothing in Cloudflare changes. To sync it, delete the variable in Cloudflare or change the sync’s variable type. Syncs created before the variable type option existed skip those secrets rather than failing.

To sync both secrets and text variables to one environment, create one sync of each type from different folders. Each sync only deletes variables of its own type. When you create the second sync, Infisical warns that the destination is already in use. If your organization blocks duplicate destinations, you can’t create the second sync.

Configure the Details of your Cloudflare Pages Sync, then click Next.

Name: The name of your sync. Must be slug-friendly.
Description: An optional description for your sync.

Review your Cloudflare Pages Sync configuration, then click Create Sync.
If enabled, your Cloudflare Pages Sync will begin syncing your secrets to the destination endpoint.

To create a Cloudflare Pages Sync, make an API request to the Create Cloudflare Pages Sync API endpoint.

Sample request

Request

curl --request POST \
  --url https://app.infisical.com/api/v1/secret-syncs/cloudflare-pages \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "my-cloudflare-pages-sync",
    "projectId": "your-project-id",
    "description": "an example sync",
    "connectionId": "your-cloudflare-connection-id",
    "environment": "production",
    "secretPath": "/my-secrets",
    "isEnabled": true,
    "syncOptions": {
      "initialSyncBehavior": "overwrite-destination"
    },
    "destinationConfig": {
      "projectId": "your-cloudflare-pages-project-id",
      "projectName": "my-pages-project",
      "environment": "production"
    }
  }'

Sample response

Response

{
  "secretSync": {
    "id": "your-sync-id",
    "name": "my-cloudflare-pages-sync",
    "description": "an example sync",
    "isEnabled": true,
    "version": 1,
    "folderId": "your-folder-id",
    "connectionId": "your-cloudflare-connection-id",
    "createdAt": "2024-05-01T12:00:00Z",
    "updatedAt": "2024-05-01T12:00:00Z",
    "syncStatus": "succeeded",
    "lastSyncJobId": "123",
    "lastSyncMessage": null,
    "lastSyncedAt": "2024-05-01T12:00:00Z",
    "syncOptions": {
      "initialSyncBehavior": "overwrite-destination"
    },
    "projectId": "your-project-id",
    "connection": {
      "app": "cloudflare",
      "name": "my-cloudflare-connection",
      "id": "your-cloudflare-connection-id"
    },
    "environment": {
      "slug": "production",
      "name": "Production",
      "id": "your-env-id"
    },
    "folder": {
      "id": "your-folder-id",
      "path": "/my-secrets"
    },
    "destination": "cloudflare-pages",
    "destinationConfig": {
      "projectId": "your-cloudflare-pages-project-id",
      "projectName": "my-pages-project",
      "environment": "production"
    }
  }
}

Get started

Managing secrets

Integrations

Cloudflare Pages sync

Sample request

Sample response

​Sample request

​Sample response

Sample request

Sample response