help centre
For more info visit status.atmail.com

How can we help?


Search our knowledge base for answers to
common questions and latest updates.



My activities New request

Follow

Password Recovery

Dominic -

PROBLEM

How can I set up password recovery?

ENVIRONMENT

  • atmail suite
  • atmail mail server

CAUSE

Allow users to define a recovery email for password reset.

RESOLUTION

Create user for Password Recovery

  1. From your webadmin, create a user in your Account Manager. Since we are creating a specific user for password recovery, it is appropriate to create the user as 'noreply@domain.com' or something similar. For this example I am using:
    • Username: noreply@fish.local
    • Domain: fish.local
    • Password: Snpg3h#o

      Screenshot_from_2017-08-25_14-44-00.png


Update atmail API.

  1.  Once the account is created, open your api.conf with your favored text editor.
    [root@mydomain ~]# vim /etc/atmail/api/api.conf
  2. Update the following variables to correspond to our newly created noreply user.
    ###
    ### Forgot Password
    ###

    FORGOTTEN_PW_USER=noreply@fish.local
    FORGOTTEN_PW_PASS=Snpg3h#o
  3. Restart and check the status of your API server.
    [root@mydomain ~]# systemctl restart apiserver
    [root@mydomain ~]# systemctl status apiserver
    ● apiserver.service - atmail-api - jmap api for atmail webmail
    Loaded: loaded (/usr/lib/systemd/system/apiserver.service; enabled; vendor preset: disabled)
    Drop-In: /etc/systemd/system/apiserver.service.d
    └─depends.conf
    Active: active (running) since Fri 2017-08-25 11:51:33 AEST; 2s ago
    Docs: http://www.atmail.com/
    Process: 2350 ExecStop=/bin/kill -s QUIT $MAINPID (code=exited, status=0/SUCCESS)
    Main PID: 2353 (apiserver)
    CGroup: /system.slice/apiserver.service
    └─2353 /usr/bin/apiserver -config /etc/atmail/api/api.conf

    Aug 25 11:51:33 mydomain.party systemd[1]: apiserver.service: main process exited, code=exited, sta...MENT
    Aug 25 11:51:33 mydomain.party systemd[1]: Unit apiserver.service entered failed state.
    Aug 25 11:51:33 mydomain.party systemd[1]: apiserver.service failed.
    Aug 25 11:51:33 mydomain.party systemd[1]: Started atmail-api - jmap api for atmail webmail.
    Aug 25 11:51:33 mydomain.party systemd[1]: Starting atmail-api - jmap api for atmail webmail...
    Hint: Some lines were ellipsized, use -l to show in full.

User Testing

  1. Login to your user account and find settings Screenshot_from_2017-08-25_15-20-57.png -> Accounts.
  2. Answer a minimum of three security questions.

    Screenshot_from_2017-08-25_15-23-07.png

  3. Designate a Recovery email address.

    Screenshot_from_2017-08-25_15-12-36.png

  4. Log-out and test.

    Screenshot_from_2017-08-25_15-13-34.png

  5. Confirm receipt of recovery email.

    Screenshot_from_2017-08-25_15-14-13.png

Troubleshooting

If you face any issues implementing this feature, the following logs will provide useful information as to why it may be failing.

  • /var/log/atmail/api.log
  • /var/log/maillog

 

Have more questions? Submit a request

Comments


Contact our support team


+61 (7) 5357 6605       support@atmail.com