Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Last revision Both sides next revision | ||
tutorial:adm:modules_pwdreset [2018/02/20 08:49] stloukalp [Reset password in user´s system accounts] |
tutorial:adm:modules_pwdreset [2024/06/04 14:38] kratochvils |
||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== Modules - pwd-reset: How to reset forgotten password? ====== | ||
+ | |||
+ | This module provides the functionality of password reset or, in other words, the recovery of a forgotten password. | ||
+ | |||
+ | ===== ===== | ||
+ | |||
+ | ==== How to allow password reset in CAS? ==== | ||
+ | |||
+ | For CAS docker set env variables: | ||
+ | |||
+ | < | ||
+ | - CAS_CUSTOM_FRONTEND_PASSWORDRESET_DISPLAY=true | ||
+ | - CAS_CUSTOM_FRONTEND_PASSWORDRESET_LINK=< | ||
+ | |||
+ | </ | ||
+ | |||
+ | ===== ===== | ||
+ | |||
+ | |||
+ | ===== How does it work? ===== | ||
+ | |||
+ | {{ : | ||
+ | |||
+ | ===== Process of restoring your forgotten password ===== | ||
+ | |||
+ | Users can restore their forgotten password via the password reset module. User can start the process on CzechIdM´s login page by clicking on " | ||
+ | |||
+ | {{ .: | ||
+ | |||
+ | For now, the identity' | ||
+ | |||
+ | {{ .: | ||
+ | |||
+ | After clicking on the link, which contains verification token in GET parameters, user is asked to fill in new password. If the password change succeeds (password validation is OK and user can change their own password), then the user can log in to CzechIdM with a new password. | ||
+ | |||
+ | {{ .: | ||
+ | |||
+ | ===== Password generating ===== | ||
+ | |||
+ | Password reset module has a process for generating new password by default based on a password policy for IdM. The form for password generating is a part of the password change component. To generate password to an end system it is necessary to enable the event type '' | ||
+ | |||
+ | Password generating is available by permission '' | ||
+ | |||
+ | <note important> | ||
+ | ===== Reset password in user´s system accounts ===== | ||
+ | |||
+ | Password reset module changes user's passwords only to their CzechIdM account. To reset passwords to end system accounts you need to have the acc module enabled and do a little bit of configuration. You need to set IdentityPasswordProvisioningProcessor and PasswordValidateProcessor to respond to PASSWORD_RESET event type. You can do it by setting | ||
+ | |||
+ | < | ||
+ | idm.sec.acc.processor.identity-password-provisioning-processor.eventTypes=PASSWORD, | ||
+ | idm.sec.acc.processor.identity-password-validate-processor.eventTypes=PASSWORD, | ||
+ | |||
+ | </ | ||
+ | |||
+ | After the password reset, notification is sent to user with system names and accounts, where password has been changed. This processor has to be enabled with setting | ||
+ | |||
+ | < | ||
+ | idm.sec.core.processor.identity-password-change-notification.eventTypes=PASSWORD, | ||
+ | |||
+ | </ | ||
+ | |||
+ | Now IdM will also reset password on all user accounts which support it. | ||
+ | |||
+ | ===== Installation ===== | ||
+ | |||
+ | Download the module distribution package. The package contains a backend folder. Your IdM Tomcat installation we call IDM in the following example. | ||
+ | |||
+ | - Copy the content of the backend folder into your tomcat IdM installation - [IDM]/ | ||
+ | - Set correct access rights to the files if needed ('' | ||
+ | - Restart the IdM application server ('' | ||
+ | - Log in to CzechIdM as a privileged user and go to Settings → Modules and enable the pwd-reset module. | ||
+ | - Go to the configuration and configure required properties (see below). | ||
+ | - Add the event types '' | ||
+ | |||
+ | ===== Configuration ===== | ||
+ | |||
+ | The module provides following configuration properties: | ||
+ | |||
+ | ^Property | ||
+ | |idm.pub.pwdreset.allowed.attrs | ||
+ | |idm.sec.pwdreset.token.ttl | ||
+ | |idm.pub.pwdreset.identity.passwordReset.public.idm.enabled | ||
+ | |idm.sec.pwdreset.debug | ||
+ | |idm.sec.pwdreset.token.length | ||
+ | |||
+ | ===== Video Guide ===== | ||
+ | |||
+ | [[https:// | ||
+ | |||
+ | ===== FAQ ===== | ||
+ | |||