The domain registrar ASCIO allows one to manage domains using their APIs.
To automate the registration/update process we implemented the most important API endpoints as Ansible modules:
Ansible Galaxy: Collection
# install the requirements on your controller
python3 -m pip install -r requirements.txt
# install the collection
ansible-galaxy install niceshopsOrg.ascio
# OR
ansible-galaxy install git+https://github.com/niceshops/ansible-module-ascio.git
To allow connections using the API you need to add your source Public-IPs to the allow-list which you can find in your ASCIO account settings!
Check out the example playbook!
Each query is limited to 1000 domains! If you have more than that you will have to go through multiple 'pages' (multiple runs)
The main challenge when configuring the domain config is that there are different requirements for some TLD's.
You can check the requirements a TLD using the ASCIO TLDKit:
- Open the URL
https://tldkit.ascio.com/api/v1/Tldkit/<TLD>(replace the trailing '<TLD>') - Log-in with your ASCIO credentials
You will have to either:
- hard-code the contact-information for every domain
- implement an automated logic to merge & modify your default contacts to fit every TLD (that's how we do it)
As an example on how a raw TLD-Config could look like - see: example config
Check out the example playbook!