DomainCheck - DomainCheck is designed to assist operators with m

项目说明

DomainCheck

DomainCheck is designed to assist operators with monitoring changes related to their domain names. This includes negati in categorization, detections, and appearances on malware blacklists. DomainCheck currently works only with Namecheap.

DomainCheck pulls a list of domains registered under the provided Namecheap account and then reviews each one to ensure it is ready to be used. This in checking to see if Namecheap's WhoisGuard is enabled, the domain is not expired, the domain is properly categorized, the domain has not been flagged in or tagged with a bad category, and the domain is not blacklisted for spam.

Shepherd

If you like DomainCheck, you may want to look at the Shepherd project. More information here:

Shepherd is a Django application with DomainCheck's functionality baked in, scheduled domain update tasks, and more.

Information Sources

DomainReview uses the following sources to check the health of a domain name:

*
* Cisco Talos
* Bluecoat
* IBM X-Force
* Fortiguard
* TrendMicro
* OpenDNS
* MXToolbox

Additionally, DomainCheck pulls the latest list of "bad" domains from malwaredomains.com and checks if any of the Namecheap domain names make an appearance.

Operation Modes

DomainCheck supports two modes:

Checkup Mode

In checkup mode, DomainCheck pulls the list of domain names and checks each one just once. Once the checks are finished, DomainCheck outputs the data as a csv file. Optionally, if the --wiki flag is provided, DomainCheck also produces the results in the markup language understood by Confluence wikis. This markup can be copy and pasted into a wiki to create a nicely formatted table.

To do this, edit a Confluence wiki page, click "Insert," insert a Markup section, and paste in the DomainCheck-generated markup.

#### Usage

The following command checks all domains under the Namecheap account:

./domaincheck.py checkup --wiki

This command checks only the domains provided for the --filter-list parameter:

./domaincheck.py checkup --wiki --filter-list domaincheck.com,spectreoops.net

Monitor Mode

In monitor mode, DomainCheck will continuously check the domains, either all of the Namecheap domain names or just those the user provides on the command line. A time interval is set (in minutes) and DomainCheck will sleep for that amount of time before re-checking the domains.

Note: The Namecheap API is only queried at the start of a monitoring session, so monitoring must be restarted if new domains are added to the account that also require monitoring.

If the --slack flag is provided and a Slack WebHook is configured, DomainCheck will send your configured Slack message whenever an issue (negati, hit, domain added to a watch list) is detected. These messages are sent in addition to warnings displayed in the terminal.

#### Usage

The following command checks the named domains every 60 minutes and sends a Slack message if an issue is detected:

./domaincheck.py monitor --domains domaincheck.com,spectreoops.net -i 60 --slack

Installation

Using pipenv for managing the required libraries is the best option to avoid Python installations getting mixed-up. Do this:

1. Run: pip3 install --user pipenv or python3 -m pip install --user pipenv
2. Clone DomainCheck's repo.
3. Run: cd DomainCheck && pipen
4. Start using DomainCheck by running: pipen

If you would prefer to not use pipenv, the list of required packages can be found in the Pipfile file.

Final Configurations

DomainCheck uses a domaincheck.config file. A sample is provided which can be edited and renamed (to remove .sample from the end). You will need your Namecheap account and API information, a API key (a free key is fine), and (optional) your Slack WebHook URL. Enter this information into the config file, name it domaincheck.config, and DomainCheck is ready to be used.

Acknowledgments

Special thanks to SpecterOps for supporting this project!

Change Log

21 December 2018

* Made some impro and tweaks to the wiki and cs.
* Added missing logic that would mark a domain as burned if one its categories appeared in the category blacklist.

项目信息

开发语言：Python

Star 数：247

技术要点

该项目属于病毒分析方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕DomainCheck is designed to assist operators with monitoring changes related to their domain names. This includes negative changes in categorization, VirusTotal detections, and appearances on malware blacklists. DomainCheck currently works only with NameCheap.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。