samba-tool: Change samba-tool gpo semantics (use gpo name instead of dn)
[metze/samba/wip.git] / source4 / scripting / python / samba / netcmd / gpo.py
index fac91670766a532bb0f2352be39822e1f1ac3330..fb559d619d8870634902cc7ea1e6bc4fd2813887 100644 (file)
@@ -3,6 +3,8 @@
 # implement samba_tool gpo commands
 #
 # Copyright Andrew Tridgell 2010
+# Copyright Giampaolo Lauria 2011 <lauria2@yahoo.com>
+# Copyright Amitay Isaacs 2011 <amitay@gmail.com>
 #
 # based on C implementation by Guenther Deschner and Wilco Baan Hofman
 #
@@ -37,6 +39,8 @@ from samba.ndr import ndr_unpack
 import samba.security
 import samba.auth
 from samba.auth import AUTH_SESSION_INFO_DEFAULT_GROUPS, AUTH_SESSION_INFO_AUTHENTICATED, AUTH_SESSION_INFO_SIMPLE_PRIVILEGES
+from samba.netcmd.common import netcmd_finddc
+
 
 def samdb_connect(ctx):
     '''make a ldap connection to the server'''
@@ -83,44 +87,101 @@ def parse_gplink(gplink):
     return ret
 
 
+def encode_gplink(gplist):
+    '''Encode an array of dn and options into gPLink string'''
+    ret = ''
+    for g in gplist:
+        ret += "[LDAP://%s;%d]" % (g['dn'], g['options'])
+    return ret
+
+
+def dc_url(lp, creds, url=None, dc=None):
+    '''If URL is not specified, return URL for writable DC.
+    If dc is provided, use that to construct ldap URL'''
+
+    if url is None:
+        if dc is None:
+            try:
+                dc = netcmd_finddc(lp, creds)
+            except Exception, e:
+                raise RunTimeError("Could not find a DC for domain", e)
+        url = 'ldap://' + dc
+    return url
+
+
+def get_gpo_dn(samdb, gpo):
+    '''Construct the DN for gpo'''
+
+    dn = samdb.get_default_basedn()
+    dn.add_child(ldb.Dn(samdb, "CN=Policies,DC=System"))
+    dn.add_child(ldb.Dn(samdb, "CN=%s" % gpo))
+    return dn
+
+
+def get_gpo_info(samdb, gpo=None, displayname=None, dn=None):
+    '''Get GPO information using gpo, displayname or dn'''
+
+    policies_dn = samdb.get_default_basedn()
+    policies_dn.add_child(ldb.Dn(samdb, "CN=Policies,CN=System"))
+
+    base_dn = policies_dn
+    search_expr = "(objectClass=groupPolicyContainer)"
+    search_scope = ldb.SCOPE_ONELEVEL
+
+    if gpo is not None:
+        search_expr = "(&(objectClass=groupPolicyContainer)(name=%s))" % gpo
+
+    if displayname is not None:
+        search_expr = "(&(objectClass=groupPolicyContainer)(displayname=%s))" % displayname
+
+    if dn is not None:
+        base_dn = dn
+        search_scope = ldb.SCOPE_BASE
+
+    try:
+        msg = samdb.search(base=base_dn, scope=search_scope,
+                            expression=search_expr,
+                            attrs=['nTSecurityDescriptor',
+                                    'versionNumber',
+                                    'flags',
+                                    'name',
+                                    'displayName',
+                                    'gPCFileSysPath'])
+    except Exception, e:
+        if gpo is not None:
+            mesg = "Cannot get information for GPO %s" % gpo
+        else:
+            mesg = "Cannot get information for GPOs"
+        raise CommandError(mesg, e)
+
+    return msg
+
+
 class cmd_listall(Command):
     """list all GPOs"""
 
-    synopsis = "%prog gpo listall"
-
-    takes_optiongroups = {
-        "sambaopts": options.SambaOptions,
-        "versionopts": options.VersionOptions,
-        "credopts": options.CredentialsOptions,
-    }
+    synopsis = "%prog gpo listall [options]"
 
     takes_options = [
-        Option("-H", help="LDB URL for database or target server", type=str)
+        Option("-H", "--URL", help="LDB URL for database or target server", type=str,
+               metavar="URL", dest="H")
         ]
 
-    def run(self, H=None, sambaopts=None,
-            credopts=None, versionopts=None, server=None):
+    def run(self, H=None, sambaopts=None, credopts=None, versionopts=None):
 
-        self.url = H
         self.lp = sambaopts.get_loadparm()
-
         self.creds = credopts.get_credentials(self.lp, fallback_machine=True)
 
-        samdb_connect(self)
+        self.url = dc_url(self.lp, self.creds, H)
 
-        policies_dn = self.samdb.get_default_basedn()
-        policies_dn.add_child(ldb.Dn(self.samdb, "CN=Policies,CN=System"))
+        samdb_connect(self)
 
         gpo_flags = [
             ("GPO_FLAG_USER_DISABLE", dsdb.GPO_FLAG_USER_DISABLE ),
             ( "GPO_FLAG_MACHINE_DISABLE", dsdb.GPO_FLAG_MACHINE_DISABLE ) ]
 
-        try:
-            msg = self.samdb.search(base=policies_dn, scope=ldb.SCOPE_ONELEVEL,
-                                    expression="(objectClass=groupPolicyContainer)",
-                                    attrs=['nTSecurityDescriptor', 'versionNumber', 'flags', 'name', 'displayName', 'gPCFileSysPath'])
-        except Exception, e:
-            raise CommandError("Failed to list policies in %s" % policies_dn, e)
+        msg = get_gpo_info(self.samdb, None)
+
         for m in msg:
             print("GPO          : %s" % m['name'][0])
             print("display name : %s" % m['displayName'][0])
@@ -132,36 +193,32 @@ class cmd_listall(Command):
 
 
 class cmd_list(Command):
-    """list GPOs for a user"""
+    """list GPOs for an account"""
 
-    synopsis = "%prog gpo list <username>"
-
-    takes_optiongroups = {
-        "sambaopts": options.SambaOptions,
-        "versionopts": options.VersionOptions,
-        "credopts": options.CredentialsOptions,
-    }
+    synopsis = "%prog gpo list <username> [options]"
 
     takes_args = [ 'username' ]
 
     takes_options = [
-        Option("-H", help="LDB URL for database or target server", type=str)
+        Option("-H", "--URL", help="LDB URL for database or target server", type=str,
+               metavar="URL", dest="H")
         ]
 
-    def run(self, username, H=None, sambaopts=None,
-            credopts=None, versionopts=None, server=None):
+    def run(self, username, H=None, sambaopts=None, credopts=None, versionopts=None):
 
-        self.url = H
         self.lp = sambaopts.get_loadparm()
-
         self.creds = credopts.get_credentials(self.lp, fallback_machine=True)
 
+        self.url = dc_url(self.lp, self.creds, H)
+
         samdb_connect(self)
 
         try:
-            user_dn = self.samdb.search(expression='(&(samAccountName=%s)(objectclass=User))' % username)[0].dn
+            msg = self.samdb.search(expression='(&(|(samAccountName=%s)(samAccountName=%s$))(objectClass=User))' %
+                                                (username,username))
+            user_dn = msg[0].dn
         except Exception, e:
-            raise CommandError("Failed to find user %s" % username, e)
+            raise CommandError("Failed to find account %s" % username, e)
 
         # check if its a computer account
         try:
@@ -198,9 +255,10 @@ class cmd_list(Command):
 
                     try:
                         gmsg = self.samdb.search(base=g['dn'], scope=ldb.SCOPE_BASE,
-                                                 attrs=['flags', 'ntSecurityDescriptor'])
+                                                 attrs=['name', 'displayName', 'flags',
+                                                        'ntSecurityDescriptor'])
                     except Exception:
-                        print "Failed to fetch gpo object %s" % g['dn']
+                        print("Failed to fetch gpo object %s" % g['dn'])
                         continue
 
                     secdesc_ndr = gmsg[0]['ntSecurityDescriptor'][0]
@@ -212,7 +270,7 @@ class cmd_list(Command):
                                                     dcerpc.security.SEC_ADS_LIST |
                                                     dcerpc.security.SEC_ADS_READ_PROP)
                     except RuntimeError:
-                        print "Failed access check on %s" % msg.dn
+                        print("Failed access check on %s" % msg.dn)
                         continue
 
                     # check the flags on the GPO
@@ -221,7 +279,7 @@ class cmd_list(Command):
                         continue
                     if not is_computer and (flags & dsdb.GPO_FLAG_USER_DISABLE):
                         continue
-                    gpos.append(g)
+                    gpos.append((gmsg[0]['displayName'][0], gmsg[0]['name'][0]))
 
             # check if this blocks inheritance
             gpoptions = int(attr_default(msg, 'gPOptions', 0))
@@ -232,14 +290,394 @@ class cmd_list(Command):
                 break
             dn = dn.parent()
 
-        print("GPO's for user %s" % username)
+        if is_computer:
+            msg_str = 'computer'
+        else:
+            msg_str = 'user'
+
+        print("GPOs for %s %s" % (msg_str, username))
         for g in gpos:
-            print("\t%s" % g['dn'])
+            print("    %s %s" % (g[0], g[1]))
+
+
+class cmd_show(Command):
+    """Show information for a GPO"""
+
+    synopsis = "%prog gpo show <gpo> [options]"
+
+    takes_optiongroups = {
+        "sambaopts": options.SambaOptions,
+        "versionopts": options.VersionOptions,
+        "credopts": options.CredentialsOptions,
+    }
+
+    takes_args = [ 'gpo' ]
+
+    takes_options = [
+        Option("-H", help="LDB URL for database or target server", type=str)
+        ]
+
+    def run(self, gpo, H=None, sambaopts=None, credopts=None, versionopts=None):
+
+        self.lp = sambaopts.get_loadparm()
+        self.creds = credopts.get_credentials(self.lp, fallback_machine=True)
+
+        self.url = dc_url(self.lp, self.creds, H)
+
+        samdb_connect(self)
+
+        gpo_flags = [
+            ("GPO_FLAG_USER_DISABLE", dsdb.GPO_FLAG_USER_DISABLE ),
+            ( "GPO_FLAG_MACHINE_DISABLE", dsdb.GPO_FLAG_MACHINE_DISABLE ) ]
+
+        try:
+            msg = get_gpo_info(self.samdb, gpo)[0]
+        except Exception, e:
+            raise CommandError("GPO %s does not exist" % gpo, e)
+
+        secdesc_ndr = msg['ntSecurityDescriptor'][0]
+        secdesc = ndr_unpack(dcerpc.security.descriptor, secdesc_ndr)
+
+        print("GPO          : %s" % msg['name'][0])
+        print("display name : %s" % msg['displayName'][0])
+        print("path         : %s" % msg['gPCFileSysPath'][0])
+        print("dn           : %s" % msg.dn)
+        print("version      : %s" % attr_default(msg, 'versionNumber', '0'))
+        print("flags        : %s" % flags_string(gpo_flags, int(attr_default(msg, 'flags', 0))))
+        print("ACL          : %s" % secdesc.as_sddl())
+        print("")
+
+
+class cmd_getlink(Command):
+    """List GPO Links for a container"""
+
+    synopsis = "%prog gpo getlink <container_dn> [options]"
+
+    takes_optiongroups = {
+        "sambaopts": options.SambaOptions,
+        "versionopts": options.VersionOptions,
+        "credopts": options.CredentialsOptions,
+    }
+
+    takes_args = [ 'container_dn' ]
+
+    takes_options = [
+        Option("-H", help="LDB URL for database or target server", type=str)
+        ]
+
+    def run(self, container_dn, H=None, sambaopts=None, credopts=None,
+                versionopts=None):
+
+        self.lp = sambaopts.get_loadparm()
+        self.creds = credopts.get_credentials(self.lp, fallback_machine=True)
+
+        self.url = dc_url(self.lp, self.creds, H)
+
+        samdb_connect(self)
+
+        gplink_options = [
+                ("GPLINK_OPT_DISABLE", dsdb.GPLINK_OPT_DISABLE),
+                ("GPLINK_OPT_ENFORCE", dsdb.GPLINK_OPT_ENFORCE),
+            ]
+
+        try:
+            msg = self.samdb.search(base=container_dn, scope=ldb.SCOPE_BASE,
+                                    expression="(objectClass=*)",
+                                    attrs=['gPlink'])[0]
+        except Exception, e:
+            raise CommandError("Could not find Container DN %s (%s)" % container_dn, e)
+
+        if 'gPLink' in msg:
+            print("GPO(s) linked to DN %s" % container_dn)
+            gplist = parse_gplink(msg['gPLink'][0])
+            for g in gplist:
+                msg = get_gpo_info(self.samdb, dn=g['dn'])
+                print("    GPO     : %s" % msg[0]['name'][0])
+                print("    Name    : %s" % msg[0]['displayName'][0])
+                print("    Options : %s" % flags_string(gplink_options, g['options']))
+                print("")
+        else:
+            print("No GPO(s) linked to DN=%s" % container_dn)
+
+
+class cmd_setlink(Command):
+    """Add or Update a GPO link to a container"""
+
+    synopsis = "%prog gpo setlink <container_dn> <gpo> [options]"
+
+    takes_optiongroups = {
+        "sambaopts": options.SambaOptions,
+        "versionopts": options.VersionOptions,
+        "credopts": options.CredentialsOptions,
+    }
+
+    takes_args = [ 'container_dn', 'gpo' ]
+
+    takes_options = [
+        Option("-H", help="LDB URL for database or target server", type=str),
+        Option("--disable", dest="disabled", default=False, action='store_true',
+            help="Disable policy"),
+        Option("--enforce", dest="enforced", default=False, action='store_true',
+            help="Enforce policy")
+        ]
+
+    def run(self, container_dn, gpo, H=None, disabled=False, enforced=False,
+                sambaopts=None, credopts=None, versionopts=None):
+
+        self.lp = sambaopts.get_loadparm()
+        self.creds = credopts.get_credentials(self.lp, fallback_machine=True)
+
+        self.url = dc_url(self.lp, self.creds, H)
+
+        samdb_connect(self)
+
+        gplink_options = 0
+        if disabled:
+            gplink_options |= dsdb.GPLINK_OPT_DISABLE
+        if enforced:
+            gplink_options |= dsdb.GPLINK_OPT_ENFORCE
+
+        # Check if valid GPO DN
+        try:
+            msg = get_gpo_info(self.samdb, gpo=gpo)[0]
+        except Exception, e:
+            raise CommandError("GPO %s does not exist" % gpo_dn, e)
+        gpo_dn = get_gpo_dn(self.samdb, gpo)
+
+        # Check if valid Container DN
+        try:
+            msg = self.samdb.search(base=container_dn, scope=ldb.SCOPE_BASE,
+                                    expression="(objectClass=*)",
+                                    attrs=['gPlink'])[0]
+        except Exception, e:
+            raise CommandError("Could not find container DN %s" % container_dn, e)
+
+        # Update existing GPlinks or Add new one
+        existing_gplink = False
+        if 'gPLink' in msg:
+            gplist = parse_gplink(msg['gPLink'][0])
+            existing_gplink = True
+            found = False
+            for g in gplist:
+                if g['dn'].lower() == gpo_dn.lower():
+                    g['options'] = gplink_options
+                    found = True
+                    break
+            if not found:
+                gplist.insert(0, { 'dn' : gpo_dn, 'options' : gplink_options })
+        else:
+            gplist = []
+            gplist.append({ 'dn' : gpo_dn, 'options' : gplink_options })
+
+        gplink_str = encode_gplink(gplist)
+
+        m = ldb.Message()
+        m.dn = ldb.Dn(self.samdb, container_dn)
+
+        if existing_gplink:
+            m['new_value'] = ldb.MessageElement(gplink_str, ldb.FLAG_MOD_REPLACE, 'gPLink')
+        else:
+            m['new_value'] = ldb.MessageElement(gplink_str, ldb.FLAG_MOD_ADD, 'gPLink')
+
+        try:
+            self.samdb.modify(m)
+        except Exception, e:
+            raise CommandError("Error adding GPO Link", e)
+
+        print("Added/Updated GPO link")
+        cmd_getlink().run(container_dn, H, sambaopts, credopts, versionopts)
+
+
+class cmd_dellink(Command):
+    """Delete GPO link from a container"""
+
+    synopsis = "%prog gpo dellink <container_dn> <gpo> [options]"
+
+    takes_optiongroups = {
+        "sambaopts": options.SambaOptions,
+        "versionopts": options.VersionOptions,
+        "credopts": options.CredentialsOptions,
+    }
+
+    takes_args = [ 'container_dn', 'gpo' ]
+
+    takes_options = [
+        Option("-H", help="LDB URL for database or target server", type=str),
+        ]
+
+    def run(self, container_dn, gpo_dn, H=None, sambaopts=None, credopts=None,
+                versionopts=None):
+
+        self.lp = sambaopts.get_loadparm()
+        self.creds = credopts.get_credentials(self.lp, fallback_machine=True)
+
+        self.url = dc_url(self.lp, self.creds, H)
+
+        samdb_connect(self)
+
+        # Check if valid GPO
+        try:
+            msg = get_gpo_info(self.sambdb, gpo=gpo)[0]
+        except Exception, e:
+                raise CommandError("GPO %s does not exist" % gpo, e)
+        gpo_dn = get_gpo_dn(self.samdb, gpo)
+
+        # Check if valid Container DN and get existing GPlinks
+        try:
+            msg = self.samdb.search(base=container_dn, scope=ldb.SCOPE_BASE,
+                                    expression="(objectClass=*)",
+                                    attrs=['gPlink'])[0]
+        except Exception, e:
+            raise CommandError("Could not find container DN %s" % dn, e)
+
+        if 'gPLink' in msg:
+            gplist = parse_gplink(msg['gPLink'][0])
+            for g in gplist:
+                if g['dn'].lower() == gpo_dn.lower():
+                    gplist.remove(g)
+                    break
+        else:
+            raise CommandError("Specified GPO is not linked to this container");
+
+        m = ldb.Message()
+        m.dn = ldb.Dn(self.samdb, container_dn)
+
+        if gplist:
+            gplink_str = encode_gplink(gplist)
+            m['new_value'] = ldb.MessageElement(gplink_str, ldb.FLAG_MOD_REPLACE, 'gPLink')
+        else:
+            m['new_value'] = ldb.MessageElement('', ldb.FLAG_MOD_DELETE, 'gPLink')
+
+        try:
+            self.samdb.modify(m)
+        except Exception, e:
+            raise CommandError("Error Removing GPO Link (%s)" % e)
+
+        print("Deleted GPO link.")
+        cmd_getlink().run(container_dn, H, sambaopts, credopts, versionopts)
+
+
+class cmd_getinheritance(Command):
+    """Get inheritance flag for a container"""
+
+    synopsis = "%prog gpo getinheritance <container_dn> [options]"
+
+    takes_optiongroups = {
+        "sambaopts": options.SambaOptions,
+        "versionopts": options.VersionOptions,
+        "credopts": options.CredentialsOptions,
+    }
+
+    takes_args = [ 'container_dn' ]
+
+    takes_options = [
+        Option("-H", help="LDB URL for database or target server", type=str)
+        ]
+
+    def run(self, container_dn, H=None, sambaopts=None, credopts=None,
+                versionopts=None):
+
+        self.url = H
+        self.lp = sambaopts.get_loadparm()
+
+        self.creds = credopts.get_credentials(self.lp, fallback_machine=True)
+
+        samdb_connect(self)
+
+        try:
+            msg = self.samdb.search(base=container_dn, scope=ldb.SCOPE_BASE,
+                                    expression="(objectClass=*)",
+                                    attrs=['gPOptions'])[0]
+        except Exception, e:
+            raise CommandError("Could not find Container DN %s" % container_dn, e)
+
+        inheritance = 0
+        if 'gPOptions' in msg:
+            inheritance = int(msg['gPOptions'][0]);
+
+        if inheritance == dsdb.GPO_BLOCK_INHERITANCE:
+            print("Container has GPO_BLOCK_INHERITANCE")
+        else:
+            print("Container has GPO_INHERIT")
+
+
+class cmd_setinheritance(Command):
+    """Set inheritance flag on a container"""
+
+    synopsis = "%prog gpo setinheritance <container_dn> <block|inherit> [options]"
+
+    takes_optiongroups = {
+        "sambaopts": options.SambaOptions,
+        "versionopts": options.VersionOptions,
+        "credopts": options.CredentialsOptions,
+    }
+
+    takes_args = [ 'container_dn', 'inherit_state' ]
+
+    takes_options = [
+        Option("-H", help="LDB URL for database or target server", type=str)
+        ]
+
+    def run(self, container_dn, inherit_state, H=None, sambaopts=None, credopts=None,
+                versionopts=None):
+
+        if inherit_state.lower() == 'block':
+            inheritance = dsdb.GPO_BLOCK_INHERITANCE
+        elif inherit_state.lower() == 'inherit':
+            inheritance = dsdb.GPO_INHERIT
+        else:
+            raise CommandError("Unknown inheritance state (%s)" % inherit_state)
+
+        self.url = H
+        self.lp = sambaopts.get_loadparm()
+
+        self.creds = credopts.get_credentials(self.lp, fallback_machine=True)
+
+        samdb_connect(self)
+
+        try:
+            msg = self.samdb.search(base=container_dn, scope=ldb.SCOPE_BASE,
+                                    expression="(objectClass=*)",
+                                    attrs=['gPOptions'])[0]
+        except Exception, e:
+            raise CommandError("Could not find Container DN %s" % container_dn, e)
+
+        m = ldb.Message()
+        m.dn = ldb.Dn(self.samdb, container_dn)
+
+        if 'gPOptions' in msg:
+            m['new_value'] = ldb.MessageElement(str(inheritance), ldb.FLAG_MOD_REPLACE, 'gPOptions')
+        else:
+            m['new_value'] = ldb.MessageElement(str(inheritance), ldb.FLAG_MOD_ADD, 'gPOptions');
+
+        try:
+            self.samdb.modify(m)
+        except Exception, e:
+            raise CommandError("Error setting inheritance state %s" % inherit_state, e)
+
+
+class cmd_fetch(Command):
+    """Download a GPO"""
+
+class cmd_create(Command):
+    """Create a GPO"""
+
+class cmd_setacl(Command):
+    """Set ACL on a GPO"""
 
 
 class cmd_gpo(SuperCommand):
-    """GPO commands"""
+    """Group Policy Object (GPO) commands"""
 
     subcommands = {}
     subcommands["listall"] = cmd_listall()
     subcommands["list"] = cmd_list()
+    subcommands["show"] = cmd_show()
+    subcommands["getlink"] = cmd_getlink()
+    subcommands["setlink"] = cmd_setlink()
+    subcommands["dellink"] = cmd_dellink()
+    subcommands["getinheritance"] = cmd_getinheritance()
+    subcommands["setinheritance"] = cmd_setinheritance()
+    subcommands["fetch"] = cmd_fetch()
+    subcommands["create"] = cmd_create()
+    subcommands["setacl"] = cmd_setacl()