Customizing the Reset Password Link

By default, the Login page for the RDC application does not include the Reset Password link.

You can:

• Choose to show the Reset Password link on the Login page
• Specify a URL for your own reset password page or use the RDC Onsite Reset Password utility

For more information, see:

• Requirements for Using the RDC Onsite Reset Password Utility
  
• Resetting versus Changing Passwords
  
• Configuring the Reset Password Link
  

Requirements for Using the RDC Onsite Reset Password Utility

The RDC Onsite Reset Password utility uses functionality in the Oracle Thesaurus Management System (TMS). Therefore, to make use of the reset password utility:

• TMS must be installed, either on the RDC application server or on another accessible server.
• The TMS user IDs must match the RDC user IDs.
• Email addresses for all RDC users must be specified in TMS using the TMS user interface. If users click the Reset Password link and their user IDs and e-mail addresses are not specified in TMS, the process fails and RDC displays an error message.

For more information on creating user IDs and specifying e-mail addresses in TMS, see the Oracle Thesaurus Management System User's Guide.

Resetting versus Changing Passwords

If a user attempts to log in to RDC with a valid but expired password, RDC redirects the user to the Change Password page. The password can be changed strictly through the user interface, without e-mail or involvement of TMS.

See Changing the URL and the Name for the Change Password Link for more information.

Configuring the Reset Password Link

You use the RdcLogos.properties file to change the default settings for the Reset Password link.

To configure the Reset Password link:

1. Navigate to the OPA_CONFIG_FOLDER. The folder path is determined by the registry entry opa54, found under HKEY_LOCAL_MACHINE > Software > Oracle, for example:

   C:\opapps54\config

2. Open the RdcLogos.properties file with a text editor.
3. Find the following line in the file and set the value to true to display the Reset Password link on the Login page:

   image.ResetPasswordUrlRendered=true

4. Specify the Reset Password page that displays when the user clicks the Reset Password link. You can specify your custom Reset Password page or you can use the RDC Onsite Reset Password page.
   • To specify your custom page, find the following line in the file and set the value to the URL for your Reset Password page:

     image.ResetPasswordUrl=Custom_URL

   • The RDC Onsite Reset Password page requests the username and then sends a new password by email to their registered email address. By default, the link for this page is not enabled. You can enable the link to this page and configure the email functionality. To use the RDC Onsite Reset Password page:
     1. Make sure the following line is not set to a value:

        image.ResetPasswordUrl=

     2. Verify that the following value is set as indicated below:

        image.ResetPasswordUrlRendered=true

     3. Adjust for an SSL or non-SSL authentication:

        If the email server uses SSL authentication, set values as follows:

        resetPassword.email.smtp.auth=true

        resetPassword.email.smtp.socketFactory.class=javax.net.ssl.SSLSocketFactory

        If the email server does not use SSL authentication, set values as below:

        resetPassword.email.smtp.auth=false

        resetPassword.email.smtp.socketFactory.class=

     4. Set the values for the below parameters:

        resetPassword.email.smtp.host: Set to the name of the SMTP host that is set up to send emails.

        resetPassword.email.from: Set to the sender name to be displayed on sent emails.

        resetPassword.email.username: Set to the email account on the SMTP host that is used to send the email.

        resetPassword.email.password: Set to the password for the email account that is sending the email messages. Leave this parameter blank if the password is not required by the server.

        resetPassword.email.smtp.port: Set to the port used by the SMTP server. Common values are 465 for SSL-enabled servers, or 25 for non-SSL servers.

     5. You can customize the messages of the SMTP host for password changes. The message parameter and default values are listed below.

        resetPassword.email.message.subject: The default text is Reset Password Request for {0}, where {0} is replaced by the username for which the password is reset.

        resetPassword.email.message.body: The default text is This message confirms that your password has been reset. The new password for user {0}, database {1} is: {2}, where {0} is replaced by the username for which the password is reset, {1} is replaced by the name of the database, and {2} is replaced by the new password.

        resetPassword.error.failed.text: The default text is Failed to reset password. Please contact your help desk.

        resetPassword.error.nousername.text: The default text is Please provide a valid username.

        resetPassword.error.failedemail.text: The default text is Your Password has been reset, however the e-mail notification failed to launch. Please contact your system administrator.

        resetPassword.confirm.text: The default text is Your Password has been reset. Please check your e-mail for the new password.

5. Save your changes.
6. Restart the OPA server.

   For details, see Restarting the OPA Server.