dynhost

A python module for OVH DynHost update

Getting started

Prerequisites

This application requires Python3 :

$ apt install python3 python3-pip

You also need to install nslookup module for Python3 (https://pypi.org/project/nslookup/) :

$ pip3 install nslookup

cURL is required to perform queries to OVH API :

$ apt install curl

Installation

Cloning the repository

$ git clone https://github.com/Syyyyyn/dynhost.git

Configure

Edit settings.py with your informations :

zone = 'exemple.com'
nameservers = ['213.251.128.150', '213.251.188.150']
dynhost_creds = {
    'username': 'exemple.com-dynhost',
    'password': 'P@ssw0rd'
}
dns_records = ['exemple.com', 'www.exemple.com', 'mail.exemple.com']

It is higly recommanded to change the permissions of this file in order to protect sensitive informations :

$ chmod 640 settings.py

Runnning a cron job

To ensure the DNS zone is updated frequently, running the script every 30 minutes is recommended (for a TTL of 3600). Replace /root/dynhost/dynhost.py with the absolute path to dynhost.py.

$ echo '*/30 * * * * root /usr/bin/python3 /root/dynhost/dynhost.py' >> /etc/crontab && service cron restart

Quick use

$ python3 dynhost.py

Logs

The application will automatically output logs to the console as follwed :

$ python3 dynhost.py
---
18-07-2021 15:00:01 :
[+] Public IP address is 213.251.128.150
[+] Resolving exemple.com
[+] Current IP address for exemple.com is 213.251.188.150
[+] Updating exemple.com
[+] Updating www.exemple.com
[+] Updating mail.exemple.com
[+] DNS zone for naonetworks.fr was updated

If you wish to keep track of these actions, simply create a logs folder in the same directory as dynhost.py.

Enable logs

$ mkdir logs

Disable logs

$ rm -r logs/

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.