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
- 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.
- Check the permissions
Leave them as they come:
Zone · Zone · Read,Zone · Zone Settings · Edit,Zone · DNS · EditandZone · Cache Purge · Purge. - Choose your zone
Under Zone Resources, pick Include, Specific zone and the domain of your store. The token then only works on that domain.
- 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.
- Create it
Click Continue to summary, check the summary and click Create Token.
- 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
| Message | What to do |
|---|---|
| The token is not valid or not active | The token was copied incompletely, deleted, or has expired. Create a new one and paste it again. |
| The token cannot see a zone for this domain | The 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 error | A 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