October 10, 2022 . 3 MIN READ
To set up the Cloudflare integration in RunCloud, first go to your Personal Space or Workspace Settings area in the RunCloud dashboard.
From there, navigate to 3rd Party Integrations.
Next, select Cloudflare from the list of available integrations and click Add Integration. This will start the process of connecting your Cloudflare account to RunCloud.
During the setup process, you will need to provide the following information:
Label
The label is simply a name used to identify the Cloudflare account you are connecting. This is especially helpful if you plan to connect multiple Cloudflare accounts. The label will appear throughout the RunCloud dashboard when using Cloudflare features, such as when creating a web application. For easier identification, it is recommended to use a clear and descriptive label instead of the default name “Cloudflare”.
Cloudflare Email
Enter the email address associated with your Cloudflare account.
API Token
You can authenticate using either the Global API Key from Cloudflare or a Custom API Token with limited permissions.
To find your API key, log in to your Cloudflare dashboard and go to your Profile section. From there, navigate to the API Tokens page.
Scroll to the bottom of the page where you will find both the Global API Key and the Origin CA Key. To connect RunCloud with Cloudflare, you should use the Global API Key. Click View to reveal the key and copy it.
Once you have the required details, return to the RunCloud dashboard, enter the information, and click Save Integration.
If the connection is successful, the integration will be saved and a confirmation message will appear. If an error occurs, double-check that the API key is correct and that the email address matches the one associated with your Cloudflare account. If the issue continues, you may need to contact support.
Instead of using the Global API Key, you can create a Custom API Token with restricted permissions for better security.
To do this, open the domain you want to connect in your Cloudflare dashboard and select Get your API token.
On the API tokens page, click Create Token to generate a new key. You will then be asked to choose a template. The Edit Zone DNS template is a good starting point.
When configuring the token, make sure the following permissions are enabled:
Account Settings: Read
DNS: Edit
Zone: Edit
Next, select the specific account and zone resources the token should have access to. You can also enable IP filtering or set an expiration date for additional security.
Keep in mind that if the token expires, you will need to manually update it in the RunCloud dashboard.
After confirming the settings, create the token. The token will only be displayed once, so be sure to copy it before leaving the page.
Finally, go back to your RunCloud dashboard, open Account Settings, navigate to the Integrations tab, and select Cloudflare. Instead of entering the Global API Key, paste the Custom Token you generated.
Once saved, RunCloud will connect to your Cloudflare account using the scoped permissions you configured.
Reference:
https://runcloud.io/knowledgebase/articles/server-management/how-do-i-setup-cloudflare-dns-management
