Hover DNS Update Script

This project is a Python script for updating DNS records on Hover. It supports optional logging and the use of mitmproxy for debugging HTTP/HTTPS requests.

Dependencies

• Python 3.x
• requests library
• mitmproxy (optional, for debugging)

Setup Instructions

1. Clone the Repository

git clone <repository_url>
cd <repository_directory>

2. Install Python Dependencies

Install the required Python libraries using pip:

pip install requests

3. Install mitmproxy (Optional)

mitmproxy is used for debugging HTTP/HTTPS requests. To install mitmproxy, run:

pip install mitmproxy

4. Create Configuration Files

Create the following configuration files:

config.json

Create a config.json file in the project directory with the following content:

{
    "dnsid": "<your_dns_id>",
    "username": "<your_hover_username>",
    "password": "<your_hover_password>",
    "discoverip": "true",
    "srcdomain": "",
    "ipaddress": "",
    "totp_secret": "<your_totp_secret>",
}

Replace the placeholders with your actual values.

IP

Create an empty IP file in the project directory:

touch IP

Usage Instructions

Running the Script

To run the script, use the following command:

python hover-update.py [--logging] [--mitm]

Command Line Arguments

• --logging: Enable logging to hover-update.log.
• --mitm: Enable mitmproxy for HTTP/HTTPS requests.

Example

To run the script with logging enabled:

python hover-update.py --logging

To run the script with mitmproxy enabled:

python hover-update.py --mitm

To run the script with both logging and mitmproxy enabled:

python hover-update.py --logging --mitm

Using mitmproxy for Debugging

mitmproxy is a powerful tool for debugging HTTP/HTTPS requests. Follow these steps to use mitmproxy with this script:

1. Start mitmproxy

Start mitmproxy in your terminal:

mitmproxy

This will start mitmproxy and listen on port 8080 by default.

2. Run the Script with mitmproxy Enabled

Run the script with the --mitm flag to route HTTP/HTTPS requests through mitmproxy:

python hover-update.py --mitm

3. Inspect Requests and Responses

In the mitmproxy interface, you can inspect the HTTP/HTTPS requests and responses being made by the script. This is useful for debugging and understanding the interactions with the Hover API.

File Structure

• hover-update.py: Main script for updating DNS records on Hover.
• totp.py: Contains the TOTP generation function.
• config.json: Configuration file with user credentials and settings.
• IP: File to store the last known IP address. (Automically generated when the IP is resolved).
• hover-update.log: Log file (created automatically if logging is enabled).

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub.

Contact

For any questions or issues, please contact [email protected].