source4/scripting/python/samba/join.py

   1 #!/usr/bin/env python
   2 #
   3 # python join code
   4 # Copyright Andrew Tridgell 2010
   5 # Copyright Andrew Bartlett 2010
   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 import samba.getopt as options
  22 from samba.auth import system_session
  23 from samba.samdb import SamDB
  24 from samba import gensec, Ldb
  25 import ldb, samba, sys
  26 from samba.ndr import ndr_pack, ndr_unpack, ndr_print
  27 from samba.dcerpc import security
  28 from samba.dcerpc import drsuapi, misc, netlogon, nbt
  29 from samba.credentials import Credentials, DONT_USE_KERBEROS
  30 from samba.provision import secretsdb_self_join, provision, FILL_DRS, find_setup_dir
  31 from samba.net import Net
  32 import logging
  33 from samba.drs_utils import drs_Replicate
  34 from samba.dsdb import DS_DOMAIN_FUNCTION_2008_R2
  35
  36 # this makes debugging easier
  37 samba.talloc_enable_null_tracking()
  38
  39 class join_ctx:
  40     '''hold join context variables'''
  41     pass
  42
  43 def join_rodc(server=None, creds=None, lp=None, site=None, netbios_name=None,
  44               targetdir=None, domain=None):
  45     """join as a RODC"""
  46
  47     def del_noerror(samdb, dn):
  48         try:
  49             samdb.delete(dn)
  50             print "Deleted %s" % dn
  51         except:
  52             pass
  53
  54     def cleanup_old_join(ctx):
  55         '''remove any DNs from a previous join'''
  56         try:
  57             # find the krbtgt link
  58             res = ctx.samdb.search(base=ctx.acct_dn, scope=ldb.SCOPE_BASE, attrs=["msDS-krbTgtLink"])
  59             del_noerror(ctx.samdb, ctx.acct_dn)
  60             del_noerror(ctx.samdb, ctx.connection_dn)
  61             del_noerror(ctx.samdb, ctx.krbtgt_dn)
  62             del_noerror(ctx.samdb, ctx.ntds_dn)
  63             del_noerror(ctx.samdb, ctx.server_dn)
  64             del_noerror(ctx.samdb, ctx.topology_dn)
  65             ctx.new_krbtgt_dn = res[0]["msDS-Krbtgtlink"][0]
  66             del_noerror(ctx.samdb, ctx.new_krbtgt_dn)
  67         except:
  68             pass
  69
  70     def find_dc(ctx, domain):
  71         '''find a writeable DC for the given domain'''
  72         ctx.cldap_ret = ctx.net.finddc(domain, nbt.NBT_SERVER_LDAP | nbt.NBT_SERVER_DS | nbt.NBT_SERVER_WRITABLE)
  73         if ctx.cldap_ret.client_site is not None and ctx.cldap_ret.client_site != "":
  74             ctx.site = ctx.cldap_ret.client_site
  75         return ctx.cldap_ret.pdc_dns_name
  76
  77
  78     def get_dsServiceName(samdb):
  79         res = samdb.search(base="", scope=ldb.SCOPE_BASE, attrs=["dsServiceName"])
  80         return res[0]["dsServiceName"][0]
  81
  82     def get_dnsHostName(samdb):
  83         res = samdb.search(base="", scope=ldb.SCOPE_BASE, attrs=["dnsHostName"])
  84         return res[0]["dnsHostName"][0]
  85
  86     def get_domain_name(samdb):
  87         '''get netbios name of the domain from the partitions record'''
  88         partitions_dn = samdb.get_partitions_dn()
  89         res = samdb.search(base=partitions_dn, scope=ldb.SCOPE_ONELEVEL, attrs=["nETBIOSName"],
  90                            expression='ncName=%s' % samdb.get_default_basedn())
  91         return res[0]["nETBIOSName"][0]
  92
  93     def get_mysid(samdb):
  94         res = samdb.search(base="", scope=ldb.SCOPE_BASE, attrs=["tokenGroups"])
  95         binsid = res[0]["tokenGroups"][0]
  96         return samdb.schema_format_value("objectSID", binsid)
  97
  98     def join_add_objects(ctx):
  99         '''add the various objects needed for the join'''
 100         print "Adding %s" % ctx.acct_dn
 101         rec = {
 102             "dn" : ctx.acct_dn,
 103             "objectClass": "computer",
 104             "displayname": ctx.samname,
 105             "samaccountname" : ctx.samname,
 106             "useraccountcontrol" : str(samba.dsdb.UF_WORKSTATION_TRUST_ACCOUNT |
 107                                        samba.dsdb.UF_TRUSTED_TO_AUTHENTICATE_FOR_DELEGATION |
 108                                        samba.dsdb.UF_PARTIAL_SECRETS_ACCOUNT),
 109             "managedby" : ctx.admin_dn,
 110             "dnshostname" : ctx.dnshostname,
 111             "msDS-NeverRevealGroup" : ctx.never_reveal_sid,
 112             "msDS-RevealOnDemandGroup" : ctx.reveal_sid}
 113         ctx.samdb.add(rec)
 114
 115         print "Adding %s" % ctx.krbtgt_dn
 116         rec = {
 117             "dn" : ctx.krbtgt_dn,
 118             "objectclass" : "user",
 119             "useraccountcontrol" : str(samba.dsdb.UF_NORMAL_ACCOUNT |
 120                                        samba.dsdb.UF_ACCOUNTDISABLE),
 121             "showinadvancedviewonly" : "TRUE",
 122             "description" : "krbtgt for %s" % ctx.samname}
 123         ctx.samdb.add(rec, ["rodc_join:1:1"])
 124
 125         # now we need to search for the samAccountName attribute on the krbtgt DN,
 126         # as this will have been magically set to the krbtgt number
 127         res = ctx.samdb.search(base=ctx.krbtgt_dn, scope=ldb.SCOPE_BASE, attrs=["samAccountName"])
 128         ctx.krbtgt_name = res[0]["samAccountName"][0]
 129
 130         print "Got krbtgt_name=%s" % ctx.krbtgt_name
 131
 132         m = ldb.Message()
 133         m.dn = ldb.Dn(ctx.samdb, ctx.acct_dn)
 134         m["msDS-krbTgtLink"] = ldb.MessageElement(ctx.krbtgt_dn,
 135                                                   ldb.FLAG_MOD_REPLACE, "msDS-krbTgtLink")
 136         ctx.samdb.modify(m)
 137
 138         ctx.new_krbtgt_dn = "CN=%s,CN=Users,%s" % (ctx.krbtgt_name, ctx.base_dn)
 139         print "Renaming %s to %s" % (ctx.krbtgt_dn, ctx.new_krbtgt_dn)
 140         ctx.samdb.rename(ctx.krbtgt_dn, ctx.new_krbtgt_dn)
 141
 142         print "Adding %s" % ctx.server_dn
 143         rec = {
 144             "dn": ctx.server_dn,
 145             "objectclass" : "server",
 146             "systemFlags" : str(samba.dsdb.SYSTEM_FLAG_CONFIG_ALLOW_RENAME |
 147                                 samba.dsdb.SYSTEM_FLAG_CONFIG_ALLOW_LIMITED_MOVE |
 148                                 samba.dsdb.SYSTEM_FLAG_DISALLOW_MOVE_ON_DELETE),
 149             "serverReference" : ctx.acct_dn,
 150             "dnsHostName" : ctx.dnshostname}
 151         ctx.samdb.add(rec)
 152
 153         # FIXME: the partition (NC) assignment has to be made dynamic
 154         print "Adding %s" % ctx.ntds_dn
 155         rec = {
 156             "dn" : ctx.ntds_dn,
 157             "objectclass" : "nTDSDSA",
 158             "objectCategory" : "CN=NTDS-DSA-RO,%s" % ctx.schema_dn,
 159             "systemFlags" : str(samba.dsdb.SYSTEM_FLAG_DISALLOW_MOVE_ON_DELETE),
 160             "dMDLocation" : ctx.schema_dn,
 161             "options" : "37",
 162             "msDS-Behavior-Version" : str(DS_DOMAIN_FUNCTION_2008_R2),
 163             "msDS-HasDomainNCs" : ctx.base_dn,
 164             "msDS-HasFullReplicaNCs" : [ ctx.base_dn, ctx.config_dn, ctx.schema_dn ]}
 165         ctx.samdb.add(rec, ["rodc_join:1:1"])
 166
 167         # find the GUID of our NTDS DN
 168         res = ctx.samdb.search(base=ctx.ntds_dn, scope=ldb.SCOPE_BASE, attrs=["objectGUID"])
 169         ctx.ntds_guid = misc.GUID(ctx.samdb.schema_format_value("objectGUID", res[0]["objectGUID"][0]))
 170
 171         print "Adding %s" % ctx.connection_dn
 172         rec = {
 173             "dn" : ctx.connection_dn,
 174             "objectclass" : "nTDSConnection",
 175             "enabledconnection" : "TRUE",
 176             "options" : "65",
 177             "fromServer" : ctx.dc_ntds_dn}
 178         ctx.samdb.add(rec)
 179
 180         print "Adding %s" % ctx.topology_dn
 181         rec = {
 182             "dn" : ctx.topology_dn,
 183             "objectclass" : "msDFSR-Member",
 184             "msDFSR-ComputerReference" : ctx.acct_dn,
 185             "serverReference" : ctx.ntds_dn}
 186         ctx.samdb.add(rec)
 187
 188         print "Adding HOST SPNs to %s" % ctx.acct_dn
 189         m = ldb.Message()
 190         m.dn = ldb.Dn(ctx.samdb, ctx.acct_dn)
 191         SPNs = [ "HOST/%s" % ctx.myname,
 192                  "HOST/%s" % ctx.dnshostname ]
 193         m["servicePrincipalName"] = ldb.MessageElement(SPNs,
 194                                                        ldb.FLAG_MOD_ADD,
 195                                                        "servicePrincipalName")
 196         ctx.samdb.modify(m)
 197
 198         print "Adding RestrictedKrbHost SPNs to %s" % ctx.acct_dn
 199         m = ldb.Message()
 200         m.dn = ldb.Dn(ctx.samdb, ctx.acct_dn)
 201         SPNs = [ "RestrictedKrbHost/%s" % ctx.myname,
 202                  "RestrictedKrbHost/%s" % ctx.dnshostname ]
 203         m["servicePrincipalName"] = ldb.MessageElement(SPNs,
 204                                                        ldb.FLAG_MOD_ADD,
 205                                                        "servicePrincipalName")
 206         ctx.samdb.modify(m)
 207
 208         print "Setting account password for %s" % ctx.samname
 209         ctx.samdb.setpassword("(&(objectClass=user)(sAMAccountName=%s))" % ctx.samname,
 210                               ctx.acct_pass,
 211                               force_change_at_next_login=False,
 212                               username=ctx.samname)
 213         res = ctx.samdb.search(base=ctx.acct_dn, scope=ldb.SCOPE_BASE, attrs=["msDS-keyVersionNumber"])
 214         ctx.key_version_number = res[0]["msDS-keyVersionNumber"]
 215
 216
 217     def join_provision(ctx):
 218         '''provision the local SAM'''
 219
 220         print "Calling bare provision"
 221
 222         setup_dir = find_setup_dir()
 223         logger = logging.getLogger("provision")
 224         logger.addHandler(logging.StreamHandler(sys.stdout))
 225         smbconf = lp.configfile
 226
 227         presult = provision(setup_dir, logger, system_session(), None,
 228                             smbconf=smbconf, targetdir=targetdir, samdb_fill=FILL_DRS,
 229                             realm=ctx.realm, rootdn=ctx.root_dn, domaindn=ctx.base_dn,
 230                             schemadn=ctx.schema_dn,
 231                             configdn=ctx.config_dn,
 232                             serverdn=ctx.server_dn, domain=ctx.domain_name,
 233                             hostname=ctx.myname, hostip="127.0.0.1", domainsid=ctx.domsid,
 234                             machinepass=ctx.acct_pass, serverrole="domain controller",
 235                             sitename=ctx.site)
 236         print "Provision OK for domain DN %s" % presult.domaindn
 237         ctx.local_samdb = presult.samdb
 238         ctx.lp          = presult.lp
 239         ctx.paths       = presult.paths
 240
 241
 242     def join_replicate(ctx):
 243         '''replicate the SAM'''
 244
 245         print "Starting replication"
 246         ctx.local_samdb.transaction_start()
 247
 248         source_dsa_invocation_id = misc.GUID(ctx.samdb.get_invocation_id())
 249
 250         acct_creds = Credentials()
 251         acct_creds.guess(ctx.lp)
 252         acct_creds.set_kerberos_state(DONT_USE_KERBEROS)
 253         acct_creds.set_username(ctx.samname)
 254         acct_creds.set_password(ctx.acct_pass)
 255
 256         repl = drs_Replicate("ncacn_ip_tcp:%s[seal]" % ctx.server, ctx.lp, acct_creds, ctx.local_samdb)
 257
 258         repl.replicate(ctx.schema_dn, source_dsa_invocation_id, ctx.ntds_guid, schema=True)
 259         repl.replicate(ctx.config_dn, source_dsa_invocation_id, ctx.ntds_guid)
 260         repl.replicate(ctx.base_dn, source_dsa_invocation_id, ctx.ntds_guid)
 261         repl.replicate(ctx.acct_dn, source_dsa_invocation_id, ctx.ntds_guid, exop=drsuapi.DRSUAPI_EXOP_REPL_SECRET)
 262         repl.replicate(ctx.new_krbtgt_dn, source_dsa_invocation_id, ctx.ntds_guid, exop=drsuapi.DRSUAPI_EXOP_REPL_SECRET)
 263
 264         print "Committing SAM database"
 265         ctx.local_samdb.transaction_commit()
 266
 267
 268     def join_finalise(ctx):
 269         '''finalise the join, mark us synchronised and setup secrets db'''
 270
 271         print "Setting isSynchronized"
 272         m = ldb.Message()
 273         m.dn = ldb.Dn(ctx.samdb, '@ROOTDSE')
 274         m["isSynchronized"] = ldb.MessageElement("TRUE", ldb.FLAG_MOD_REPLACE, "isSynchronized")
 275         ctx.samdb.modify(m)
 276
 277         secrets_ldb = Ldb(ctx.paths.secrets, session_info=system_session(), lp=ctx.lp)
 278
 279         print "Setting up secrets database"
 280         secretsdb_self_join(secrets_ldb, domain=ctx.domain_name,
 281                             realm=ctx.realm,
 282                             dnsdomain=ctx.dnsdomain,
 283                             netbiosname=ctx.myname,
 284                             domainsid=security.dom_sid(ctx.domsid),
 285                             machinepass=ctx.acct_pass,
 286                             secure_channel_type=misc.SEC_CHAN_RODC,
 287                             key_version_number=ctx.key_version_number)
 288
 289
 290
 291     # main join code
 292     ctx = join_ctx()
 293     ctx.creds = creds
 294     ctx.lp = lp
 295     ctx.site = site
 296     ctx.netbios_name = netbios_name
 297     ctx.targetdir = targetdir
 298
 299     ctx.creds.set_gensec_features(creds.get_gensec_features() | gensec.FEATURE_SEAL)
 300     ctx.net = Net(creds=ctx.creds, lp=ctx.lp)
 301
 302     if server is not None:
 303         ctx.server = server
 304     else:
 305         ctx.server = find_dc(ctx, domain)
 306
 307     ctx.samdb = SamDB(url="ldap://%s" % ctx.server,
 308                       session_info=system_session(),
 309                       credentials=ctx.creds, lp=ctx.lp)
 310
 311     ctx.myname = netbios_name
 312     ctx.samname = "%s$" % ctx.myname
 313     ctx.base_dn = str(ctx.samdb.get_default_basedn())
 314     ctx.root_dn = str(ctx.samdb.get_root_basedn())
 315     ctx.schema_dn = str(ctx.samdb.get_schema_basedn())
 316     ctx.config_dn = str(ctx.samdb.get_config_basedn())
 317     ctx.domsid = ctx.samdb.get_domain_sid()
 318     ctx.domain_name = get_domain_name(ctx.samdb)
 319
 320     lp.set("realm", ctx.domain_name)
 321
 322     ctx.dc_ntds_dn = get_dsServiceName(ctx.samdb)
 323     ctx.dc_dnsHostName = get_dnsHostName(ctx.samdb)
 324     ctx.acct_pass = samba.generate_random_password(12, 32)
 325     ctx.mysid = get_mysid(ctx.samdb)
 326
 327     # work out the DNs of all the objects we will be adding
 328     ctx.admin_dn = "<SID=%s>" % ctx.mysid
 329     ctx.krbtgt_dn = "CN=krbtgt_%s,CN=Users,%s" % (ctx.myname, ctx.base_dn)
 330     ctx.server_dn = "CN=%s,CN=Servers,CN=%s,CN=Sites,%s" % (ctx.myname, ctx.site, ctx.config_dn)
 331     ctx.ntds_dn = "CN=NTDS Settings,%s" % ctx.server_dn
 332     ctx.connection_dn = "CN=RODC Connection (FRS),%s" % ctx.ntds_dn
 333     ctx.topology_dn = "CN=%s,CN=Topology,CN=Domain System Volume,CN=DFSR-GlobalSettings,CN=System,%s" % (ctx.myname, ctx.base_dn)
 334
 335     # setup some defaults for accounts that should be replicated to this RODC
 336     ctx.never_reveal_sid = [ "<SID=%s-%s>" % (ctx.domsid, security.DOMAIN_RID_RODC_DENY),
 337                              "<SID=%s>" % security.SID_BUILTIN_ADMINISTRATORS,
 338                              "<SID=%s>" % security.SID_BUILTIN_SERVER_OPERATORS,
 339                              "<SID=%s>" % security.SID_BUILTIN_BACKUP_OPERATORS,
 340                              "<SID=%s>" % security.SID_BUILTIN_ACCOUNT_OPERATORS ]
 341     ctx.reveal_sid = "<SID=%s-%s>" % (ctx.domsid, security.DOMAIN_RID_RODC_ALLOW)
 342
 343     ctx.dnsdomain = ldb.Dn(ctx.samdb, ctx.base_dn).canonical_str().split('/')[0]
 344     ctx.realm = ctx.dnsdomain
 345     ctx.dnshostname = "%s.%s" % (ctx.myname, ctx.dnsdomain)
 346
 347     ctx.acct_dn = "CN=%s,OU=Domain Controllers,%s" % (ctx.myname, ctx.base_dn)
 348
 349     cleanup_old_join(ctx)
 350     try:
 351         join_add_objects(ctx)
 352         join_provision(ctx)
 353         join_replicate(ctx)
 354         join_finalise(ctx)
 355     except:
 356         print "Join failed - cleaning up"
 357         cleanup_old_join(ctx)
 358         raise
 359
 360     print "Joined domain %s (SID %s) as an RODC" % (ctx.domain_name, ctx.domsid)
 361