Skip to content
This repository has been archived by the owner on Jan 7, 2020. It is now read-only.

percipient/strongarm-msdns

Repository files navigation

strongarm-msdns

strongarm-msdns is STRONGARM's Microsoft DNS integration that updates DNS zones according to the list of blackholed domains provided by the STRONGARM API.

https://travis-ci.org/percipient/strongarm-msdns.svg?branch=master https://coveralls.io/repos/percipient/strongarm-msdns/badge.svg?branch=master&service=github

features

  • fetch blackholed domains from STRONGARM API through stronglib.
  • create DNS zones in Microsoft DNS to blackhole domains
  • reload existing blackholed domains to different blackhole IP

installation

strongarm-msdns is still in beta. We plan to provide a pre-built Windows installer to make the installation process easy. In the meantime:

  1. Install Python and pywin32.
  2. Install the latest development version of strongarm-msdns directly from GitHub using pip:
$ pip install --upgrade https://github.com/percipient/strongarm-msdns/tarball/master

usage

We plan to provide a Windows service that runs the updater automatically. In the meantime, you can run the updater manually in Python on a Microsoft DNS server with WMI enabled:

from strongarm_msdns import MicrosoftDnsUpdater

# Initialize updater with blackhole IP.
dns_updater = MicrosoftDnsUpdater('127.0.0.1')

# Run the updater with STRONGARM API key.
dns_updater.run(your_key)

DNS zones will be created for all domains fetched from the STRONGARM API. The call returns a list of domain names that failed to be blackholed.

contribute

  1. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
  2. If you feel uncomfortable or uncertain about an issue or your changes, feel free to email @dicato and he will happily help you.
  3. Fork the repository on GitHub to start making your changes to the master branch (or branch off of it).
  4. Write a test which shows that the bug was fixed or that the feature works as expected.
  5. Send a pull request and bug the maintainer until it gets merged and published. :) Make sure to add yourself to AUTHORS.

About

STRONGARM's Microsoft DNS Integration

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages