Skip to main content

Integrate with Cloudflare

Support level: Community

What is Cloudflare​

Cloudflare is a global cloud services provider that enhances the security, performance, and reliability of websites and applications through its content delivery network (CDN), DDoS protection, and web infrastructure solutions.

-- https://www.cloudflare.com/

Preparation​

The following placeholders are used in this guide:

  • acmecorp.company is the FQDN of your company's email domain.
  • authentik.company is the FQDN of the authentik installation.
info

This documentation lists only the settings that you need to change from their default values. Be aware that any changes other than those explicitly mentioned in this guide could cause issues accessing your application.

Prerequisites

Before proceeding, ensure you have a Cloudflare account and that authentik is already configured with Cloudflare Access, following the steps in our integration guide.

Cloudflare configuration​

  1. Log in to the Cloudflare Dashboard as an administrator.
  2. Navigate to My account (sidebar) > Account API tokens and click Create.
  3. Under Create Custom Token, select Get Started. Add an Account permission with the SSO Connector: Edit scope. Store this token securely; you will need it throughout this guide, and it can also be used to disable SSO if you are locked out. Complete the process by selecting Continue to Summary, then Create Token.
  4. Copy your Cloudflare Account ID from the dashboard URL. For example, in https://dash.cloudflare.com/<account_id>/home/domains, the <account_id> value is what you need.
  5. Export the following environment variables in your terminal:
export CLOUDFLARE_API_TOKEN=<your_api_token>
export CLOUDFLARE_ACCOUNT_ID=<your_account_id>
  1. Create the SSO connector with the following command:
curl "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/sso_connectors" \
  --request POST \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --json '{"email_domain":"acmecorp.company"}'

An example of a successful response:

{
    "result": {
        "id": "<your_sso_connector_id>",
        "enabled": false,
        "email_domain": "acmecorp.company",
        "created_on": "2025-09-25T21:05:20.462622Z",
        "updated_on": "2025-09-25T21:05:20.462622Z",
        "verification": {
            "code": "cloudflare_dashboard_sso=11111111111111111111",
            "status": "pending"
        }
    },
    "success": true,
    "errors": [],
    "messages": []
}

  1. Copy the code value and create a DNS TXT record containing it at the apex of your email domain.

  2. Next, export your connector ID:

export CLOUDFLARE_SSO_CONNECTOR_ID=<your_sso_connector_id>
  1. After the DNS record has propagated, enable the connector with the following command:
curl "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/sso_connectors/$CLOUDFLARE_SSO_CONNECTOR_ID" \
  --request PATCH \
  --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  --json '{"enabled": true}'

Configuration verification​

To verify the integration, log in to your company’s Cloudflare Access installation with authentik. A new application named SSO App should appear in the dashboard. Selecting it should redirect you to the Cloudflare Dashboard.

Resources​