diff --git a/docs/en-US/password-storage-engine.xml b/docs/en-US/password-storage-engine.xml new file mode 100644 index 00000000000..b1d5340ef94 --- /dev/null +++ b/docs/en-US/password-storage-engine.xml @@ -0,0 +1,54 @@ + + +%BOOK_ENTITIES; +]> + + +
+ Changing the Default Password Encryption + &PRODUCT; allows you to determine the default encoding and authentication mechanism for + admin and user logins. Plain text user authenticator has been changed to do a simple string + comparison between retrieved and supplied login passwords instead of comparing the retrieved md5 + hash of the stored password against the supplied md5 hash of the password because clients no + longer hash the password. The following method determines what encoding scheme is used to encode + the password supplied during user creation or modification. + When a new user is created, the user password is encoded by using the first valid encoder + loaded as per the sequence specified in the UserPasswordEncoders property in the + ComponentContext.xml or nonossComponentContext.xml + files. The order of authentication schemes is determined by the UserAuthenticators + property in the same files. The administrator can change the ordering of both these properties + as preferred. When a new authenticator or encoder is added, you can add them to this list. While + doing so, ensure that the new authenticator or encoder is specified as a bean in both these + files if they are required for both oss and non-oss components. The two properties are listed + below: + <property name="UserAuthenticators"> + <list> + <ref bean="SHA256SaltedUserAuthenticator"/> + <ref bean="MD5UserAuthenticator"/> + <ref bean="LDAPUserAuthenticator"/> + <ref bean="PlainTextUserAuthenticator"/> + </list> + </property> + <property name="UserPasswordEncoders"> + <list> + <ref bean="SHA256SaltedUserAuthenticator"/> + <ref bean="MD5UserAuthenticator"/> + <ref bean="LDAPUserAuthenticator"/> + <ref bean="PlainTextUserAuthenticator"/> + </list> +