Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Hostfact module for Cloudflare DNS management

Software License StyleCI Quality Score

This module allows you to manage Cloudflare DNS records from HostFact (version > 5.1).

Installation

Copy the cloudflare folder to your HostFact installation at Pro/3rdparty/modules/dns/dnsmanagement/integrations/. Go to the modules overview in Hostfact and make sure you fill in all settings.

Authentication

The module supports two ways to authenticate with Cloudflare:

  • API Token (recommended): create a token in the Cloudflare dashboard (My Profile > API Tokens) with the permissions Zone.Zone (Edit) and Zone.DNS (Edit). Fill in the token as API key and leave the e-mail address empty.
  • Global API Key (legacy): fill in both your Cloudflare account e-mail address and your Global API Key.

The Account ID (needed to create new zones) can be found on the overview page of any domain in the Cloudflare dashboard.

Proxy status ("orange cloud")

HostFact has no dedicated field for the Cloudflare proxy status, so the module uses the TTL of A, AAAA and CNAME records — matching how Cloudflare itself works, since proxied records always have TTL "automatic" (1):

  • TTL 1 = proxied through Cloudflare (orange cloud)
  • Any regular TTL (e.g. 3600) = DNS-only (grey cloud)

Set the TTL to 1 to enable the proxy for a record, or to a regular TTL to disable it. Unproxied records with an "automatic" TTL at Cloudflare are shown with TTL 300 (the value Cloudflare effectively uses), so TTL 1 in HostFact always means proxied.

Notes

  • Records with a type that HostFact does not support are shown as read-only and are left untouched when saving.

Usage

Add a nameserver group that matches you Cloudflare nameservers under DNS Management in HostFact. Open a domain using these nameservers to edit the records.

Testing

Copy TestVariables.php.dist to TestVariables.php and fill in your credentials.

php test.php

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email support@creacoon.nl instead of using the issue tracker.

Postcardware

You're free to use this package, but if it makes it to your production environment we highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using.

Our address is: Creacoon, Aziëstraat 15, 6014 DA Ittervoort, The Netherlands.

Credits

Support us

Creacoon is a software company based in The Netherlands.

License

The MIT License (MIT). Please see License File for more information.

About

Hostfact module for Cloudflare DNS management

Topics

Resources

Contributing

Stars

6 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages