A domain validation package, written by CYREBRO's Innovation team.
Project description
CYREBRO's Domain Validator
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.
Validations
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.
Installation
Through pip
To install the package, simply type:
pip install cyrebro-domain-validator
Through GitHub
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:
Windows
python .\setup.py install
Linux
python3 ./setup.py install
Dependencies
- dnspython by rthalley.
- tld by barseghyanartur.
The dependencies will be installed automatically once installing the package.
Usage
Input Parameters
- domain_name: str -> mandatory.
- dkim_selector: str -> optional.
- raw_data: bool -> optional.
Using The Package
CYREBRO's Domain Validator allows you to receive the scan results in both boolean expression and dictionary formats.
Importing
from cyrebro_domain_validator import DomainValidator, validate_domain
Basic Usage
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()
Advanced Usage
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.
Note: the package requires internet connection to work properly.
DKIM Clarification
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.
Development
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 :blush: :hugs:.
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 cyrebro_domain_validator-0.3.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3c2f25666d961458258f015ec00302803756e56fcc80c59ae03531221dce6f8a |
|
MD5 | 9ee93e61155747197d663e09c46ee592 |
|
BLAKE2b-256 | 3f53cc60620b19f1328c65673dc98fe5dc4472fcc5c15ca30d55087e378e7818 |
Hashes for cyrebro_domain_validator-0.3.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1dad256c41ebe12542f802f140d51d242f413b7431f1f32ace7cd83b71e75c29 |
|
MD5 | 9d82e3a7f8b53aa5c1c4cbbfeaa7f55d |
|
BLAKE2b-256 | 68c5cd05b2b0a3b2b7d773f2dba574d241bac04c5e418d865f5b8b135e834a38 |