mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-19 15:26:59 +00:00
Cleanup CloudFlare documentation (#22617)
Co-authored-by: Franck Nijhof <git@frenck.dev>
This commit is contained in:
parent
5047787f38
commit
7d3f066992
@ -13,35 +13,15 @@ ha_config_flow: true
|
|||||||
ha_integration_type: integration
|
ha_integration_type: integration
|
||||||
---
|
---
|
||||||
|
|
||||||
With the `cloudflare` integration, you can keep your Cloudflare records up to date.
|
With the Cloudflare integration, you can keep your Cloudflare DNS records up to date.
|
||||||
|
|
||||||
The integration runs every hour, but can also be started manually by using the service `cloudflare.update_records` under services.
|
The integration runs every hour, but can also be triggered by running the {% my developer_services title="`cloudflare.update_records` service" service="cloudflare.update_records" %}.
|
||||||
|
|
||||||
<div class='note warning'>
|
|
||||||
|
|
||||||
Due to a limitation in the Cloudflare API, you can not use this integration with any of the following TLD's:
|
|
||||||
|
|
||||||
- `.cf`
|
|
||||||
- `.ga`
|
|
||||||
- `.gq`
|
|
||||||
- `.ml`
|
|
||||||
- `.tk`
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
## Requirements
|
## Requirements
|
||||||
|
|
||||||
<div class='note warning'>
|
The setup requires an API Token created with `Zone:Zone:Read` and `Zone:DNS:Edit` permissions for all zones in your account.
|
||||||
|
|
||||||
On older versions of Home Assistant, this integration used the account email and Global API Key to authenticate.
|
An easy way to create this is to start with the "Edit zone DNS" template then add `Zone:Zone:Read` to the permissions.
|
||||||
|
|
||||||
As of Home Assistant 0.117, API Tokens are now used to authenticate.
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
Setup requires an API Token created with Zone:Zone:Read and Zone:DNS:Edit permissions for all zones in your account.
|
|
||||||
|
|
||||||
An easy way to create this is to start with the "Edit zone DNS" template then add Zone:Zone:Read to the permissions.
|
|
||||||
|
|
||||||
[Cloudflare API Tokens Guide](https://developers.cloudflare.com/api/tokens/create)
|
[Cloudflare API Tokens Guide](https://developers.cloudflare.com/api/tokens/create)
|
||||||
|
|
||||||
@ -53,47 +33,18 @@ An easy way to create this is to start with the "Edit zone DNS" template then ad
|
|||||||
|
|
||||||
This platform uses the API from [ipify.org](https://www.ipify.org/) to set the public IP address.
|
This platform uses the API from [ipify.org](https://www.ipify.org/) to set the public IP address.
|
||||||
|
|
||||||
### Home Assistant Companion App
|
### Limitations
|
||||||
|
|
||||||
If you would like to use [iOS App](https://companion.home-assistant.io/) via Cloudflare set **Minimum TLS version as 1.2**, in order to do that, do the following:
|
#### Unusable TLDs
|
||||||
|
|
||||||
1. Login to your [Cloudflare](https://dash.cloudflare.com/) account.
|
Due to a limitation in the Cloudflare API, you can not use this integration with any of the following TLD's:
|
||||||
2. Choose your domain.
|
|
||||||
3. Click on the `SSL/TLS` icon.
|
|
||||||
4. Go to tab `Edge Certificates`.
|
|
||||||
5. Find `Minimum TLS Version` and set it to **1.2**.
|
|
||||||
|
|
||||||
Other settings should not cause any issues.
|
- `.cf`
|
||||||
|
- `.ga`
|
||||||
|
- `.gq`
|
||||||
|
- `.ml`
|
||||||
|
- `.tk`
|
||||||
|
|
||||||
### SSH over Cloudflare
|
#### Record types
|
||||||
|
|
||||||
For SSH usage (according to [this](https://blog.cloudflare.com/cloudflare-now-supporting-more-ports/) source), you need to connect directly to your server (bypassing Cloudflare). To do that, create a `CNAME` DNS record, e.g., `ssh.example.com`, with proxy status as "DNS only" (to do that click on orange icon, it will change color to gray) and then connect to `ssh.example.com` using your server SSH port.
|
This integration can only update A records.
|
||||||
|
|
||||||
#### The minimum DNS record settings (if you have set up HTTPS already)
|
|
||||||
|
|
||||||
To redirect from your domain to the IP address of your Home Assistant instance, set this DNS record:
|
|
||||||
|
|
||||||
```text
|
|
||||||
Type: A
|
|
||||||
Name: @
|
|
||||||
IPv4 Address: your.ip.address
|
|
||||||
```
|
|
||||||
|
|
||||||
You can find your current IP address using [this](https://api.ipify.org/) page.
|
|
||||||
|
|
||||||
In order to redirect from `https://www` to `https://` you need to set this DNS record:
|
|
||||||
|
|
||||||
```text
|
|
||||||
Type: CNAME
|
|
||||||
Name: @
|
|
||||||
Target: example.com (your actual domain)
|
|
||||||
```
|
|
||||||
|
|
||||||
And also create Page Rule:
|
|
||||||
|
|
||||||
```text
|
|
||||||
If the URL matches: www.example.com*
|
|
||||||
Then the settings are: Forwarding URL
|
|
||||||
Status: 302 - Temporary redirect
|
|
||||||
Destination URL: https://example.com/$1
|
|
||||||
```
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user