Skip to content

Latest commit

 

History

History
117 lines (94 loc) · 3.42 KB

README.md

File metadata and controls

117 lines (94 loc) · 3.42 KB

Windows-DNS-RES-API

Introduction

This project provides a web interface for adding and removing DNS records in a Windows environment. The program is written using Python and the Flask library, enabling easy management of DNS records through a REST API.

Table of Contents

Installation

Operating System Preparation

  1. Install necessary Windows features and enable PSRemoting:

    Install-WindowsFeature -Name "WindowsPowerShellWebAccess"
Enable-PSRemoting -Force
Set-Item WSMan:\localhost\Client\TrustedHosts -Value "RemoteHostName"
Enable-NetFirewallRule -Name "WINRM-HTTP-In-TCP"
Enable-NetFirewallRule -Name "WINRM-HTTPS-In-TCP"
Set-NetFirewallRule -Name "WINRM-HTTP-In-TCP" -Enabled True
winrm enumerate winrm/config/listener
Enable-PSRemoting -Force

  2. Install curl:

    Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
choco install curl -y

Python and Package Installation

  1. Install Python from python.org.

  2. Install required Python packages:

    pip install flask pywinrm

Running the Program

  1. Run the DNS API program: 
    python dns_api.py

Install as a Windows Service

  1. Install pywin32 package:

    pip install pywin32

  2. Install and start the service:

    python flask_service.py install
python flask_service.py start
sc config FlaskDNSService start= auto

Removing the Service

  1. Stop and remove the service: 
    python flask_service.py stop
python flask_service.py remove

Usage

The API provides endpoints to add and remove DNS records. Below are examples of how to use the API with curl.

Testing

  1. Create DNS record A:

    curl -X POST -H "Content-Type: application/json" -d "{\"name\": \"test\", \"type\": \"A\", \"value\": \"192.168.1.1\"}" http://localhost:5000/dns/add

  2. Delete DNS record A:

    curl -X POST -H "Content-Type: application/json" -d "{\"name\": \"test\", \"type\": \"A\", \"value\": \"192.168.1.1\"}" http://localhost:5000/dns/delete

  3. Create PTR record:

    curl -X POST -H "Content-Type: application/json" -d "{\"ip\": \"147.232.204.10\", \"ptr_name\": \"example.yourdomain.com\"}" http://localhost:5000/dns/add_ptr

  4. Delete DNS record PTR:

    curl -X POST -H "Content-Type: application/json" -d "{\"ip\": \"147.232.204.10\"}" http://localhost:5000/dns/delete_ptr

Features

  • Web interface for managing DNS records
  • Support for A and PTR records
  • Easy integration with Windows services

Dependencies

  • Windows OS with PowerShell Web Access
  • Python 3.12.4 or later
  • Flask
  • pywinrm
  • pywin32

Configuration

No additional configuration is required beyond the installation steps provided.

Contributors

License

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