This documentation is for WSO2 Identity Server 5.0.0. View documentation for the latest release.
Recovering Account Information Using a Webapp - Identity Server 5.0.0 - WSO2 Documentation
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

This is a work in progress version of this topic.

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

Prerequisites

Configuring the sample

  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.

      <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.

      <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.

      <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.

    <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.

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

Running the sample by deploying the existing .war file

  1. Copy the InfoRecoverySample.war file that exists in SVN into the target folder to the <TOMCAT_HOME>/webapp folder.
  2. Start and stop the Apache Tomcat server.
  3. Configure tomcat as instructed above "Configuration" step.
  4. Start tomcat.
  5. Access the sample with URL - https://localhost:8443/InfoRecoverySample

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

Follow the instructions in the Configuration step above.

  1. Build the sample using Apache Maven by running the following command.

    mvn clean install

    When building the sample, the Java source code of the project is compiled into class files and packaged into .jar files. The dependencies listed in the project are located in bins so that Tomcat can find and load them.

  2. Copy the .war file that is generated to tomcat webapps.
  • No labels