Changing a User’s Password

    Overview

    This article will cover the various ways to change passwords in Sugar.

    Prerequisites

    • Users must have their personal email address configured in User Preferences to receive system-generated password emails or reset-password emails from Sugar. For more information on configuring your personal settings, please refer to the Getting Started documentation. 
    • Sugar’s outbound email server must be configured via Admin > Email Settings in order for Sugar to send system-generated password emails or reset password emails. For more information on configuring the system email settings, please refer to the Email documentation.
    • To configure and manage a Sugar instance’s password requirements, you must be an administrator user. 

    Steps to Complete

    Depending on the system’s password configuration settings, users may have the option to change or reset their Sugar password. However, if these options are not available to users, system administrators can easily update or reset the user’s password as well. Please reach out to your system administrator if you need assistance with changing your password.

    Note: For instances that use SugarIdentity, administrators will not be able to manually change or reset the user’s password via the user’s profile. Users can instead click the “Forgot Password?” link on the Sugar login screen to reset their password. Please note that only some SugarCloud instances use SugarIdentity. Refer to the SugarIdentity Guide to determine if yours is configured to do so. Existing customers will be notified before their instances begin using the service.

    Changing Your Password

    You can easily reset or change your own password from your user preferences or via the “Forgot Password?” link on the login screen. The following sections cover how to reset or change your own password in Sugar.   

    If you forget your Sugar password and need to reset it, you can easily request a password reset via the Forgot Password? link on Sugar’s login screen. Please note that this link will only appear if the system administrator has enabled the Forgot Password feature via Admin > Password Management. If you do not see the option on your login screen, please reach out to your system administrator for further assistance with resetting your password. 

    Use the following steps to reset your password:

    1. Click the Forgot Password? link on the bottom of Sugar’s login dialog box.
    2. Enter your Sugar username and primary email address on file, then click “Request Password” . If submitted successfully, a message will appear that your request has been submitted.
      • Note: The username and email address entered must match the information stored in your instance’s database.
          
    3. Click the Reset Password link in the email sent to your primary email address.
    4. Enter your username, new password, and confirmed password on the reset password page. Click the Log In button to access your instance.
        

    Changing Password via User Preferences

    You also have the option to change your own password by navigating to the Password tab in your user preferences. You can use this option to change your temporary Sugar password, system-generated password, or to update your current password for security reasons.

    Note: For instances that use SugarIdentity, users will not be able to change their password via their user profile.

    Use the following steps to change your password in Sugar:

    1. Log into your Sugar instance and click your user profile on the upper right of the page. Then select “Profile”.
    2. Click “Edit” on the upper left of your user profile and select the Password tab.
    3. Enter your current password, new password, and confirmed password making sure to meet the password requirements listed on the right.
      • Note: Each password requirement will be checked off in the list as the new password meets the required conditions. These password requirements are configurable by administrators via Admin > Password Management.
    4. Click “Save” to preserve the change.  

    Changing Another User’s Password

    Based on the configuration settings in Admin > Password Management, administrators can either reset or manually change a user’s password via Admin > User Management. For more information on how to configure and manage the system’s password settings, please refer to the Password Management documentation. The following sections cover how administrators can reset or change a user’s password.  

    Note: If no system administrators can log into their account, you can reset the administrator password from the database if you are running Sugar on site. For more information on how to reset the administrator password, please refer to the Resetting the Administrator Password From the Database article. 

    Note: For instances that use SugarIdentity, administrators will not be able to manually change or reset the user’s password via the user’s profile.

    Resetting Password via User’s Profile

    If the “Enable System-Generated Passwords Feature” is enabled in Admin > Password Management, then the administrator can reset a user’s password via Admin > User Management to send a system-generated password via email.   

    KB Final SGPassword Options

    Use the following steps to reset a user’s password:

    1. Navigate to the user’s detail view (e.g. Max Jensen) via Admin > User Management.
    2. Click the Actions menu and select “Reset Password”.

    A pop-up box will appear confirming the reset. Sugar will then send an email containing the system-generated password to the user’s primary email address on their user profile. If the user does not receive the email, please confirm that the user is checking the correct email account and ensure that the email address on file is valid. 

    Changing Password via User’s Profile

    If you wish to manually change a user’s password, then the “Enable System-Generated Passwords Feature” must be disabled in Admin > Password Management.

    Use the following steps to change a user’s password:

    1. Navigate to the user’s detail view (e.g. Max Jensen) via Admin > User Management.
    2. Click “Edit” on the upper left of the user profile then select the Password tab.
    3. Enter a new password and the confirmed password making sure to meet the password requirements listed on the right.
      • Note: Each password requirement will be checked off in the list as the new password meets the required conditions.
    4. Click “Save” to preserve the change.

    The administrator must then provide the user with the updated password information so that they can log into their instance. If the user wishes to change their password after logging in, they can refer to the steps in the Changing Password via User Preferences section of this article.

    in Users, Roles, and Teams

    Reach out to us for help