A domain possession verification library for everyone written in Python featuring immaculate interface coupled with smashing performace. If you need to validate the ownership of a domains, start doing some Verificatio.
All strategies takes 3 arguments: the domain to verify, a static DNS safe prefix like "yourservice-domain-verification" and a randomly generated code. Domains can be verified by either adding a DNS record (CNAME or a TXT record) or by adding content to the existing website (a meta tag or uploading an empty file with the specified name).
More specifically,
-
DNS TXT record: checks for the
{prefix}={code}string present in one of theTXTrecords on the domain name. -
DNS CNAME record: checks for the existence of
CNAMErecord composed on the static{prefix}-{code}on the domain pointing to domain (usually yours) which the host is {prefix} (i.e.: {prefix}.yourdomain.com). NOTE: you may want to make sure that {prefix}.yourdomain.com resolves to something as some zone editors may check that. -
Meta Tag: Checks for the presence of a
<meta name="{prefix}" content="{code}">tag in the<head>part of the domain's home page using either HTTP or HTTPS protocol. -
File: Checks for the presence of a file named
{code}.htmlat the root of the domain's website using either HTTP or HTTPS protocol.
To install verificatio, simply:
pi@K47CH22 ~ % git clone https://github.com/vedilink/verificatio.git
pi@K47CH22 ~ % python setup.py installpi@K47CH22 ~ % pip install tox
pi@K47CH22 ~ % toxVerificatio will check the domain with the selected strategy and return True in case of a successful verification.
import verificatio
# user has access to alter the DNS records of the domain
verificatio.generate('example.com', 'CNAME')
# ask the user to add the CNAME record
verified = verificatio.verify('example.com', 'CNAME') # returns a bool
if verified:
print("This domain is verified")
# user has access to the content hosted on the domain
verificatio.generate('example.com', 'META')
# ask the user to add the meta tag
verified = verificatio.verify('example.com', 'META') # returns a bool
if verified:
print("This domain is verified")The library by default uses SQLite to store and match generated verification payloads, which can be easily swapped with any database backend by passing the database connection url to DATABASE_URL environment variable.
All source code is licensed under the MIT License.