Metadata-Version: 2.1
Name: domain-park
Version: 0.0.2
Summary: DNS server for parking domains securely
Home-page: https://github.com/nhairs/domain-park
Author: Nicholas Hairs
Author-email: info+domain-park@nicholashairs.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Topic :: Internet
Classifier: Topic :: Internet :: Name Service (DNS)
Requires-Python: >=3.5, <4
Description-Content-Type: text/markdown
Requires-Dist: nserver (<1.0,>=0.0.2)
Requires-Dist: netifaces

# Domain Park: Prevent abuse of parked domains

[![PyPi](https://img.shields.io/pypi/v/domain-park.svg)](https://pypi.python.org/pypi/domai-park/)
[![Python Versions](https://img.shields.io/pypi/pyversions/domain-park.svg)](https://github.com/nhairs/domain-park)
[![License](https://img.shields.io/github/license/nhairs/domain-park.svg)](https://github.com/nhairs/domain-park/blob/master/LICENCE)

`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
```shell
pip3 install --user domain-park
```

## Usage
```
domain-park --help
usage: domain-park [-h] [--version] [--host HOST] [--port PORT]
                   [--tcp | --udp] [--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)
  --ips        Print available IPs and exit
```

Once running, interact using `dig`:

```shell
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](https://github.com/nhairs/domain-park/issues).

In the case of bug reports, please help me help you by following best practices [[1](https://marker.io/blog/write-bug-report/)] [[2](https://www.chiark.greenend.org.uk/~sgtatham/bugs.html)].

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`](https://github.com/nahirs/domain-park/blob/master/LICENCE).

This project may include other open source licenced software - see [`NOTICE`](https://github.com/nhairs/domain-park/blob/master/NOTICE).

## Authors
A project by Nicholas Hairs - [www.nicholashairs.com](https://www.nicholashairs.com).


