Skip to content

ambientelivre/AlfrescoResetPassword

 
 

Repository files navigation

AlfrescoResetPassword

Alfresco Reset Password add-on is a great thing that allows you to solve missing capability of Alfresco to reset passwords for users who forgot owns password without contacting Administrator.

Features

  • Sends email notification with a confirmation link
  • Reset password link will be expired after 24h
  • It works fine even if multitenancy feature is enabled

User's reset password manual

  • Click Forgot Password button

  • Enter username

  • You'll receive email notification with link for changing password

  • Enter your new password and confirm it.

Compatibility was tested on versions:

  • Alfresco 5.0d
  • Alfresco 5.1
  • Alfresco 5.2
  • Alfresco 6.0.7-ga
  • Alfresco 6.2.0-ga

How to build

The following tools must be installed:

  • Java11
  • Maven3

Required settings

  • You have to configure Alfresco Outbound SMTP in {ALFRESCO LOCATION}/tomcat/shared/classes/alfresco-global.properties.
 mail.host={mail host}
 mail.port={mail port}
 mail.username={mail username}
 mail.password={mail password}
 mail.protocol=smtps
 mail.smtps.starttls.enable=true
 mail.smtps.auth=true
 mail.from.enabled=false
 mail.from.default={default sending email}
  • It is highly recommended to change secure salt property as well that us used in token generation. To generate new one use any BCrypt hash generator. First 29 characters is salt fs.passreset.salt=

Build steps

  1. Clone repo
$ git clone https://github.com/FlexSolution/AlfrescoResetPassword.git
  1. Compile repo amp
$ cd ResetPasswordAddon/resetPassword
$ mvn clean package
  1. Compile share amp
$ cd ../resetPassword-share
$ mvn clean package

How to deploy add-on to Alfresco

  1. Compile AMPs for alfresco and share how described above
  2. Stop Alfresco
  3. Copy file ResetPasswordAddon/resetPassword/target/reset-password-repo-${version}.amp into ${Alfresco_HOME}/amps folder
  4. Copy file ResetPasswordAddon/resetPassword-share/target/reset-password-share-${version}.amp into ${Alfresco_HOME}/amps_share folder
  5. Apply AMPs by executing command from command line
$ cd ${Alfresco_HOME}/bin
$ apply_amps.sh -force
  1. Start Alfresco

##How to setup dev environment: You need to have installed docker and configured to use without root privileges https://docs.docker.com/install

  1. Add Remote Debugger cofiguration.

  2. Configure Before launch: Tool window and point at start.sh or start.bat as executable script. (files within _docker folder should be executable).

  3. Point at logs.txt as logs file.

All alfresco configuration placed in docker-compose.yml. You can place additional configuration there if you need

To stop docker containers use stop-all.sh or stop-all.bat script. start.sh|bat script also stops containers and starts again

To debug Share app java code create new Remote configuration. Use port 5006

About

Reset Password add-on for Alfresco

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 56.6%
  • JavaScript 21.2%
  • FreeMarker 18.1%
  • Dockerfile 1.2%
  • CSS 1.1%
  • Batchfile 1.1%
  • Shell 0.7%