Domains, DNS and SSL2 min readUpdated

Connect Cloudflare to the console

Create the Cloudflare API token with the right permissions and connect your zone on the application's Cloudflare tab, step by step.

To manage Cloudflare from the console, the console needs an API token from your Cloudflare account. The token is a key that can only do what you allow: here, read your zone, change its settings and DNS records, and purge its cache. Nothing else in your Cloudflare account.

Before you start: the domain must already be in your Cloudflare account, with Cloudflare's nameservers active (the zone shows Active in Cloudflare). If it is still pending, finish that first in Cloudflare.

1. Open the Cloudflare tab of the application

In the console, open the server, then Applications, the application, and the Cloudflare tab. You see the steps below and a field for the token.

2. Create the token in Cloudflare

  1. Click Create the ShopWhizzy token

    The link on the tab opens Cloudflare's token form with the name ShopWhizzy and the four permissions already filled in. Sign in to Cloudflare if it asks.

  2. Check the permissions

    Leave them as they come: Zone · Zone · Read, Zone · Zone Settings · Edit, Zone · DNS · Edit and Zone · Cache Purge · Purge.

  3. Choose your zone

    Under Zone Resources, pick Include, Specific zone and the domain of your store. The token then only works on that domain.

  4. Leave the rest as it is

    Client IP Address Filtering and TTL are optional. If you set an end date, the connection stops working on that day and you need a new token.

  5. Create it

    Click Continue to summary, check the summary and click Create Token.

  6. Copy it

    Cloudflare shows the token only once. Click Copy. Do not use the test command it shows; you do not need it.

Prefer to build the token by hand? In Cloudflare go to My Profile (the person icon, top right), API Tokens, Create Token, Create Custom Token, and add the same four permissions and the same zone.

3. Paste it in the console

Back on the Cloudflare tab, paste the token in API token and click Connect Cloudflare. The console finds the zone of the application's domain on its own and shows the settings, the cache purge and the DNS records.

The token is stored encrypted on our platform and is only used for that application's zone. It is never copied to your server.

When it does not connect

MessageWhat to do
The token is not valid or not activeThe token was copied incompletely, deleted, or has expired. Create a new one and paste it again.
The token cannot see a zone for this domainThe zone chosen in the token is not the domain of this application, or the Zone · Zone · Read permission is missing. Edit the token in Cloudflare (or create a new one) with the right zone.
Cloudflare answered: ... Authentication errorA permission is missing. Check the four permissions above.

Disconnect

At the bottom of the tab, Disconnect Cloudflare deletes the token on our side. Then delete it in Cloudflare too: My Profile, API Tokens, the three dots next to ShopWhizzy, Delete.

What to set once you are connected: Using Cloudflare in front of your server.

Did this solve it? If not, tell us what you see and we look at your server.

Open a ticket

Still stuck? Ask a person.

Tickets go straight to the engineers who run ShopWhizzy servers. Tell us the store, what you see and when it started, and we take it from there.