Setting Up the Sample Webapp

To obtain and configure the Playground sample, follow the steps below.

1. You can check out the repository of the OAuth 2.0 sample from GitHub. Follow the instructions here to checkout the folder. We refer <SAMPLE_HOME> as the modules/samples folder inside the folder where the product-is repository is checked out.

   https://github.com/wso2/product-is/tree/v5.1.0/modules/samples/oauth2/playground2

2. In your command line, navigate to <SAMPLE_HOME>/oauth2/playground2 in the folder you checked out and build the sample using the following command. You must have Apache Maven installed to do this (see Installation Prerequisites for the appropriate version to use).

   mvn clean install

3. After successfully building the sample, a .war file named playground2 can be found inside the <SAMPLE_HOME>/oauth2/playground2/target folder. Deploy this sample web app on a web container. To do this, use the Apache Tomcat server.

   Since this sample is written based on Servlet 3.0 it needs to be deployed on Tomcat 7.x.

   Use the following steps to deploy the web app in the web container:

   1. Stop the Apache Tomcat server if it is already running.
   2. Copy the playground2.war file to the <TOMCAT_HOME>/webapps folder.
   3. Start the Apache Tomcat server.

4. Make sure to update param-value the following parameter in the WEB-INF/web.xml file with the server url of the Identity Server if required.

   <init-param>
        <description>serverUrl</description>
        <param-name>serverUrl</param-name>
        <param-value>https://localhost:9443/services/</param-value>
   </init-param>

   Note that localhost is the server that hosts WSO2 Identity Server and 9443 is the default SSL port of it.

5. Update param-value of below parameters with credentials of an admin user if required.

   <init-param>
        <description>userName</description>
        <param-name>userName</param-name>
        <param-value>admin</param-value>
   </init-param>
   <init-param>
        <description>password</description>
        <param-name>password</param-name>
        <param-value>admin</param-value>
   </init-param>

6. Restart Apache Tomcat and access http://localhost:8080/playground2/ (assuming Tomcat is running on HTTP port 8080). You are directed to the landing page of the sample application. Click on Import Photos and the following page appears.
   

This application is used to request access tokens using the four OAuth2 grant types.