DNS server for parking domains securely
Project description
Domain Park: Prevent abuse of parked domains
domain-park
is a DNS Name Server designed to prevent spoofed emails on parked domains.
Features:
- Implement best practice DNS records for SPF, DKIM, DMARC, MX compliance.
- Handle unlimited domains with little to no configuration.
domain-park
is currently Alpha software and does not have complete documentation, testing, or implementation of certain features.
Installation
Install via pip
pip3 install --user domain-park
Usage
domain-park --help
usage: domain-park [-h] [--version] [--host HOST] [--port PORT]
[--tcp | --udp] -n NAMESERVER [--rua EMAIL] [--ruf EMAIL]
[--ips]
optional arguments:
-h, --help show this help message and exit
--version show program's version number and exit
--host HOST Host (IP) to bind to. Use --ips to see available.
Defaults to localhost.
--port PORT Port to bind to. Defaults to 9953.
--tcp Use TCPv4 socket for transport.
--udp Use UDPv4 socket for transport. (default)
-n NAMESERVER, --nameserver NAMESERVER
Add NameServer to list returned on NS lookups. This
should be equal to the NS records available publicly
running domain-park. Must be supplied at least once,
and has no limit. Reccomended to have 2-4 Name
Servers. Expected to be in the format of either
'FQDN:IP' or 'IP'
--rua EMAIL Email address to use for DMARC aggregate repots.
--ruf EMAIL Email address to use for DMARC forensic reports.
--ips Print available IPs and exit
Example:
domain-park -n ns1.parkit-beta.nicholashairs.com -n ns2.parkit-beta.nicholashairs.com
Once running, interact using dig
:
dig -p 9953 @localhost NS example.com
dig -p 9953 @localhost TXT example.com
dig -p 9953 @localhost TXT foo.example.com
dig -p 9953 @localhost TXT _dmarc.example.com
dig -p 9953 @localhost TXT asdf._domainkey.example.com
dig -p 9953 @localhost TXT qwer._domainkey.foo.example.com
dig -p 9953 @localhost MX example.com
Bugs, Feature Requests etc
TLDR: Please submit an issue on github.
In the case of bug reports, please help me help you by following best practices [1] [2].
In the case of feature requests, please provide background to the problem you are trying to solve so to help find a solution that makes the most sense for the library as well as your usecase.
Development
The only development dependency is bash and docker. All actions are run within docker for ease of use. See ./dev.sh help
for commands. Typical commands are format
, lint
, test
, repl
, build
.
I am still working through open source licencing and contributing, so not taking PRs at this point in time. Instead raise and issue and I'll try get to it as soon a feasible.
Licence
This project is licenced under the MIT Licence - see LICENCE
.
This project includes other open source licenced software - see NOTICE
.
Authors
A project by Nicholas Hairs - www.nicholashairs.com.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for domain_park-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 837c8d66465547d1445ac8a3653219d02309b48186358c4bc4ebb17125871179 |
|
MD5 | d9154f833a22ccb8a0ed6a9be8f31337 |
|
BLAKE2b-256 | 5da7c6ab6e71bb392bb9fdab32e2689f542b2ff4bc1b53bb56a9d3b327423c61 |