|
|
|
|
@ -26,21 +26,25 @@ See INSTALL file
|
|
|
|
|
USAGE
|
|
|
|
|
-----
|
|
|
|
|
|
|
|
|
|
Create a password policy entry and indicate the fresh compiled
|
|
|
|
|
library ppm.so:
|
|
|
|
|
Create a password policy entry and indicate the path of the ppm.so library
|
|
|
|
|
and the content of the desired policy.
|
|
|
|
|
Use a base64 tool to code / decode the content of the policy stored into
|
|
|
|
|
pwdCheckModuleArg. Here is an example:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
dn: cn=default,ou=policies,dc=my-domain,dc=com
|
|
|
|
|
objectClass: pwdPolicy
|
|
|
|
|
objectClass: top
|
|
|
|
|
objectClass: pwdPolicyChecker
|
|
|
|
|
objectClass: person
|
|
|
|
|
objectClass: top
|
|
|
|
|
cn: default
|
|
|
|
|
sn: default
|
|
|
|
|
pwdAttribute: userPassword
|
|
|
|
|
pwdCheckQuality: 2
|
|
|
|
|
...
|
|
|
|
|
pwdCheckModule: /path/to/new/ppm.so
|
|
|
|
|
pwdCheckModuleArg: [see configuration section]
|
|
|
|
|
pwdAttribute: userPassword
|
|
|
|
|
sn: default
|
|
|
|
|
cn: default
|
|
|
|
|
pwdMinLength: 6
|
|
|
|
|
pwdCheckModule: /usr/local/lib/ppm.so
|
|
|
|
|
pwdCheckModuleArg:: bWluUXVhbGl0eSAzCmNoZWNrUkROIDAKZm9yYmlkZGVuQ2hhcnMKbWF4Q29uc2VjdXRpdmVQZXJDbGFzcyAwCnVzZUNyYWNrbGliIDAKY3JhY2tsaWJEaWN0IC92YXIvY2FjaGUvY3JhY2tsaWIvY3JhY2tsaWJfZGljdApjbGFzcy11cHBlckNhc2UgQUJDREVGR0hJSktMTU5PUFFSU1RVVldYWVogMCAxCmNsYXNzLWxvd2VyQ2FzZSBhYmNkZWZnaGlqa2xtbm9wcXJzdHV2d3h5eiAwIDEKY2xhc3MtZGlnaXQgMDEyMzQ1Njc4OSAwIDEKY2xhc3Mtc3BlY2lhbCA8Piw/Oy46LyHCp8O5JSrCtV7CqCTCo8KyJsOpfiIjJ3soWy18w6hgX1zDp17DoEApXcKwPX0rIDAgMQ==
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
See slapo-ppolicy for more information, but to sum up:
|
|
|
|
|
@ -94,7 +98,7 @@ Configuration
|
|
|
|
|
|
|
|
|
|
Since OpenLDAP 2.5 version, ppm configuration is held in a binary
|
|
|
|
|
attribute of the password policy: pwdCheckModuleArg
|
|
|
|
|
The configuration file (/etc/openldap/ppm.conf by default) is to be
|
|
|
|
|
The example file (/etc/openldap/ppm.example by default) is to be
|
|
|
|
|
considered as an example configuration, to import in the pwdCheckModuleArg
|
|
|
|
|
attribute. It is also used for testing passwords with the test program
|
|
|
|
|
provided.
|
|
|
|
|
@ -216,24 +220,88 @@ A more detailed message is written to the server log.
|
|
|
|
|
Server log:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: Opening file /etc/openldap/ppm.conf
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: Param = minQuality, value = 3, min = (null), minForPoint= (null)
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: Accepted replaced value: 3
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: Param = forbiddenChars, value = , min = (null), minForPoint= (null)
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: Accepted replaced value:
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: Param = class-upperCase, value = ABCDEFGHIJKLMNOPQRSTUVWXYZ, min = 0, minForPoint= 5
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: Accepted replaced value: ABCDEFGHIJKLMNOPQRSTUVWXYZ
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: Param = class-lowerCase, value = abcdefghijklmnopqrstuvwxyz, min = 0, minForPoint= 12
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: Accepted replaced value: abcdefghijklmnopqrstuvwxyz
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: Param = class-digit, value = 0123456789, min = 0, minForPoint= 1
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: Accepted replaced value: 0123456789
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: Param = class-special, value = <>,?;.:/!§ù%*µ^¨$£²&é~"#'{([-|è`_\ç^à @)]°=}+, min = 0, minForPoint= 1
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: Accepted replaced value: <>,?;.:/!§ù%*µ^¨$£²&é~"#'{([-|è`_\ç^à @)]°=}+
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: Param = class-myClass, value = :), min = 1, minForPoint= 1
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: Accepted new value:
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: 1 point granted for class class-upperCase
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: 1 point granted for class class-lowerCase
|
|
|
|
|
Jul 27 20:09:14 machine slapd[20270]: ppm: 1 point granted for class class-digit
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: conn=1000 op=16 MOD dn="uid=user,ou=persons,dc=my-domain,dc=com"
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: conn=1000 op=16 MOD attr=userPassword
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: entry uid=user,ou=persons,dc=my-domain,dc=com
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Reading pwdCheckModuleArg attribute
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: RAW configuration: # minQuality parameter#012# Format:#012# minQuality [NUMBER]#012# Description:#012# One point is granted for each class for which MIN_FOR_POINT criteria is fulfilled.#012# defines the minimum point numbers for the password to be accepted.#012minQuality 3#012#012# checkRDN parameter#012# Format:#012# checkRDN [0 | 1]#012# Description:#012# If set to 1, password must not contain a token from the RDN.#012# Tokens are separated by the following delimiters : space tabulation _ - , ; £#012checkRDN 0#012#012# forbiddenChars parameter#012# Format:#012# forbiddenChars [CHARACTERS_FORBIDDEN]#012# Description:#012# Defines the forbidden characters list (no separator).#012# If one of them is found in the password, then it is rejected.#012forbiddenChars#012#012# maxConsecutivePerClass parameter#012# Format:#012# maxConsecutivePerClass [NUMBER]#012# Description:#012# Defines the maximum number of consecutive character allowed for any class#012maxConsecutivePerClass 0#012#012# useCracklib parameter#012# Format:#012# useCracklib [0 | 1]#012# Description:#012# If set to 1, the password must pass the cracklib check#012useCracklib 0#012#012# cracklibDict parameter#012# Format:#012# cracklibDict [path_to_cracklib_dictionnary]#012# Description:#012# directory+filename-prefix that your version of CrackLib will go hunting for#012# For example, /var/pw_dict resolves as /var/pw_dict.pwd,#012# /var/pw_dict.pwi and /var/pw_dict.hwm dictionnary files#012cracklibDict /var/cache/cracklib/cracklib_dict#012#012# classes parameter#012# Format:#012# class-[CLASS_NAME] [CHARACTERS_DEFINING_CLASS] [MIN] [MIN_FOR_POINT]#012# Description:#012# [CHARACTERS_DEFINING_CLASS]: characters defining the class (no separator)#012# [MIN]: If at least [MIN] characters of this class is not found in the password, then it is rejected#012# [MIN_FOR_POINT]: one point is granted if password contains at least [MIN_FOR_POINT] character numbers of this class#012class-upperCase ABCDEFGHIJKLMNOPQRSTUVWXYZ 0 1#012class-lowerCase abcdefghijklmnopqrstuvwxyz 0 1#012class-digit 0123456789 0 1#012class-special <>,?;.:/!§ù%*µ^¨$£²&é~"#'{([-|è`_\ç^à@)]°=}+ 0 1
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Parsing pwdCheckModuleArg attribute
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # minQuality parameter
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Format:
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # minQuality [NUMBER]
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Description:
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # One point is granted for each class for which MIN_FOR_POINT criteria is fulfilled.
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # defines the minimum point numbers for the password to be accepted.
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: minQuality 3
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Param = minQuality, value = 3, min = (null), minForPoint= (null)
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Accepted replaced value: 3
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # checkRDN parameter
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Format:
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # checkRDN [0 | 1]
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Description:
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # If set to 1, password must not contain a token from the RDN.
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Tokens are separated by the following delimiters : space tabulation _ - , ; £
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: checkRDN 0
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Param = checkRDN, value = 0, min = (null), minForPoint= (null)
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Accepted replaced value: 0
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # forbiddenChars parameter
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Format:
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # forbiddenChars [CHARACTERS_FORBIDDEN]
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Description:
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Defines the forbidden characters list (no separator).
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # If one of them is found in the password, then it is rejected.
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: forbiddenChars
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: No value, goto next parameter
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # maxConsecutivePerClass parameter
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Format:
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # maxConsecutivePerClass [NUMBER]
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Description:
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Defines the maximum number of consecutive character allowed for any class
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: maxConsecutivePerClass 0
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Param = maxConsecutivePerClass, value = 0, min = (null), minForPoint= (null)
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Accepted replaced value: 0
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # useCracklib parameter
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Format:
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # useCracklib [0 | 1]
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Description:
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # If set to 1, the password must pass the cracklib check
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: useCracklib 0
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Param = useCracklib, value = 0, min = (null), minForPoint= (null)
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Accepted replaced value: 0
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # cracklibDict parameter
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Format:
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # cracklibDict [path_to_cracklib_dictionnary]
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Description:
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # directory+filename-prefix that your version of CrackLib will go hunting for
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # For example, /var/pw_dict resolves as /var/pw_dict.pwd,
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # /var/pw_dict.pwi and /var/pw_dict.hwm dictionnary files
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: cracklibDict /var/cache/cracklib/cracklib_dict
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Param = cracklibDict, value = /var/cache/cracklib/cracklib_dict, min = (null), minForPoint= (null)
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Accepted replaced value: /var/cache/cracklib/cracklib_dict
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # classes parameter
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Format:
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # class-[CLASS_NAME] [CHARACTERS_DEFINING_CLASS] [MIN] [MIN_FOR_POINT]
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # Description:
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # [CHARACTERS_DEFINING_CLASS]: characters defining the class (no separator)
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # [MIN]: If at least [MIN] characters of this class is not found in the password, then it is rejected
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: # [MIN_FOR_POINT]: one point is granted if password contains at least [MIN_FOR_POINT] character numbers of this class
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: class-upperCase ABCDEFGHIJKLMNOPQRSTUVWXYZ 0 1
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Param = class-upperCase, value = ABCDEFGHIJKLMNOPQRSTUVWXYZ, min = 0, minForPoint= 1
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Accepted replaced value: ABCDEFGHIJKLMNOPQRSTUVWXYZ
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: class-lowerCase abcdefghijklmnopqrstuvwxyz 0 1
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Param = class-lowerCase, value = abcdefghijklmnopqrstuvwxyz, min = 0, minForPoint= 1
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Accepted replaced value: abcdefghijklmnopqrstuvwxyz
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: class-digit 0123456789 0 1
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Param = class-digit, value = 0123456789, min = 0, minForPoint= 1
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Accepted replaced value: 0123456789
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: get line: class-special <>,?;.:/!§ù%*µ^¨$£²&é~"#'{([-|è`_\ç^à@)]°=}+ 0 1
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Param = class-special, value = <>,?;.:/!§ù%*µ^¨$£²&é~"#'{([-|è`_\ç^à@)]°=}+, min = 0, minForPoint= 1
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Accepted replaced value: <>,?;.:/!§ù%*µ^¨$£²&é~"#'{([-|è`_\ç^à@)]°=}+
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: 1 point granted for class class-lowerCase
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: 1 point granted for class class-digit
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: ppm: Reallocating szErrStr from 64 to 173
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: check_password_quality: module error: (/usr/local/lib/ppm.so) Password for dn="uid=user,ou=persons,dc=my-domain,dc=com" does not pass required number of strength checks (2 of 3).[1]
|
|
|
|
|
Feb 26 14:46:10 debian-10-64 slapd[1981]: conn=1000 op=16 RESULT tag=103 err=19 qtime=0.000020 etime=0.001496 text=Password for dn="uid=user,ou=persons,dc=my-domain,dc=com" does not pass required number of strength checks (2 of 3)
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@ -244,8 +312,8 @@ There is a unit test script: "unit_tests.sh" that illustrates checking some pass
|
|
|
|
|
It is possible to test one particular password using directly the test program:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
cd /usr/local/openldap/lib64
|
|
|
|
|
LD_LIBRARY_PATH=. ./ppm_test "uid=test,ou=users,dc=my-domain,dc=com" "my_password" "/usr/local/openldap/etc/openldap/ppm.conf" && echo OK
|
|
|
|
|
cd /usr/local/lib
|
|
|
|
|
LD_LIBRARY_PATH=. ./ppm_test "uid=test,ou=users,dc=my-domain,dc=com" "my_password" "/usr/local/etc/openldap/ppm.example" && echo OK
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|