zone.py

   1 # Copyright (c) 2014, Ralf Jung <post@ralfj.de>
   2 # All rights reserved.
   3 #
   4 # Redistribution and use in source and binary forms, with or without
   5 # modification, are permitted provided that the following conditions are met:
   6 #
   7 # 1. Redistributions of source code must retain the above copyright notice, this
   8 #    list of conditions and the following disclaimer.
   9 # 2. Redistributions in binary form must reproduce the above copyright notice,
  10 #    this list of conditions and the following disclaimer in the documentation
  11 #    and/or other materials provided with the distribution.
  12 #
  13 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
  14 # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  15 # WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  16 # DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
  17 # ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  18 # (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  19 # LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  20 # ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  21 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  22 # SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  23
  24 import re, datetime
  25 #from typing import *
  26
  27
  28 second = 1
  29 minute = 60*second
  30 hour = 60*minute
  31 day = 24*hour
  32 week = 7*day
  33
  34 REGEX_label = r'[a-zA-Z90-9]([a-zA-Z90-9-]{0,61}[a-zA-Z90-9])?' # max. 63 characters; must not start or end with hyphen
  35 REGEX_ipv4  = r'^\d{1,3}(\.\d{1,3}){3}$'
  36 REGEX_ipv6  = r'^[a-fA-F0-9]{1,4}(:[a-fA-F0-9]{1,4}){7}$'
  37
  38 def check_label(label: str) -> str:
  39     label = str(label)
  40     pattern = r'^{0}$'.format(REGEX_label)
  41     if re.match(pattern, label):
  42         return label
  43     raise Exception(label+" is not a valid label")
  44
  45 def check_hostname(name: str) -> str:
  46     name = str(name)
  47     # check hostname for validity
  48     pattern = r'^{0}(\.{0})*\.?$'.format(REGEX_label)
  49     if re.match(pattern, name):
  50         return name
  51     raise Exception(name+" is not a valid hostname")
  52
  53 def check_hex(data: str) -> str:
  54     data = str(data)
  55     if re.match('^[a-fA-F0-9]+$', data):
  56         return data
  57     raise Exception(data+" is not valid hex data")
  58
  59 def check_ipv4(address: str) -> str:
  60     address = str(address)
  61     if re.match(REGEX_ipv4, address):
  62         return address
  63     raise Exception(address+" is not a valid IPv4 address")
  64
  65 def check_ipv6(address: str) -> str:
  66     address = str(address)
  67     if re.match(REGEX_ipv6, address):
  68         return address
  69     raise Exception(address+" is not a valid IPv6 address")
  70
  71 def time(time: int) -> str:
  72     if time == 0:
  73         return "0"
  74     elif time % week == 0:
  75         return str(time//week)+"w"
  76     elif time % day == 0:
  77         return str(time//day)+"d"
  78     elif time % hour == 0:
  79         return str(time//hour)+"h"
  80     elif time % minute == 0:
  81         return str(time//minute)+"m"
  82     else:
  83         return str(time)
  84
  85 def column_widths(datas: 'Sequence', widths: 'Sequence[int]'):
  86     assert len(datas) == len(widths)+1, "There must be as one more data points as widths"
  87     result = ""
  88     width_sum = 0
  89     for data, width in zip(datas, widths): # will *not* cover the last point
  90         result += str(data)+" " # add data point, and a minimal space
  91         width_sum += width
  92         if len(result) < width_sum: # add padding
  93             result += (width_sum - len(result))*" "
  94     # last data point
  95     return result+str(datas[-1])
  96
  97
  98 ## Enums
  99 class Protocol:
 100     TCP = 'tcp'
 101     UDP = 'udp'
 102
 103 class Algorithm:
 104     RSA_SHA256 = 8
 105
 106 class Digest:
 107     SHA1 = 1
 108     SHA256 = 2
 109
 110
 111 ## Record types
 112 class A:
 113     def __init__(self, address: str) -> None:
 114         self._address = check_ipv4(address)
 115
 116     def generate_rr(self, owner: str, zone: 'Zone') -> 'Any':
 117         return zone.RR(owner, 'A', self._address)
 118
 119
 120 class AAAA:
 121     def __init__(self, address: str) -> None:
 122         self._address = check_ipv6(address)
 123
 124     def generate_rr(self, owner: str, zone: 'Zone') -> 'Any':
 125         return zone.RR(owner, 'AAAA', self._address)
 126
 127
 128 class MX:
 129     def __init__(self, name: str, prio: int = 10) -> None:
 130         self._priority = int(prio)
 131         self._name = check_hostname(name)
 132
 133     def generate_rr(self, owner: str, zone: 'Zone') -> 'Any':
 134         return zone.RR(owner, 'MX', '{0} {1}'.format(self._priority, zone.abs_hostname(self._name)))
 135
 136
 137 class TXT:
 138     def __init__(self, name: str, text: str) -> None:
 139         # test for bad characters
 140         for c in ('\n', '\r', '\t'):
 141             if c in text:
 142                 raise Exception("TXT record {0} contains invalid character")
 143         # escape text
 144         for c in ('\\', '\"'):
 145             text = text.replace(c, '\\'+c)
 146         self._text = text
 147
 148     def generate_rr(self, owner:str, zone: 'Zone') -> 'Any':
 149         return zone.RR(owner, 'TXT', '"{0}"'.format(self._text))
 150
 151
 152 class SRV:
 153     def __init__(self, protocol: str, service: str, name: str, port: int, prio: int, weight: int) -> None:
 154         self._service = check_label(service)
 155         self._protocol = check_label(protocol)
 156         self._priority = int(prio)
 157         self._weight = int(weight)
 158         self._port = int(port)
 159         self._name = check_hostname(name)
 160
 161     def generate_rr(self, owner: str, zone: 'Zone') -> 'Any':
 162         return zone.RR('_{0}._{1}.{2}'.format(self._service, self._protocol, owner), 'SRV',
 163                        '{0} {1} {2} {3}'.format(self._priority, self._weight, self._port, zone.abs_hostname(self._name)))
 164
 165
 166 class TLSA:
 167     class Usage:
 168         CA = 0 # certificate must pass the usual CA check, with the CA specified by the TLSA record
 169         EndEntity_PlusCAs = 1 # the certificate must match the TLSA record *and* pass the usual CA check
 170         TrustAnchor = 2 # the certificate must pass a check with the TLSA record giving the (only) trust anchor
 171         EndEntity = 3 # the certificate must match the TLSA record
 172
 173     class Selector:
 174         Full = 0
 175         SubjectPublicKeyInfo = 1
 176
 177     class MatchingType:
 178         Exact = 0
 179         SHA256 = 1
 180         SHA512 = 2
 181
 182     def __init__(self, protocol: str, port: int, usage: int, selector: int, matching_type: int, data: str) -> None:
 183         self._port = int(port)
 184         self._protocol = str(protocol)
 185         self._usage = int(usage)
 186         self._selector = int(selector)
 187         self._matching_type = int(matching_type)
 188         self._data = check_hex(data)
 189
 190     def generate_rr(self, owner: str, zone: 'Zone') -> 'Any':
 191         return zone.RR('_{0}._{1}.{2}'.format(self._port, self._protocol, owner), 'TLSA', '{0} {1} {2} {3}'.format(self._usage, self._selector, self._matching_type, self._data))
 192
 193
 194 class CNAME:
 195     def __init__(self, name: str) -> None:
 196         self._name = check_hostname(name)
 197
 198     def generate_rr(self, owner: str, zone: 'Zone') -> 'Any':
 199         return zone.RR(owner, 'CNAME', zone.abs_hostname(self._name))
 200
 201
 202 class NS:
 203     def __init__(self, name: str) -> None:
 204         self._name = check_hostname(name)
 205
 206     def generate_rr(self, owner: str, zone: 'Zone') -> 'Any':
 207         return zone.RR(owner, 'NS', zone.abs_hostname(self._name))
 208
 209
 210 class DS:
 211     def __init__(self, tag: int, alg: int, digest: int, key: str) -> None:
 212         self._tag = int(tag)
 213         self._key = check_hex(key)
 214         self._alg = int(alg)
 215         self._digest = int(digest)
 216
 217     def generate_rr(self, owner: str, zone: 'Zone') -> 'Any':
 218         return zone.RR(owner, 'DS', '{0} {1} {2} {3}'.format(self._tag, self._alg, self._digest, self._key))
 219
 220 ## Higher-level classes
 221 class Name:
 222     def __init__(self, *records: 'List[Any]') -> None:
 223         self._records = records
 224
 225     def generate_rrs(self, owner: str, zone: 'Zone') -> 'Iterator':
 226         for record in self._records:
 227             # this could still be a list
 228             if isinstance(record, list):
 229                 for subrecord in record:
 230                     yield subrecord.generate_rr(owner, zone)
 231             else:
 232                 yield record.generate_rr(owner, zone)
 233
 234
 235 def CName(name: str) -> Name:
 236     return Name(CNAME(name))
 237
 238
 239 def Delegation(name: str) -> Name:
 240     return Name(NS(name))
 241
 242
 243 def SecureDelegation(name: str, tag: int, alg: int, digest: int, key: str) -> Name:
 244     return Name(NS(name), DS(tag, alg, digest, key))
 245
 246
 247 class Zone:
 248     def __init__(self, name: str, serialfile: str, mail: str, NS: 'List[str]', TTLs: 'Dict[str, int]',
 249                  secondary_refresh: int, secondary_retry: int, secondary_expire: int,
 250                  domains: 'Dict[str, Any]') -> None:
 251         if not name.endswith('.'): raise Exception("Expected an absolute hostname")
 252         self._name = check_hostname(name)
 253         self._serialfile = serialfile
 254
 255         if not mail.endswith('.'): raise Exception("Mail must be absolute, end with a dot")
 256         atpos = mail.find('@')
 257         if atpos < 0 or atpos > mail.find('.'): raise Exception("Mail must contain an @ before the first dot")
 258         self._mail = check_hostname(mail.replace('@', '.', 1))
 259         self._NS = list(map(check_hostname, NS))
 260         if '' not in TTLs: raise Exception("Must give a default TTL with empty key")
 261         self._TTLs = TTLs
 262
 263         self._refresh = secondary_refresh
 264         self._retry = secondary_retry
 265         self._expire = secondary_expire
 266
 267         self._domains = domains
 268
 269     def getTTL(self, recordType: str) -> str:
 270         return self._TTLs.get(recordType, self._TTLs[''])
 271
 272     def RR(self, owner: str, recordType: str, data: str) -> str:
 273         '''generate given RR, in textual representation'''
 274         assert re.match(r'^[A-Z]+$', recordType), "got invalid record type"
 275         return column_widths((self.abs_hostname(owner), time(self.getTTL(recordType)), recordType, data), (32, 8, 8))
 276
 277     def abs_hostname(self, name):
 278         if name == '':
 279             raise Exception("Empty domain name is not valid")
 280         if name == '.' or name == '@':
 281             return self._name
 282         if name.endswith('.'):
 283             return name
 284         return name+"."+self._name
 285
 286     def inc_serial(self) -> int:
 287         # get serial
 288         cur_serial = 0
 289         try:
 290             with open(self._serialfile) as f:
 291                 cur_serial = int(f.read())
 292         except (OSError, IOError): # FileNotFoundError has been added in Python 3.3
 293             pass
 294         # increment serial
 295         cur_serial += 1
 296         # save serial
 297         with open(self._serialfile, 'w') as f:
 298             f.write(str(cur_serial))
 299         # be done
 300         return cur_serial
 301
 302     def generate_rrs(self) -> 'Iterator':
 303         # SOA record
 304         serial = self.inc_serial()
 305         yield self.RR(self._name, 'SOA',
 306                       ('{NS} {mail} {serial} {refresh} {retry} {expire} {NX_TTL}'+
 307                       ' ; primns mail serial refresh retry expire NX_TTL').format(
 308                           NS=self.abs_hostname(self._NS[0]), mail=self._mail, serial=serial,
 309                           refresh=time(self._refresh), retry=time(self._retry), expire=time(self._expire),
 310                           NX_TTL=time(self.getTTL('NX')))
 311                       )
 312         # NS records
 313         for name in self._NS:
 314             yield NS(name).generate_rr(self._name, self)
 315         # all the rest
 316         for name in sorted(self._domains.keys(), key=lambda s: list(reversed(s.split('.')))):
 317             for rr in self._domains[name].generate_rrs(name, self):
 318                 yield rr
 319
 320     def write(self) -> None:
 321         print(";; {0} zone file, generated by zonemaker <https://www.ralfj.de/projects/zonemaker> on {1}".format(self._name, datetime.datetime.now()))
 322         for rr in self.generate_rrs():
 323             print(rr)