1NS-NEWPWPOLICY.PL(8)        System Manager's Manual       NS-NEWPWPOLICY.PL(8)
2
3
4

NAME

6       ns-newpwpolicy.pl  -  Directory  Server  perl  script for preparing new
7       password policies.
8

SYNOPSIS

10       ns-newpwpolicy.pl [-Z serverID] [-v] [-D rootdn] {  -w  password  |  -j
11       filename } [-P protocol] [-p port] [-h host] -U UserDN -S SuffixDN
12

DESCRIPTION

14       Adds  entries  required  for  implementing  the user- and subtree-level
15       password policy.
16

OPTIONS

18       A summary of options is included below:
19
20       -Z Server Identifier
21              The server ID of the Directory Server  instance.   If  there  is
22              only one instance on the system, this option can be skipped.
23
24       -D Root DN
25              The  Directory  Manager  DN,  or root DN.  If not specified, the
26              script will search the server  instance  configuration  for  the
27              value.
28
29       -w password
30              The rootdn password.
31
32       -w -
33              Prompt for the rootdn password.
34
35       -j password filename
36              The name of the file that contains the root DN password.
37
38       -P Protocol
39              The  connection  protocol  to  connect  to the Directory Server.
40              Protocols are STARTTLS, LDAPS, LDAPI, and LDAP.  If this  option
41              is  skipped, the most secure protocol that is available is used.
42              For LDAPI, AUTOBIND is also available for the root user.
43
44       -h host
45              Host name of the Directory Server.
46
47       -p port
48              Port number of the Directory Server.
49
50       -U userDN
51              Specifies the DN of the user entry that needs to be updated with
52              user-level password policy attributes.
53
54       -S suffixDN
55              Specifies  the  DN  of the suffix entry that needs to be updated
56              with subtree-level password policy attributes.
57
58       -v
59              Display verbose output
60

EXAMPLE

62       ns-newpwpolicy.pl -Z instance3 -D 'cn=directory manager' -w password -P
63       STARTTLS -U 'uid=user,ou=people,dc=example,dc=com'
64
65              Note:  security  must  be  enabled to use protocol STARTTLS.  If
66              STARTTLS is not  available  it  will  default  to  next  strong‐
67              est/available protocol automatically.
68

DIAGNOSTICS

70       Exit  status  is  zero if no errors occur.  Errors result in a non-zero
71       exit status and a diagnostic message being written to standard error.
72

AUTHOR

74       ns-newpwpolicy.pl was written by the 389 Project.
75

REPORTING BUGS

77       Report bugs to https://pagure.io/389-ds-base/new_issue
78

80       Copyright © 2017 Red Hat, Inc.
81
82
83
84                                March 31, 2017            NS-NEWPWPOLICY.PL(8)
Impressum