dns/README.md
2020-01-17 16:23:33 +01:00

29 lines
1.2 KiB
Markdown

## Re2o - DNS
This service uses Re2o API to generate DNS zone files
## Requirements
* python3
* knot (only if using knot)
* requirements in https://gitlab.federez.net/re2o/re2oapi
## Scripts
* `main.py`: Generates the zone files and reloads the zones
* `dnssec_generate.py`: Generate the DS records for the zones in `dnssec_domains.json` and writes them to `dnssec.json`
## Configuration file
The template of the configuration file is given in `config.ini.example`. You should copy it into `config.ini` and modify at least the first 3 paramters :
| Parameter | Default value | Description |
|------------|--------------------|--------------------------------|
| `hostname` | `re2o.example.net` | Hostname of your re2o instance |
| `username` | `my_api_username` | Username to access the api |
| `password` | `my_api_password` | Password to access the api |
| `use_tls` | `true` | Use TLS to connect to the api |
| `use_knot` | `false` | Use knot specific commands |
For boolean parameters, according to https://docs.python.org/3/library/configparser.html, 'yes'/'no', 'on'/'off', 'true'/'false' and '1'/'0' are valid parameters.