python/samba/provision/sambadns.py

   1 # Unix SMB/CIFS implementation.
   2 # backend code for provisioning DNS for a Samba4 server
   3 #
   4 # Copyright (C) Kai Blin <kai@samba.org> 2011
   5 # Copyright (C) Amitay Isaacs <amitay@gmail.com> 2011
   6 #
   7 # This program is free software; you can redistribute it and/or modify
   8 # it under the terms of the GNU General Public License as published by
   9 # the Free Software Foundation; either version 3 of the License, or
  10 # (at your option) any later version.
  11 #
  12 # This program is distributed in the hope that it will be useful,
  13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 # GNU General Public License for more details.
  16 #
  17 # You should have received a copy of the GNU General Public License
  18 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19 #
  20
  21 """DNS-related provisioning"""
  22
  23 import os
  24 import uuid
  25 import shutil
  26 import time
  27 import ldb
  28 from base64 import b64encode
  29 import samba
  30 from samba.tdb_util import tdb_copy
  31 from samba.ndr import ndr_pack, ndr_unpack
  32 from samba import setup_file
  33 from samba.dcerpc import dnsp, misc, security
  34 from samba.dsdb import (
  35     DS_DOMAIN_FUNCTION_2000,
  36     DS_DOMAIN_FUNCTION_2003,
  37     DS_DOMAIN_FUNCTION_2008_R2
  38     )
  39 from samba.descriptor import (
  40     get_domain_descriptor,
  41     get_domain_delete_protected1_descriptor,
  42     get_domain_delete_protected2_descriptor,
  43     get_dns_partition_descriptor,
  44     get_dns_forest_microsoft_dns_descriptor,
  45     get_dns_domain_microsoft_dns_descriptor
  46     )
  47 from samba.provision.common import (
  48     setup_path,
  49     setup_add_ldif,
  50     setup_modify_ldif,
  51     setup_ldb
  52     )
  53
  54
  55 def get_domainguid(samdb, domaindn):
  56     res = samdb.search(base=domaindn, scope=ldb.SCOPE_BASE, attrs=["objectGUID"])
  57     domainguid =  str(ndr_unpack(misc.GUID, res[0]["objectGUID"][0]))
  58     return domainguid
  59
  60
  61 def get_dnsadmins_sid(samdb, domaindn):
  62     res = samdb.search(base="CN=DnsAdmins,CN=Users,%s" % domaindn, scope=ldb.SCOPE_BASE,
  63                        attrs=["objectSid"])
  64     dnsadmins_sid = ndr_unpack(security.dom_sid, res[0]["objectSid"][0])
  65     return dnsadmins_sid
  66
  67
  68 class ARecord(dnsp.DnssrvRpcRecord):
  69
  70     def __init__(self, ip_addr, serial=1, ttl=900, rank=dnsp.DNS_RANK_ZONE):
  71         super(ARecord, self).__init__()
  72         self.wType = dnsp.DNS_TYPE_A
  73         self.rank = rank
  74         self.dwSerial = serial
  75         self.dwTtlSeconds = ttl
  76         self.data = ip_addr
  77
  78
  79 class AAAARecord(dnsp.DnssrvRpcRecord):
  80
  81     def __init__(self, ip6_addr, serial=1, ttl=900, rank=dnsp.DNS_RANK_ZONE):
  82         super(AAAARecord, self).__init__()
  83         self.wType = dnsp.DNS_TYPE_AAAA
  84         self.rank = rank
  85         self.dwSerial = serial
  86         self.dwTtlSeconds = ttl
  87         self.data = ip6_addr
  88
  89
  90 class CNameRecord(dnsp.DnssrvRpcRecord):
  91
  92     def __init__(self, cname, serial=1, ttl=900, rank=dnsp.DNS_RANK_ZONE):
  93         super(CNameRecord, self).__init__()
  94         self.wType = dnsp.DNS_TYPE_CNAME
  95         self.rank = rank
  96         self.dwSerial = serial
  97         self.dwTtlSeconds = ttl
  98         self.data = cname
  99
 100
 101 class NSRecord(dnsp.DnssrvRpcRecord):
 102
 103     def __init__(self, dns_server, serial=1, ttl=900, rank=dnsp.DNS_RANK_ZONE):
 104         super(NSRecord, self).__init__()
 105         self.wType = dnsp.DNS_TYPE_NS
 106         self.rank = rank
 107         self.dwSerial = serial
 108         self.dwTtlSeconds = ttl
 109         self.data = dns_server
 110
 111
 112 class SOARecord(dnsp.DnssrvRpcRecord):
 113
 114     def __init__(self, mname, rname, serial=1, refresh=900, retry=600,
 115                  expire=86400, minimum=3600, ttl=3600, rank=dnsp.DNS_RANK_ZONE):
 116         super(SOARecord, self).__init__()
 117         self.wType = dnsp.DNS_TYPE_SOA
 118         self.rank = rank
 119         self.dwSerial = serial
 120         self.dwTtlSeconds = ttl
 121         soa = dnsp.soa()
 122         soa.serial = serial
 123         soa.refresh = refresh
 124         soa.retry = retry
 125         soa.expire = expire
 126         soa.mname = mname
 127         soa.rname = rname
 128         self.data = soa
 129
 130
 131 class SRVRecord(dnsp.DnssrvRpcRecord):
 132
 133     def __init__(self, target, port, priority=0, weight=100, serial=1, ttl=900,
 134                 rank=dnsp.DNS_RANK_ZONE):
 135         super(SRVRecord, self).__init__()
 136         self.wType = dnsp.DNS_TYPE_SRV
 137         self.rank = rank
 138         self.dwSerial = serial
 139         self.dwTtlSeconds = ttl
 140         srv = dnsp.srv()
 141         srv.nameTarget = target
 142         srv.wPort = port
 143         srv.wPriority = priority
 144         srv.wWeight = weight
 145         self.data = srv
 146
 147
 148 class TXTRecord(dnsp.DnssrvRpcRecord):
 149
 150     def __init__(self, slist, serial=1, ttl=900, rank=dnsp.DNS_RANK_ZONE):
 151         super(TXTRecord, self).__init__()
 152         self.wType = dnsp.DNS_TYPE_TXT
 153         self.rank = rank
 154         self.dwSerial = serial
 155         self.dwTtlSeconds = ttl
 156         stringlist = dnsp.string_list()
 157         stringlist.count = len(slist)
 158         stringlist.str = slist
 159         self.data = stringlist
 160
 161
 162 class TypeProperty(dnsp.DnsProperty):
 163
 164     def __init__(self, zone_type=dnsp.DNS_ZONE_TYPE_PRIMARY):
 165         super(TypeProperty, self).__init__()
 166         self.wDataLength = 1
 167         self.version = 1
 168         self.id = dnsp.DSPROPERTY_ZONE_TYPE
 169         self.data = zone_type
 170
 171
 172 class AllowUpdateProperty(dnsp.DnsProperty):
 173
 174     def __init__(self, allow_update=dnsp.DNS_ZONE_UPDATE_SECURE):
 175         super(AllowUpdateProperty, self).__init__()
 176         self.wDataLength = 1
 177         self.version = 1
 178         self.id = dnsp.DSPROPERTY_ZONE_ALLOW_UPDATE
 179         self.data = allow_update
 180
 181
 182 class SecureTimeProperty(dnsp.DnsProperty):
 183
 184     def __init__(self, secure_time=0):
 185         super(SecureTimeProperty, self).__init__()
 186         self.wDataLength = 1
 187         self.version = 1
 188         self.id = dnsp.DSPROPERTY_ZONE_SECURE_TIME
 189         self.data = secure_time
 190
 191
 192 class NorefreshIntervalProperty(dnsp.DnsProperty):
 193
 194     def __init__(self, norefresh_interval=0):
 195         super(NorefreshIntervalProperty, self).__init__()
 196         self.wDataLength = 1
 197         self.version = 1
 198         self.id = dnsp.DSPROPERTY_ZONE_NOREFRESH_INTERVAL
 199         self.data = norefresh_interval
 200
 201
 202 class RefreshIntervalProperty(dnsp.DnsProperty):
 203
 204     def __init__(self, refresh_interval=0):
 205         super(RefreshIntervalProperty, self).__init__()
 206         self.wDataLength = 1
 207         self.version = 1
 208         self.id = dnsp.DSPROPERTY_ZONE_REFRESH_INTERVAL
 209         self.data = refresh_interval
 210
 211
 212 class AgingStateProperty(dnsp.DnsProperty):
 213
 214     def __init__(self, aging_enabled=0):
 215         super(AgingStateProperty, self).__init__()
 216         self.wDataLength = 1
 217         self.version = 1
 218         self.id = dnsp.DSPROPERTY_ZONE_AGING_STATE
 219         self.data = aging_enabled
 220
 221
 222 class AgingEnabledTimeProperty(dnsp.DnsProperty):
 223
 224     def __init__(self, next_cycle_hours=0):
 225         super(AgingEnabledTimeProperty, self).__init__()
 226         self.wDataLength = 1
 227         self.version = 1;
 228         self.id = dnsp.DSPROPERTY_ZONE_AGING_ENABLED_TIME
 229         self.data = next_cycle_hours
 230
 231
 232 def setup_dns_partitions(samdb, domainsid, domaindn, forestdn, configdn,
 233         serverdn):
 234     domainzone_dn = "DC=DomainDnsZones,%s" % domaindn
 235     forestzone_dn = "DC=ForestDnsZones,%s" % forestdn
 236     descriptor = get_dns_partition_descriptor(domainsid)
 237     setup_add_ldif(samdb, setup_path("provision_dnszones_partitions.ldif"), {
 238         "DOMAINZONE_DN": domainzone_dn,
 239         "FORESTZONE_DN": forestzone_dn,
 240         "SECDESC"      : b64encode(descriptor)
 241         })
 242
 243     domainzone_guid = get_domainguid(samdb, domainzone_dn)
 244     forestzone_guid = get_domainguid(samdb, forestzone_dn)
 245
 246     domainzone_guid = str(uuid.uuid4())
 247     forestzone_guid = str(uuid.uuid4())
 248
 249     domainzone_dns = ldb.Dn(samdb, domainzone_dn).canonical_ex_str().strip()
 250     forestzone_dns = ldb.Dn(samdb, forestzone_dn).canonical_ex_str().strip()
 251
 252     protected1_desc = get_domain_delete_protected1_descriptor(domainsid)
 253     protected2_desc = get_domain_delete_protected2_descriptor(domainsid)
 254     setup_add_ldif(samdb, setup_path("provision_dnszones_add.ldif"), {
 255         "DOMAINZONE_DN": domainzone_dn,
 256         "FORESTZONE_DN": forestzone_dn,
 257         "DOMAINZONE_GUID": domainzone_guid,
 258         "FORESTZONE_GUID": forestzone_guid,
 259         "DOMAINZONE_DNS": domainzone_dns,
 260         "FORESTZONE_DNS": forestzone_dns,
 261         "CONFIGDN": configdn,
 262         "SERVERDN": serverdn,
 263         "LOSTANDFOUND_DESCRIPTOR": b64encode(protected2_desc),
 264         "INFRASTRUCTURE_DESCRIPTOR": b64encode(protected1_desc),
 265         })
 266
 267     setup_modify_ldif(samdb, setup_path("provision_dnszones_modify.ldif"), {
 268         "CONFIGDN": configdn,
 269         "SERVERDN": serverdn,
 270         "DOMAINZONE_DN": domainzone_dn,
 271         "FORESTZONE_DN": forestzone_dn,
 272     })
 273
 274
 275 def add_dns_accounts(samdb, domaindn):
 276     setup_add_ldif(samdb, setup_path("provision_dns_accounts_add.ldif"), {
 277         "DOMAINDN": domaindn,
 278         })
 279
 280
 281 def add_dns_container(samdb, domaindn, prefix, domain_sid, dnsadmins_sid, forest=False):
 282     name_map = {'DnsAdmins': str(dnsadmins_sid)}
 283     if forest is True:
 284         sd_val = get_dns_forest_microsoft_dns_descriptor(domain_sid,
 285                                                          name_map=name_map)
 286     else:
 287         sd_val = get_dns_domain_microsoft_dns_descriptor(domain_sid,
 288                                                          name_map=name_map)
 289     # CN=MicrosoftDNS,<PREFIX>,<DOMAINDN>
 290     msg = ldb.Message(ldb.Dn(samdb, "CN=MicrosoftDNS,%s,%s" % (prefix, domaindn)))
 291     msg["objectClass"] = ["top", "container"]
 292     msg["nTSecurityDescriptor"] = ldb.MessageElement(sd_val, ldb.FLAG_MOD_ADD,
 293         "nTSecurityDescriptor")
 294     samdb.add(msg)
 295
 296
 297 def add_rootservers(samdb, domaindn, prefix):
 298     rootservers = {}
 299     rootservers["a.root-servers.net"] = "198.41.0.4"
 300     rootservers["b.root-servers.net"] = "192.228.79.201"
 301     rootservers["c.root-servers.net"] = "192.33.4.12"
 302     rootservers["d.root-servers.net"] = "128.8.10.90"
 303     rootservers["e.root-servers.net"] = "192.203.230.10"
 304     rootservers["f.root-servers.net"] = "192.5.5.241"
 305     rootservers["g.root-servers.net"] = "192.112.36.4"
 306     rootservers["h.root-servers.net"] = "128.63.2.53"
 307     rootservers["i.root-servers.net"] = "192.36.148.17"
 308     rootservers["j.root-servers.net"] = "192.58.128.30"
 309     rootservers["k.root-servers.net"] = "193.0.14.129"
 310     rootservers["l.root-servers.net"] = "199.7.83.42"
 311     rootservers["m.root-servers.net"] = "202.12.27.33"
 312
 313     rootservers_v6 = {}
 314     rootservers_v6["a.root-servers.net"] = "2001:503:ba3e::2:30"
 315     rootservers_v6["f.root-servers.net"] = "2001:500:2f::f"
 316     rootservers_v6["h.root-servers.net"] = "2001:500:1::803f:235"
 317     rootservers_v6["j.root-servers.net"] = "2001:503:c27::2:30"
 318     rootservers_v6["k.root-servers.net"] = "2001:7fd::1"
 319     rootservers_v6["m.root-servers.net"] = "2001:dc3::35"
 320
 321     container_dn = "DC=RootDNSServers,CN=MicrosoftDNS,%s,%s" % (prefix, domaindn)
 322
 323     # Add DC=RootDNSServers,CN=MicrosoftDNS,<PREFIX>,<DOMAINDN>
 324     msg = ldb.Message(ldb.Dn(samdb, container_dn))
 325     props = []
 326     props.append(ndr_pack(TypeProperty(zone_type=dnsp.DNS_ZONE_TYPE_CACHE)))
 327     props.append(ndr_pack(AllowUpdateProperty(allow_update=dnsp.DNS_ZONE_UPDATE_OFF)))
 328     props.append(ndr_pack(SecureTimeProperty()))
 329     props.append(ndr_pack(NorefreshIntervalProperty()))
 330     props.append(ndr_pack(RefreshIntervalProperty()))
 331     props.append(ndr_pack(AgingStateProperty()))
 332     props.append(ndr_pack(AgingEnabledTimeProperty()))
 333     msg["objectClass"] = ["top", "dnsZone"]
 334     msg["cn"] = ldb.MessageElement("Zone", ldb.FLAG_MOD_ADD, "cn")
 335     msg["dNSProperty"] = ldb.MessageElement(props, ldb.FLAG_MOD_ADD, "dNSProperty")
 336     samdb.add(msg)
 337
 338     # Add DC=@,DC=RootDNSServers,CN=MicrosoftDNS,<PREFIX>,<DOMAINDN>
 339     record = []
 340     for rserver in rootservers:
 341         record.append(ndr_pack(NSRecord(rserver, serial=0, ttl=0, rank=dnsp.DNS_RANK_ROOT_HINT)))
 342
 343     msg = ldb.Message(ldb.Dn(samdb, "DC=@,%s" % container_dn))
 344     msg["objectClass"] = ["top", "dnsNode"]
 345     msg["dnsRecord"] = ldb.MessageElement(record, ldb.FLAG_MOD_ADD, "dnsRecord")
 346     samdb.add(msg)
 347
 348     # Add DC=<rootserver>,DC=RootDNSServers,CN=MicrosoftDNS,<PREFIX>,<DOMAINDN>
 349     for rserver in rootservers:
 350         record = [ndr_pack(ARecord(rootservers[rserver], serial=0, ttl=0, rank=dnsp.DNS_RANK_ROOT_HINT))]
 351         # Add AAAA record as well (How does W2K* add IPv6 records?)
 352         #if rserver in rootservers_v6:
 353         #    record.append(ndr_pack(AAAARecord(rootservers_v6[rserver], serial=0, ttl=0)))
 354         msg = ldb.Message(ldb.Dn(samdb, "DC=%s,%s" % (rserver, container_dn)))
 355         msg["objectClass"] = ["top", "dnsNode"]
 356         msg["dnsRecord"] = ldb.MessageElement(record, ldb.FLAG_MOD_ADD, "dnsRecord")
 357         samdb.add(msg)
 358
 359 def add_at_record(samdb, container_dn, prefix, hostname, dnsdomain, hostip, hostip6):
 360
 361     fqdn_hostname = "%s.%s" % (hostname, dnsdomain)
 362
 363     at_records = []
 364
 365     # SOA record
 366     at_soa_record = SOARecord(fqdn_hostname, "hostmaster.%s" % dnsdomain)
 367     at_records.append(ndr_pack(at_soa_record))
 368
 369     # NS record
 370     at_ns_record = NSRecord(fqdn_hostname)
 371     at_records.append(ndr_pack(at_ns_record))
 372
 373     if hostip is not None:
 374         # A record
 375         at_a_record = ARecord(hostip)
 376         at_records.append(ndr_pack(at_a_record))
 377
 378     if hostip6 is not None:
 379         # AAAA record
 380         at_aaaa_record = AAAARecord(hostip6)
 381         at_records.append(ndr_pack(at_aaaa_record))
 382
 383     msg = ldb.Message(ldb.Dn(samdb, "DC=@,%s" % container_dn))
 384     msg["objectClass"] = ["top", "dnsNode"]
 385     msg["dnsRecord"] = ldb.MessageElement(at_records, ldb.FLAG_MOD_ADD, "dnsRecord")
 386     samdb.add(msg)
 387
 388
 389 def add_srv_record(samdb, container_dn, prefix, host, port):
 390     srv_record = SRVRecord(host, port)
 391     msg = ldb.Message(ldb.Dn(samdb, "%s,%s" % (prefix, container_dn)))
 392     msg["objectClass"] = ["top", "dnsNode"]
 393     msg["dnsRecord"] = ldb.MessageElement(ndr_pack(srv_record), ldb.FLAG_MOD_ADD, "dnsRecord")
 394     samdb.add(msg)
 395
 396
 397 def add_ns_record(samdb, container_dn, prefix, host):
 398     ns_record = NSRecord(host)
 399     msg = ldb.Message(ldb.Dn(samdb, "%s,%s" % (prefix, container_dn)))
 400     msg["objectClass"] = ["top", "dnsNode"]
 401     msg["dnsRecord"] = ldb.MessageElement(ndr_pack(ns_record), ldb.FLAG_MOD_ADD, "dnsRecord")
 402     samdb.add(msg)
 403
 404
 405 def add_ns_glue_record(samdb, container_dn, prefix, host):
 406     ns_record = NSRecord(host, rank=dnsp.DNS_RANK_NS_GLUE)
 407     msg = ldb.Message(ldb.Dn(samdb, "%s,%s" % (prefix, container_dn)))
 408     msg["objectClass"] = ["top", "dnsNode"]
 409     msg["dnsRecord"] = ldb.MessageElement(ndr_pack(ns_record), ldb.FLAG_MOD_ADD, "dnsRecord")
 410     samdb.add(msg)
 411
 412
 413 def add_cname_record(samdb, container_dn, prefix, host):
 414     cname_record = CNameRecord(host)
 415     msg = ldb.Message(ldb.Dn(samdb, "%s,%s" % (prefix, container_dn)))
 416     msg["objectClass"] = ["top", "dnsNode"]
 417     msg["dnsRecord"] = ldb.MessageElement(ndr_pack(cname_record), ldb.FLAG_MOD_ADD, "dnsRecord")
 418     samdb.add(msg)
 419
 420
 421 def add_host_record(samdb, container_dn, prefix, hostip, hostip6):
 422     host_records = []
 423     if hostip:
 424         a_record = ARecord(hostip)
 425         host_records.append(ndr_pack(a_record))
 426     if hostip6:
 427         aaaa_record = AAAARecord(hostip6)
 428         host_records.append(ndr_pack(aaaa_record))
 429     if host_records:
 430         msg = ldb.Message(ldb.Dn(samdb, "%s,%s" % (prefix, container_dn)))
 431         msg["objectClass"] = ["top", "dnsNode"]
 432         msg["dnsRecord"] = ldb.MessageElement(host_records, ldb.FLAG_MOD_ADD, "dnsRecord")
 433         samdb.add(msg)
 434
 435
 436 def add_domain_record(samdb, domaindn, prefix, dnsdomain, domainsid, dnsadmins_sid):
 437     # DC=<DNSDOMAIN>,CN=MicrosoftDNS,<PREFIX>,<DOMAINDN>
 438     sddl = "O:SYG:BAD:AI" \
 439     "(A;;RPWPCRCCDCLCLORCWOWDSDDTSW;;;DA)" \
 440     "(A;;CC;;;AU)" \
 441     "(A;;RPLCLORC;;;WD)" \
 442     "(A;;RPWPCRCCDCLCLORCWOWDSDDTSW;;;SY)" \
 443     "(A;CI;RPWPCRCCDCLCRCWOWDSDDTSW;;;ED)" \
 444     "(A;CIID;RPWPCRCCDCLCRCWOWDSDDTSW;;;%s)" \
 445     "(A;CIID;RPWPCRCCDCLCRCWOWDSDDTSW;;;ED)" \
 446     "(OA;CIID;RPWPCR;91e647de-d96f-4b70-9557-d63ff4f3ccd8;;PS)" \
 447     "(A;CIID;RPWPCRCCDCLCLORCWOWDSDDTSW;;;EA)" \
 448     "(A;CIID;LC;;;RU)" \
 449     "(A;CIID;RPWPCRCCLCLORCWOWDSDSW;;;BA)" \
 450     "S:AI" % dnsadmins_sid
 451     sec = security.descriptor.from_sddl(sddl, domainsid)
 452     props = []
 453     props.append(ndr_pack(TypeProperty()))
 454     props.append(ndr_pack(AllowUpdateProperty()))
 455     props.append(ndr_pack(SecureTimeProperty()))
 456     props.append(ndr_pack(NorefreshIntervalProperty(norefresh_interval=168)))
 457     props.append(ndr_pack(RefreshIntervalProperty(refresh_interval=168)))
 458     props.append(ndr_pack(AgingStateProperty()))
 459     props.append(ndr_pack(AgingEnabledTimeProperty()))
 460     msg = ldb.Message(ldb.Dn(samdb, "DC=%s,CN=MicrosoftDNS,%s,%s" % (dnsdomain, prefix, domaindn)))
 461     msg["objectClass"] = ["top", "dnsZone"]
 462     msg["ntSecurityDescriptor"] = ldb.MessageElement(ndr_pack(sec), ldb.FLAG_MOD_ADD,
 463         "nTSecurityDescriptor")
 464     msg["dNSProperty"] = ldb.MessageElement(props, ldb.FLAG_MOD_ADD, "dNSProperty")
 465     samdb.add(msg)
 466
 467
 468 def add_msdcs_record(samdb, forestdn, prefix, dnsforest):
 469     # DC=_msdcs.<DNSFOREST>,CN=MicrosoftDNS,<PREFIX>,<FORESTDN>
 470     msg = ldb.Message(ldb.Dn(samdb, "DC=_msdcs.%s,CN=MicrosoftDNS,%s,%s" %
 471                                     (dnsforest, prefix, forestdn)))
 472     msg["objectClass"] = ["top", "dnsZone"]
 473     samdb.add(msg)
 474
 475
 476 def add_dc_domain_records(samdb, domaindn, prefix, site, dnsdomain, hostname,
 477         hostip, hostip6):
 478
 479     fqdn_hostname = "%s.%s" % (hostname, dnsdomain)
 480
 481     # Set up domain container - DC=<DNSDOMAIN>,CN=MicrosoftDNS,<PREFIX>,<DOMAINDN>
 482     domain_container_dn = ldb.Dn(samdb, "DC=%s,CN=MicrosoftDNS,%s,%s" %
 483                                     (dnsdomain, prefix, domaindn))
 484
 485     # DC=@ record
 486     add_at_record(samdb, domain_container_dn, "DC=@", hostname, dnsdomain,
 487             hostip, hostip6)
 488
 489     # DC=<HOSTNAME> record
 490     add_host_record(samdb, domain_container_dn, "DC=%s" % hostname, hostip,
 491             hostip6)
 492
 493     # DC=_kerberos._tcp record
 494     add_srv_record(samdb, domain_container_dn, "DC=_kerberos._tcp",
 495             fqdn_hostname, 88)
 496
 497     # DC=_kerberos._tcp.<SITENAME>._sites record
 498     add_srv_record(samdb, domain_container_dn, "DC=_kerberos._tcp.%s._sites" %
 499             site, fqdn_hostname, 88)
 500
 501     # DC=_kerberos._udp record
 502     add_srv_record(samdb, domain_container_dn, "DC=_kerberos._udp",
 503             fqdn_hostname, 88)
 504
 505     # DC=_kpasswd._tcp record
 506     add_srv_record(samdb, domain_container_dn, "DC=_kpasswd._tcp",
 507             fqdn_hostname, 464)
 508
 509     # DC=_kpasswd._udp record
 510     add_srv_record(samdb, domain_container_dn, "DC=_kpasswd._udp",
 511             fqdn_hostname, 464)
 512
 513     # DC=_ldap._tcp record
 514     add_srv_record(samdb, domain_container_dn, "DC=_ldap._tcp", fqdn_hostname,
 515             389)
 516
 517     # DC=_ldap._tcp.<SITENAME>._sites record
 518     add_srv_record(samdb, domain_container_dn, "DC=_ldap._tcp.%s._sites" %
 519             site, fqdn_hostname, 389)
 520
 521     # FIXME: The number of SRV records depend on the various roles this DC has.
 522     #        _gc and _msdcs records are added if the we are the forest dc and not subdomain dc
 523     #
 524     # Assumption: current DC is GC and add all the entries
 525
 526     # DC=_gc._tcp record
 527     add_srv_record(samdb, domain_container_dn, "DC=_gc._tcp", fqdn_hostname,
 528             3268)
 529
 530     # DC=_gc._tcp.<SITENAME>,_sites record
 531     add_srv_record(samdb, domain_container_dn, "DC=_gc._tcp.%s._sites" % site,
 532             fqdn_hostname, 3268)
 533
 534     # DC=_msdcs record
 535     add_ns_glue_record(samdb, domain_container_dn, "DC=_msdcs", fqdn_hostname)
 536
 537     # FIXME: Following entries are added only if DomainDnsZones and ForestDnsZones partitions
 538     #        are created
 539     #
 540     # Assumption: Additional entries won't hurt on os_level = 2000
 541
 542     # DC=_ldap._tcp.<SITENAME>._sites.DomainDnsZones
 543     add_srv_record(samdb, domain_container_dn,
 544             "DC=_ldap._tcp.%s._sites.DomainDnsZones" % site, fqdn_hostname,
 545             389)
 546
 547     # DC=_ldap._tcp.<SITENAME>._sites.ForestDnsZones
 548     add_srv_record(samdb, domain_container_dn,
 549             "DC=_ldap._tcp.%s._sites.ForestDnsZones" % site, fqdn_hostname,
 550             389)
 551
 552     # DC=_ldap._tcp.DomainDnsZones
 553     add_srv_record(samdb, domain_container_dn, "DC=_ldap._tcp.DomainDnsZones",
 554                     fqdn_hostname, 389)
 555
 556     # DC=_ldap._tcp.ForestDnsZones
 557     add_srv_record(samdb, domain_container_dn, "DC=_ldap._tcp.ForestDnsZones",
 558                     fqdn_hostname, 389)
 559
 560     # DC=DomainDnsZones
 561     add_host_record(samdb, domain_container_dn, "DC=DomainDnsZones", hostip,
 562             hostip6)
 563
 564     # DC=ForestDnsZones
 565     add_host_record(samdb, domain_container_dn, "DC=ForestDnsZones", hostip,
 566             hostip6)
 567
 568
 569 def add_dc_msdcs_records(samdb, forestdn, prefix, site, dnsforest, hostname,
 570                             hostip, hostip6, domainguid, ntdsguid):
 571
 572     fqdn_hostname = "%s.%s" % (hostname, dnsforest)
 573
 574     # Set up forest container - DC=<DNSDOMAIN>,CN=MicrosoftDNS,<PREFIX>,<DOMAINDN>
 575     forest_container_dn = ldb.Dn(samdb, "DC=_msdcs.%s,CN=MicrosoftDNS,%s,%s" %
 576                                     (dnsforest, prefix, forestdn))
 577
 578     # DC=@ record
 579     add_at_record(samdb, forest_container_dn, "DC=@", hostname, dnsforest,
 580             None, None)
 581
 582     # DC=_kerberos._tcp.dc record
 583     add_srv_record(samdb, forest_container_dn, "DC=_kerberos._tcp.dc",
 584             fqdn_hostname, 88)
 585
 586     # DC=_kerberos._tcp.<SITENAME>._sites.dc record
 587     add_srv_record(samdb, forest_container_dn,
 588             "DC=_kerberos._tcp.%s._sites.dc" % site, fqdn_hostname, 88)
 589
 590     # DC=_ldap._tcp.dc record
 591     add_srv_record(samdb, forest_container_dn, "DC=_ldap._tcp.dc",
 592             fqdn_hostname, 389)
 593
 594     # DC=_ldap._tcp.<SITENAME>._sites.dc record
 595     add_srv_record(samdb, forest_container_dn, "DC=_ldap._tcp.%s._sites.dc" %
 596             site, fqdn_hostname, 389)
 597
 598     # DC=_ldap._tcp.<SITENAME>._sites.gc record
 599     add_srv_record(samdb, forest_container_dn, "DC=_ldap._tcp.%s._sites.gc" %
 600             site, fqdn_hostname, 3268)
 601
 602     # DC=_ldap._tcp.gc record
 603     add_srv_record(samdb, forest_container_dn, "DC=_ldap._tcp.gc",
 604             fqdn_hostname, 3268)
 605
 606     # DC=_ldap._tcp.pdc record
 607     add_srv_record(samdb, forest_container_dn, "DC=_ldap._tcp.pdc",
 608             fqdn_hostname, 389)
 609
 610     # DC=gc record
 611     add_host_record(samdb, forest_container_dn, "DC=gc", hostip, hostip6)
 612
 613     # DC=_ldap._tcp.<DOMAINGUID>.domains record
 614     add_srv_record(samdb, forest_container_dn,
 615             "DC=_ldap._tcp.%s.domains" % domainguid, fqdn_hostname, 389)
 616
 617     # DC=<NTDSGUID>
 618     add_cname_record(samdb, forest_container_dn, "DC=%s" % ntdsguid,
 619             fqdn_hostname)
 620
 621
 622 def secretsdb_setup_dns(secretsdb, names, private_dir, realm,
 623                         dnsdomain, dns_keytab_path, dnspass, key_version_number):
 624     """Add DNS specific bits to a secrets database.
 625
 626     :param secretsdb: Ldb Handle to the secrets database
 627     :param names: Names shortcut
 628     :param machinepass: Machine password
 629     """
 630     try:
 631         os.unlink(os.path.join(private_dir, dns_keytab_path))
 632     except OSError:
 633         pass
 634
 635     if key_version_number is None:
 636         key_version_number = 1
 637
 638     setup_ldb(secretsdb, setup_path("secrets_dns.ldif"), {
 639             "REALM": realm,
 640             "DNSDOMAIN": dnsdomain,
 641             "DNS_KEYTAB": dns_keytab_path,
 642             "DNSPASS_B64": b64encode(dnspass),
 643             "KEY_VERSION_NUMBER": str(key_version_number),
 644             "HOSTNAME": names.hostname,
 645             "DNSNAME" : '%s.%s' % (
 646                 names.netbiosname.lower(), names.dnsdomain.lower())
 647             })
 648
 649
 650 def create_dns_dir(logger, paths):
 651     """Write out a DNS zone file, from the info in the current database.
 652
 653     :param logger: Logger object
 654     :param paths: paths object
 655     """
 656     dns_dir = os.path.dirname(paths.dns)
 657
 658     try:
 659         shutil.rmtree(dns_dir, True)
 660     except OSError:
 661         pass
 662
 663     os.mkdir(dns_dir, 0770)
 664
 665     if paths.bind_gid is not None:
 666         try:
 667             os.chown(dns_dir, -1, paths.bind_gid)
 668             # chmod needed to cope with umask
 669             os.chmod(dns_dir, 0770)
 670         except OSError:
 671             if not os.environ.has_key('SAMBA_SELFTEST'):
 672                 logger.error("Failed to chown %s to bind gid %u" % (
 673                     dns_dir, paths.bind_gid))
 674
 675
 676 def create_zone_file(lp, logger, paths, targetdir, dnsdomain,
 677                      hostip, hostip6, hostname, realm, domainguid,
 678                      ntdsguid, site):
 679     """Write out a DNS zone file, from the info in the current database.
 680
 681     :param paths: paths object
 682     :param dnsdomain: DNS Domain name
 683     :param domaindn: DN of the Domain
 684     :param hostip: Local IPv4 IP
 685     :param hostip6: Local IPv6 IP
 686     :param hostname: Local hostname
 687     :param realm: Realm name
 688     :param domainguid: GUID of the domain.
 689     :param ntdsguid: GUID of the hosts nTDSDSA record.
 690     """
 691     assert isinstance(domainguid, str)
 692
 693     if hostip6 is not None:
 694         hostip6_base_line = "            IN AAAA    " + hostip6
 695         hostip6_host_line = hostname + "        IN AAAA    " + hostip6
 696         gc_msdcs_ip6_line = "gc._msdcs               IN AAAA    " + hostip6
 697     else:
 698         hostip6_base_line = ""
 699         hostip6_host_line = ""
 700         gc_msdcs_ip6_line = ""
 701
 702     if hostip is not None:
 703         hostip_base_line = "            IN A    " + hostip
 704         hostip_host_line = hostname + "        IN A    " + hostip
 705         gc_msdcs_ip_line = "gc._msdcs               IN A    " + hostip
 706     else:
 707         hostip_base_line = ""
 708         hostip_host_line = ""
 709         gc_msdcs_ip_line = ""
 710
 711     # we need to freeze the zone while we update the contents
 712     if targetdir is None:
 713         rndc = ' '.join(lp.get("rndc command"))
 714         os.system(rndc + " freeze " + lp.get("realm"))
 715
 716     setup_file(setup_path("provision.zone"), paths.dns, {
 717             "HOSTNAME": hostname,
 718             "DNSDOMAIN": dnsdomain,
 719             "REALM": realm,
 720             "HOSTIP_BASE_LINE": hostip_base_line,
 721             "HOSTIP_HOST_LINE": hostip_host_line,
 722             "DOMAINGUID": domainguid,
 723             "DATESTRING": time.strftime("%Y%m%d%H"),
 724             "DEFAULTSITE": site,
 725             "NTDSGUID": ntdsguid,
 726             "HOSTIP6_BASE_LINE": hostip6_base_line,
 727             "HOSTIP6_HOST_LINE": hostip6_host_line,
 728             "GC_MSDCS_IP_LINE": gc_msdcs_ip_line,
 729             "GC_MSDCS_IP6_LINE": gc_msdcs_ip6_line,
 730         })
 731
 732     if paths.bind_gid is not None:
 733         try:
 734             os.chown(paths.dns, -1, paths.bind_gid)
 735             # chmod needed to cope with umask
 736             os.chmod(paths.dns, 0664)
 737         except OSError:
 738             if not os.environ.has_key('SAMBA_SELFTEST'):
 739                 logger.error("Failed to chown %s to bind gid %u" % (
 740                     paths.dns, paths.bind_gid))
 741
 742     if targetdir is None:
 743         os.system(rndc + " unfreeze " + lp.get("realm"))
 744
 745
 746 def create_samdb_copy(samdb, logger, paths, names, domainsid, domainguid):
 747     """Create a copy of samdb and give write permissions to named for dns partitions
 748     """
 749     private_dir = paths.private_dir
 750     samldb_dir = os.path.join(private_dir, "sam.ldb.d")
 751     dns_dir = os.path.dirname(paths.dns)
 752     dns_samldb_dir = os.path.join(dns_dir, "sam.ldb.d")
 753
 754     # Find the partitions and corresponding filenames
 755     partfile = {}
 756     res = samdb.search(base="@PARTITION", scope=ldb.SCOPE_BASE, attrs=["partition"])
 757     for tmp in res[0]["partition"]:
 758         (nc, fname) = tmp.split(':')
 759         partfile[nc.upper()] = fname
 760
 761     # Create empty domain partition
 762     domaindn = names.domaindn.upper()
 763     domainpart_file = os.path.join(dns_dir, partfile[domaindn])
 764     try:
 765         os.mkdir(dns_samldb_dir)
 766         file(domainpart_file, 'w').close()
 767
 768         # Fill the basedn and @OPTION records in domain partition
 769         dom_ldb = samba.Ldb(domainpart_file)
 770         domainguid_line = "objectGUID: %s\n-" % domainguid
 771         descr = b64encode(get_domain_descriptor(domainsid))
 772         setup_add_ldif(dom_ldb, setup_path("provision_basedn.ldif"), {
 773             "DOMAINDN" : names.domaindn,
 774             "DOMAINGUID" : domainguid_line,
 775             "DOMAINSID" : str(domainsid),
 776             "DESCRIPTOR" : descr})
 777         setup_add_ldif(dom_ldb,
 778             setup_path("provision_basedn_options.ldif"), None)
 779     except:
 780         logger.error(
 781             "Failed to setup database for BIND, AD based DNS cannot be used")
 782         raise
 783     del partfile[domaindn]
 784
 785     # Link dns partitions and metadata
 786     domainzonedn = "DC=DOMAINDNSZONES,%s" % names.domaindn.upper()
 787     forestzonedn = "DC=FORESTDNSZONES,%s" % names.rootdn.upper()
 788     domainzone_file = partfile[domainzonedn]
 789     forestzone_file = partfile[forestzonedn]
 790     metadata_file = "metadata.tdb"
 791     try:
 792         os.link(os.path.join(samldb_dir, metadata_file),
 793             os.path.join(dns_samldb_dir, metadata_file))
 794         os.link(os.path.join(private_dir, domainzone_file),
 795             os.path.join(dns_dir, domainzone_file))
 796         os.link(os.path.join(private_dir, forestzone_file),
 797             os.path.join(dns_dir, forestzone_file))
 798     except OSError:
 799         logger.error(
 800             "Failed to setup database for BIND, AD based DNS cannot be used")
 801         raise
 802     del partfile[domainzonedn]
 803     del partfile[forestzonedn]
 804
 805     # Copy root, config, schema partitions (and any other if any)
 806     # Since samdb is open in the current process, copy them in a child process
 807     try:
 808         tdb_copy(os.path.join(private_dir, "sam.ldb"),
 809                  os.path.join(dns_dir, "sam.ldb"))
 810         for nc in partfile:
 811             pfile = partfile[nc]
 812             tdb_copy(os.path.join(private_dir, pfile),
 813                      os.path.join(dns_dir, pfile))
 814     except:
 815         logger.error(
 816             "Failed to setup database for BIND, AD based DNS cannot be used")
 817         raise
 818
 819     # Give bind read/write permissions dns partitions
 820     if paths.bind_gid is not None:
 821         try:
 822             os.chown(samldb_dir, -1, paths.bind_gid)
 823             os.chmod(samldb_dir, 0750)
 824
 825             for dirname, dirs, files in os.walk(dns_dir):
 826                 for d in dirs:
 827                     dpath = os.path.join(dirname, d)
 828                     os.chown(dpath, -1, paths.bind_gid)
 829                     os.chmod(dpath, 0770)
 830                 for f in files:
 831                     if f.endswith('.ldb') or f.endswith('.tdb'):
 832                         fpath = os.path.join(dirname, f)
 833                         os.chown(fpath, -1, paths.bind_gid)
 834                         os.chmod(fpath, 0660)
 835         except OSError:
 836             if not os.environ.has_key('SAMBA_SELFTEST'):
 837                 logger.error(
 838                     "Failed to set permissions to sam.ldb* files, fix manually")
 839     else:
 840         if not os.environ.has_key('SAMBA_SELFTEST'):
 841             logger.warning("""Unable to find group id for BIND,
 842                 set permissions to sam.ldb* files manually""")
 843
 844
 845 def create_dns_update_list(lp, logger, paths):
 846     """Write out a dns_update_list file"""
 847     # note that we use no variable substitution on this file
 848     # the substitution is done at runtime by samba_dnsupdate, samba_spnupdate
 849     setup_file(setup_path("dns_update_list"), paths.dns_update_list, None)
 850     setup_file(setup_path("spn_update_list"), paths.spn_update_list, None)
 851
 852
 853 def create_named_conf(paths, realm, dnsdomain, dns_backend):
 854     """Write out a file containing zone statements suitable for inclusion in a
 855     named.conf file (including GSS-TSIG configuration).
 856
 857     :param paths: all paths
 858     :param realm: Realm name
 859     :param dnsdomain: DNS Domain name
 860     :param dns_backend: DNS backend type
 861     :param keytab_name: File name of DNS keytab file
 862     """
 863
 864     if dns_backend == "BIND9_FLATFILE":
 865         setup_file(setup_path("named.conf"), paths.namedconf, {
 866                     "DNSDOMAIN": dnsdomain,
 867                     "REALM": realm,
 868                     "ZONE_FILE": paths.dns,
 869                     "REALM_WC": "*." + ".".join(realm.split(".")[1:]),
 870                     "NAMED_CONF": paths.namedconf,
 871                     "NAMED_CONF_UPDATE": paths.namedconf_update
 872                     })
 873
 874         setup_file(setup_path("named.conf.update"), paths.namedconf_update)
 875
 876     elif dns_backend == "BIND9_DLZ":
 877         setup_file(setup_path("named.conf.dlz"), paths.namedconf, {
 878                     "NAMED_CONF": paths.namedconf,
 879                     "MODULESDIR" : samba.param.modules_dir(),
 880                     })
 881
 882
 883 def create_named_txt(path, realm, dnsdomain, dnsname, private_dir,
 884     keytab_name):
 885     """Write out a file containing zone statements suitable for inclusion in a
 886     named.conf file (including GSS-TSIG configuration).
 887
 888     :param path: Path of the new named.conf file.
 889     :param realm: Realm name
 890     :param dnsdomain: DNS Domain name
 891     :param private_dir: Path to private directory
 892     :param keytab_name: File name of DNS keytab file
 893     """
 894     setup_file(setup_path("named.txt"), path, {
 895             "DNSDOMAIN": dnsdomain,
 896             "DNSNAME" : dnsname,
 897             "REALM": realm,
 898             "DNS_KEYTAB": keytab_name,
 899             "DNS_KEYTAB_ABS": os.path.join(private_dir, keytab_name),
 900             "PRIVATE_DIR": private_dir
 901         })
 902
 903
 904 def is_valid_dns_backend(dns_backend):
 905     return dns_backend in ("BIND9_FLATFILE", "BIND9_DLZ", "SAMBA_INTERNAL", "NONE")
 906
 907
 908 def is_valid_os_level(os_level):
 909     return DS_DOMAIN_FUNCTION_2000 <= os_level <= DS_DOMAIN_FUNCTION_2008_R2
 910
 911
 912 def create_dns_legacy(samdb, domainsid, forestdn, dnsadmins_sid):
 913     # Set up MicrosoftDNS container
 914     add_dns_container(samdb, forestdn, "CN=System", domainsid, dnsadmins_sid)
 915     # Add root servers
 916     add_rootservers(samdb, forestdn, "CN=System")
 917
 918
 919 def fill_dns_data_legacy(samdb, domainsid, forestdn, dnsdomain, site, hostname,
 920                          hostip, hostip6, dnsadmins_sid):
 921     # Add domain record
 922     add_domain_record(samdb, forestdn, "CN=System", dnsdomain, domainsid,
 923                       dnsadmins_sid)
 924
 925     # Add DNS records for a DC in domain
 926     add_dc_domain_records(samdb, forestdn, "CN=System", site, dnsdomain,
 927                           hostname, hostip, hostip6)
 928
 929
 930 def create_dns_partitions(samdb, domainsid, names, domaindn, forestdn,
 931                           dnsadmins_sid):
 932     # Set up additional partitions (DomainDnsZones, ForstDnsZones)
 933     setup_dns_partitions(samdb, domainsid, domaindn, forestdn,
 934                         names.configdn, names.serverdn)
 935
 936     # Set up MicrosoftDNS containers
 937     add_dns_container(samdb, domaindn, "DC=DomainDnsZones", domainsid,
 938                       dnsadmins_sid)
 939     add_dns_container(samdb, forestdn, "DC=ForestDnsZones", domainsid,
 940                       dnsadmins_sid, forest=True)
 941
 942
 943 def fill_dns_data_partitions(samdb, domainsid, site, domaindn, forestdn,
 944                             dnsdomain, dnsforest, hostname, hostip, hostip6,
 945                             domainguid, ntdsguid, dnsadmins_sid, autofill=True):
 946     """Fill data in various AD partitions
 947
 948     :param samdb: LDB object connected to sam.ldb file
 949     :param domainsid: Domain SID (as dom_sid object)
 950     :param site: Site name to create hostnames in
 951     :param domaindn: DN of the domain
 952     :param forestdn: DN of the forest
 953     :param dnsdomain: DNS name of the domain
 954     :param dnsforest: DNS name of the forest
 955     :param hostname: Host name of this DC
 956     :param hostip: IPv4 addresses
 957     :param hostip6: IPv6 addresses
 958     :param domainguid: Domain GUID
 959     :param ntdsguid: NTDS GUID
 960     :param dnsadmins_sid: SID for DnsAdmins group
 961     :param autofill: Create DNS records (using fixed template)
 962     """
 963
 964     ##### Set up DC=DomainDnsZones,<DOMAINDN>
 965     # Add rootserver records
 966     add_rootservers(samdb, domaindn, "DC=DomainDnsZones")
 967
 968     # Add domain record
 969     add_domain_record(samdb, domaindn, "DC=DomainDnsZones", dnsdomain,
 970                       domainsid, dnsadmins_sid)
 971
 972     # Add DNS records for a DC in domain
 973     if autofill:
 974         add_dc_domain_records(samdb, domaindn, "DC=DomainDnsZones", site,
 975                               dnsdomain, hostname, hostip, hostip6)
 976
 977     ##### Set up DC=ForestDnsZones,<DOMAINDN>
 978     # Add _msdcs record
 979     add_msdcs_record(samdb, forestdn, "DC=ForestDnsZones", dnsforest)
 980
 981     # Add DNS records for a DC in forest
 982     if autofill:
 983         add_dc_msdcs_records(samdb, forestdn, "DC=ForestDnsZones", site,
 984                              dnsforest, hostname, hostip, hostip6,
 985                              domainguid, ntdsguid)
 986
 987
 988 def setup_ad_dns(samdb, secretsdb, domainsid, names, paths, lp, logger,
 989         dns_backend, os_level, site, dnspass=None, hostip=None, hostip6=None,
 990         targetdir=None):
 991     """Provision DNS information (assuming GC role)
 992
 993     :param samdb: LDB object connected to sam.ldb file
 994     :param secretsdb: LDB object connected to secrets.ldb file
 995     :param domainsid: Domain SID (as dom_sid object)
 996     :param names: Names shortcut
 997     :param paths: Paths shortcut
 998     :param lp: Loadparm object
 999     :param logger: Logger object
1000     :param dns_backend: Type of DNS backend
1001     :param os_level: Functional level (treated as os level)
1002     :param site: Site to create hostnames in
1003     :param dnspass: Password for bind's DNS account
1004     :param hostip: IPv4 address
1005     :param hostip6: IPv6 address
1006     :param targetdir: Target directory for creating DNS-related files for BIND9
1007     """
1008
1009     if not is_valid_dns_backend(dns_backend):
1010         raise Exception("Invalid dns backend: %r" % dns_backend)
1011
1012     if not is_valid_os_level(os_level):
1013         raise Exception("Invalid os level: %r" % os_level)
1014
1015     if dns_backend == "NONE":
1016         logger.info("No DNS backend set, not configuring DNS")
1017         return
1018
1019     # Add dns accounts (DnsAdmins, DnsUpdateProxy) in domain
1020     logger.info("Adding DNS accounts")
1021     add_dns_accounts(samdb, names.domaindn)
1022
1023     # If dns_backend is BIND9_FLATFILE
1024     #   Populate only CN=MicrosoftDNS,CN=System,<DOMAINDN>
1025     #
1026     # If dns_backend is SAMBA_INTERNAL or BIND9_DLZ
1027     #   Populate DNS partitions
1028
1029     # If os_level < 2003 (DS_DOMAIN_FUNCTION_2000)
1030     #   All dns records are in CN=MicrosoftDNS,CN=System,<DOMAINDN>
1031     #
1032     # If os_level >= 2003 (DS_DOMAIN_FUNCTION_2003, DS_DOMAIN_FUNCTION_2008,
1033     #                        DS_DOMAIN_FUNCTION_2008_R2)
1034     #   Root server records are in CN=MicrosoftDNS,CN=System,<DOMAINDN>
1035     #   Domain records are in CN=MicrosoftDNS,CN=System,<DOMAINDN>
1036     #   Domain records are in CN=MicrosoftDNS,DC=DomainDnsZones,<DOMAINDN>
1037     #   Forest records are in CN=MicrosoftDNS,DC=ForestDnsZones,<FORESTDN>
1038     domaindn = names.domaindn
1039     forestdn = samdb.get_root_basedn().get_linearized()
1040
1041     dnsdomain = names.dnsdomain.lower()
1042     dnsforest = dnsdomain
1043
1044     hostname = names.netbiosname.lower()
1045
1046     dnsadmins_sid = get_dnsadmins_sid(samdb, domaindn)
1047     domainguid = get_domainguid(samdb, domaindn)
1048
1049     # Create CN=System
1050     logger.info("Creating CN=MicrosoftDNS,CN=System,%s" % domaindn)
1051     create_dns_legacy(samdb, domainsid, domaindn, dnsadmins_sid)
1052
1053     if os_level == DS_DOMAIN_FUNCTION_2000:
1054         # Populating legacy dns
1055         logger.info("Populating CN=MicrosoftDNS,CN=System,%s" % domaindn)
1056         fill_dns_data_legacy(samdb, domainsid, domaindn, dnsdomain, site,
1057                              hostname, hostip, hostip6, dnsadmins_sid)
1058
1059     elif dns_backend in ("SAMBA_INTERNAL", "BIND9_DLZ") and \
1060             os_level >= DS_DOMAIN_FUNCTION_2003:
1061
1062         # Create DNS partitions
1063         logger.info("Creating DomainDnsZones and ForestDnsZones partitions")
1064         create_dns_partitions(samdb, domainsid, names, domaindn, forestdn,
1065                               dnsadmins_sid)
1066
1067         # Populating dns partitions
1068         logger.info("Populating DomainDnsZones and ForestDnsZones partitions")
1069         fill_dns_data_partitions(samdb, domainsid, site, domaindn, forestdn,
1070                                 dnsdomain, dnsforest, hostname, hostip, hostip6,
1071                                 domainguid, names.ntdsguid, dnsadmins_sid)
1072
1073     if dns_backend.startswith("BIND9_"):
1074         setup_bind9_dns(samdb, secretsdb, domainsid, names, paths, lp, logger,
1075             dns_backend, os_level, site=site, dnspass=dnspass, hostip=hostip,
1076             hostip6=hostip6, targetdir=targetdir)
1077
1078
1079 def setup_bind9_dns(samdb, secretsdb, domainsid, names, paths, lp, logger,
1080         dns_backend, os_level, site=None, dnspass=None, hostip=None,
1081         hostip6=None, targetdir=None, key_version_number=None):
1082     """Provision DNS information (assuming BIND9 backend in DC role)
1083
1084     :param samdb: LDB object connected to sam.ldb file
1085     :param secretsdb: LDB object connected to secrets.ldb file
1086     :param domainsid: Domain SID (as dom_sid object)
1087     :param names: Names shortcut
1088     :param paths: Paths shortcut
1089     :param lp: Loadparm object
1090     :param logger: Logger object
1091     :param dns_backend: Type of DNS backend
1092     :param os_level: Functional level (treated as os level)
1093     :param site: Site to create hostnames in
1094     :param dnspass: Password for bind's DNS account
1095     :param hostip: IPv4 address
1096     :param hostip6: IPv6 address
1097     :param targetdir: Target directory for creating DNS-related files for BIND9
1098     """
1099
1100     if (not is_valid_dns_backend(dns_backend) or
1101         not dns_backend.startswith("BIND9_")):
1102         raise Exception("Invalid dns backend: %r" % dns_backend)
1103
1104     if not is_valid_os_level(os_level):
1105         raise Exception("Invalid os level: %r" % os_level)
1106
1107     domaindn = names.domaindn
1108
1109     domainguid = get_domainguid(samdb, domaindn)
1110
1111     secretsdb_setup_dns(secretsdb, names,
1112                         paths.private_dir, realm=names.realm,
1113                         dnsdomain=names.dnsdomain,
1114                         dns_keytab_path=paths.dns_keytab, dnspass=dnspass,
1115                         key_version_number=key_version_number)
1116
1117     create_dns_dir(logger, paths)
1118
1119     if dns_backend == "BIND9_FLATFILE":
1120         create_zone_file(lp, logger, paths, targetdir, site=site,
1121                          dnsdomain=names.dnsdomain, hostip=hostip,
1122                          hostip6=hostip6, hostname=names.hostname,
1123                          realm=names.realm, domainguid=domainguid,
1124                          ntdsguid=names.ntdsguid)
1125
1126     if dns_backend == "BIND9_DLZ" and os_level >= DS_DOMAIN_FUNCTION_2003:
1127         create_samdb_copy(samdb, logger, paths, names, domainsid, domainguid)
1128
1129     create_named_conf(paths, realm=names.realm,
1130                       dnsdomain=names.dnsdomain, dns_backend=dns_backend)
1131
1132     create_named_txt(paths.namedtxt,
1133                      realm=names.realm, dnsdomain=names.dnsdomain,
1134                      dnsname = "%s.%s" % (names.hostname, names.dnsdomain),
1135                      private_dir=paths.private_dir,
1136                      keytab_name=paths.dns_keytab)
1137     logger.info("See %s for an example configuration include file for BIND",
1138                 paths.namedconf)
1139     logger.info("and %s for further documentation required for secure DNS "
1140                 "updates", paths.namedtxt)