source4/scripting/python/samba/netcmd/pwsettings.py

   1 #!/usr/bin/python
   2 #
   3 # Sets password settings.
   4 # (Password complexity, history length, minimum password length, the minimum
   5 # and maximum password age) on a Samba4 server
   6 #
   7 # Copyright Matthias Dieter Wallnoefer 2009
   8 # Copyright Andrew Kroeger 2009
   9 # Copyright Jelmer Vernooij 2009
  10 #
  11 # This program is free software; you can redistribute it and/or modify
  12 # it under the terms of the GNU General Public License as published by
  13 # the Free Software Foundation; either version 3 of the License, or
  14 # (at your option) any later version.
  15 #
  16 # This program is distributed in the hope that it will be useful,
  17 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  18 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  19 # GNU General Public License for more details.
  20 #
  21 # You should have received a copy of the GNU General Public License
  22 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
  23 #
  24
  25 import sys
  26
  27 import samba.getopt as options
  28 import optparse
  29 import ldb
  30
  31 from samba.auth import system_session
  32 from samba.samdb import SamDB
  33 from samba.dcerpc.samr import DOMAIN_PASSWORD_COMPLEX
  34 from samba.netcmd import Command, CommandError, Option
  35
  36 class cmd_pwsettings(Command):
  37     """Sets password settings.
  38
  39     Password complexity, history length, minimum password length, the minimum
  40     and maximum password age) on a Samba4 server.
  41     """
  42
  43     synopsis = "(show | set <options>)"
  44
  45     takes_optiongroups = [
  46         options.SambaOptions,
  47         options.VersionOptions,
  48         options.CredentialsOptions,
  49         ]
  50
  51     takes_options = [
  52         Option("-H", help="LDB URL for database or target server", type=str),
  53         Option("--quiet", help="Be quiet", action="store_true"),
  54         Option("--complexity", type="choice", choices=["on","off","default"],
  55           help="The password complexity (on | off | default). Default is 'on'"),
  56         Option("--history-length",
  57           help="The password history length (<integer> | default).  Default is 24.", type=str),
  58         Option("--min-pwd-length",
  59           help="The minimum password length (<integer> | default).  Default is 7.", type=str),
  60         Option("--min-pwd-age",
  61           help="The minimum password age (<integer in days> | default).  Default is 0.", type=str),
  62         Option("--max-pwd-age",
  63           help="The maximum password age (<integer in days> | default).  Default is 43.", type=str),
  64           ]
  65
  66     def run(self, H=None, min_pwd_age=None, max_pwd_age=None, quiet=False,
  67             complexity=None, history_length=None, min_pwd_length=None,
  68             username=None, simple_bind_dn=None, no_pass=None, workgroup=None,
  69             kerberos=None, configfile=None, password=None):
  70         lp = sambaopts.get_loadparm()
  71         creds = credopts.get_credentials(lp)
  72
  73         if H is not None:
  74             url = H
  75         else:
  76             url = lp.get("sam database")
  77
  78         samdb = SamDB(url=url, session_info=system_session(), credentials=creds, lp=lp)
  79
  80         domain_dn = SamDB.domain_dn(samdb)
  81         res = samdb.search(domain_dn, scope=ldb.SCOPE_BASE,
  82           attrs=["pwdProperties", "pwdHistoryLength", "minPwdLength", "minPwdAge",
  83           "maxPwdAge"])
  84         assert(len(res) == 1)
  85         try:
  86             pwd_props = int(res[0]["pwdProperties"][0])
  87             pwd_hist_len = int(res[0]["pwdHistoryLength"][0])
  88             min_pwd_len = int(res[0]["minPwdLength"][0])
  89             # ticks -> days
  90             min_pwd_age = int(abs(int(res[0]["minPwdAge"][0])) / (1e7 * 60 * 60 * 24))
  91             max_pwd_age = int(abs(int(res[0]["maxPwdAge"][0])) / (1e7 * 60 * 60 * 24))
  92         except KeyError:
  93             raise CommandError("Could not retrieve password properties!")
  94
  95         if args[0] == "show":
  96             self.message("Password informations for domain '%s'" % domain_dn)
  97             self.message("")
  98             if pwd_props & DOMAIN_PASSWORD_COMPLEX != 0:
  99                 self.message("Password complexity: on")
 100             else:
 101                 self.message("Password complexity: off")
 102             self.message("Password history length: %d" % pwd_hist_len)
 103             self.message("Minimum password length: %d" % min_pwd_len)
 104             self.message("Minimum password age (days): %d" % min_pwd_age)
 105             self.message("Maximum password age (days): %d" % max_pwd_age)
 106         elif args[0] == "set":
 107             msgs = []
 108             m = ldb.Message()
 109             m.dn = ldb.Dn(samdb, domain_dn)
 110
 111             if complexity is not None:
 112                 if complexity == "on" or complexity == "default":
 113                     pwd_props = pwd_props | DOMAIN_PASSWORD_COMPLEX
 114                     msgs.append("Password complexity activated!")
 115                 elif complexity == "off":
 116                     pwd_props = pwd_props & (~DOMAIN_PASSWORD_COMPLEX)
 117                     msgs.append("Password complexity deactivated!")
 118
 119                 m["pwdProperties"] = ldb.MessageElement(str(pwd_props),
 120                   ldb.FLAG_MOD_REPLACE, "pwdProperties")
 121
 122             if history_length is not None:
 123                 if history_length == "default":
 124                     pwd_hist_len = 24
 125                 else:
 126                     pwd_hist_len = int(history_length)
 127
 128                 if pwd_hist_len < 0 or pwd_hist_len > 24:
 129                     raise CommandError("Password history length must be in the range of 0 to 24!")
 130
 131                 m["pwdHistoryLength"] = ldb.MessageElement(str(pwd_hist_len),
 132                   ldb.FLAG_MOD_REPLACE, "pwdHistoryLength")
 133                 msgs.append("Password history length changed!")
 134
 135             if min_pwd_length is not None:
 136                 if min_pwd_length == "default":
 137                     min_pwd_len = 7
 138                 else:
 139                     min_pwd_len = int(min_pwd_length)
 140
 141                 if min_pwd_len < 0 or min_pwd_len > 14:
 142                     raise CommandError("Minimum password length must be in the range of 0 to 14!")
 143
 144                 m["minPwdLength"] = ldb.MessageElement(str(min_pwd_len),
 145                   ldb.FLAG_MOD_REPLACE, "minPwdLength")
 146                 msgs.append("Minimum password length changed!")
 147
 148             if min_pwd_age is not None:
 149                 if min_pwd_age == "default":
 150                     min_pwd_age = 0
 151                 else:
 152                     min_pwd_age = int(min_pwd_age)
 153
 154                 if min_pwd_age < 0 or min_pwd_age > 998:
 155                     raise CommandError("Minimum password age must be in the range of 0 to 998!")
 156
 157                 # days -> ticks
 158                 min_pwd_age_ticks = -int(min_pwd_age * (24 * 60 * 60 * 1e7))
 159
 160                 m["minPwdAge"] = ldb.MessageElement(str(min_pwd_age_ticks),
 161                   ldb.FLAG_MOD_REPLACE, "minPwdAge")
 162                 msgs.append("Minimum password age changed!")
 163
 164             if max_pwd_age is not None:
 165                 if max_pwd_age == "default":
 166                     max_pwd_age = 43
 167                 else:
 168                     max_pwd_age = int(max_pwd_age)
 169
 170                 if max_pwd_age < 0 or max_pwd_age > 999:
 171                     raise CommandError("Maximum password age must be in the range of 0 to 999!")
 172
 173                 # days -> ticks
 174                 max_pwd_age_ticks = -int(max_pwd_age * (24 * 60 * 60 * 1e7))
 175
 176                 m["maxPwdAge"] = ldb.MessageElement(str(max_pwd_age_ticks),
 177                   ldb.FLAG_MOD_REPLACE, "maxPwdAge")
 178                 msgs.append("Maximum password age changed!")
 179
 180             if max_pwd_age > 0 and min_pwd_age >= max_pwd_age:
 181                 raise CommandError("Maximum password age (%d) must be greater than minimum password age (%d)!" % (max_pwd_age, min_pwd_age))
 182
 183             samdb.modify(m)
 184             msgs.append("All changes applied successfully!")
 185             self.message("\n".join(msgs))
 186         else:
 187             raise CommandError("Wrong argument '" + args[0] + "'!")