Page History

This topic lists out the steps required to configure and run the password recovery sample web application with the WSO2 Identity Server.

...

1. Do the following configuration changes to the <SAMPLE_HOME>/src/main/webapp/WEB-INF/web.xml file.

   1. Specify the carbonServerUrl as the URL of the Identity Server. The following is an example.

      Code Block
      language xml
      <context-param> <param-name>carbonServerUrl</param-name> <param-value>https://localhost:9443/</param-value> </context-param>

   2. Specify the credentials to access Identity Server with admin privileges for accessUsername and accessPassword. The following is an example with the default WSO2 Identity Server credentials used.
      

      Code Block
      language xml
      <context-param> <param-name>accessUsername</param-name> <param-value>admin</param-value> </context-param> <context-param> <param-name>accessPassword</param-name> <param-value>admin</param-value> </context-param>

   3. Specify the trustStore absolute resource path for trustStorePath. The following example specifies the path to wso2carbon.jks of the Identity Server.

      Code Block
      language xml
      <context-param> <param-name>trustStorePath</param-name> <param-value>[IS_HOME]/repository/resources/security/wso2carbon.jks</param-value> </context-param>

2. If you are deploying the sample in Apache Tomcat, enable the SSL configuration in the <TOMCAT_HOME>/conf/server.xml file.

   Code Block
   language xml
   <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="150" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS" keystoreFile="/home/chamath/apps/wso2is-4.5.0-7.18.2-SNAPSHOT/repository/resources/security/wso2carbon.jks" keystorePass="wso2carbon" />

3. Configure the email confirmation links in the the <IS_HOME>/repository/conf/email/email-admin-config.xml file and the attributes in the <IS_HOME>/repository/conf/security/identity-mgt.properties file. The configurations you make in these files depend on what you want to achieve. The following configurations provide information on what needs to be configured based on your scenario.

   • Recovering accounts using notification or secret question - Refer to the topic on account recovery with notification for a sample email template and the attributes needed in the identity-mgt.properties file.

   • Self sign-up and account confirmation - Refer to the topic on Self Sign Up and Account Confirmation for a sample email template and the attributes needed in the identity-mgt.properties file.

To run the sample app you can either directly copy the InfoRecoverySample.war file in the target or build using mavenbuild the sample using Apache Maven.

Building the sample using Apache Maven

Before building the sample, ensure that the following dependencies are satisfied.

• org.wso2.carbon.identity.mgt.stub
• org.wso2.carbon.utils
• org.wso2.carbon.um.ws.api.stub
• org.wso2.carbon.identity.user.registration.stub
• org.apache.axis2.wso2
• org.apache.ws.commons.axiom.wso2

Also ensure  ensure that you have followed the instructions in the configuration steps above.

...