During an internal development, we noticed that existing domain validation Python packages are not deeply
validating domains.
Most of the time these packages only check the domain validity using regex, which mostly is not enough.
That is why we at CYREBRO decided to create one that takes a deeper look into domains and provides a more reliable result.
CYREBRO's domain validator checks for:
- regex validity - deep regex, includes a list of known TLDs.
- HTTP(/s) availability.
- nslookup.
- whois.
- dkim records.
- spf records.
To install the package, simply type:
pip install cyrebro-domain-validator
Firstly, clone the repository and extract the files.
Export the files and navigate to the directory using the terminal/command line window.
Lastly, once in an activated venv, enter the following command in the terminal/command line window:
python .\setup.py install
python3 ./setup.py install
- dnspython by rthalley.
- tld by barseghyanartur.
The dependencies will be installed automatically once installing the package.
- domain_name: str -> mandatory.
- dkim_selector: str -> optional.
- raw_data: bool -> optional.
CYREBRO's Domain Validator allows you to receive the scan results in both boolean expression and dictionary formats.
from cyrebro_domain_validator import DomainValidator, validate_domain
The basic usage will provide you with a simple True or False answer, it allows for easy check within a condition.
The function will return True if the answer is positive for one of the validity checks mentioned above.
Example:
if validate_domain(domain_name="github.com"):
do_work()
If a True or False answer does not match your needs, a dictionary is automatically generated upon run.
The dictionary allows one to view the result of each validation separately, for more advanced usage in the code.
To access the dictionary, simply provide True as the raw_data flag, a dictionary object will be returned.
Example:
domain_validation_details = validate_domain(domain_name="github.com", raw_data=True)
print(domain_validation_details, type(domain_validation_details))
Output:
{
"regex": True,
"http": True,
"https": True,
"nslookup": True,
"whois": True,
"dkim": True,
"spf": True
}<class 'dict'>
The dictionary is available even if the domain is not valid.
In order to retrieve the DKIM record of a domain, a specific query is used with a domain-specific selector.
Due to the nature of this package, we are unable to know in advance the selectors that are used by each domain.
We gathered some common DKIM selectors and the package tries querying with all of them.
However, if you know the DKIM selector in advance (by extracting it from an email for example), the package accepts an arbitrary DKIM selector:
domain_validator = DomainValidator("github.com", dkim_selector="some_selector")
If a specific selector is passed, it will be firstly queried by the package.
If for some reason, a result is unavailable, a fallback was implemented to try all common selectors.
Contributing is more than welcome and even encouraged by us.
For any suggestions an email can be sent to: innovation@cyrebro.io.
Pull requests are an option as well 😊 🤗.