To obtain and configure the Playground sample, follow the steps below.
You can check out the samples repository from GitHub. Follow the instructions here to checkout the folder.
is-samples/modules/samplesdirectory is referred to as
<IS_SAMPLES>throughout this guide.
Open a terminal window and add the following entry to the
/etc/hostsfile of your machine to configure the hostname.
Why is this step needed?
Some browsers do not allow you to create cookies for a naked hostname, such as
localhost. Cookies are required when working with SSO. Therefore, to ensure that the SSO capabilities work as expected in this tutorial, you need to configure the
etc/hostfile as explained in this step.
etc/hostfile is a read-only file. Therefore, you won't be able to edit it by opening the file via a text editor. To avoid this, edit the file using the terminal commands.
For example, use the following command if you are working on a Mac/Linux environment.
In your command line, navigate to
<SAMPLE_HOME>/oauth2/playground2directory 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).
After successfully building the sample, a .
warfile named playground2 can be found inside the
<SAMPLE_HOME>/oauth2/playground2/targetfolder. Deploy this sample web app on a web container, such as 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:
- Stop the Apache Tomcat server if it is already running.
- Copy the
playground2.warfile to the
- Start the Apache Tomcat server.
Make sure to update the
param-valueparameter in the
WEB-INF/web.xmlfile with the server URL of the Identity Server if required.
Make sure to enter the port the application is running on, in the URL. If you have started the Identity Serve with a port offset, then the respective port needs to be configured here.
localhostis the server the default WSO2 Identity Server host and
9443is the default SSL port. In order to access the admin services you need have the values in step 5 and 6. Since playground application is accessing the admin service OAuth2TokenValidationService, you should have the correct serverUrl,username and password as described in step 5 and 6.
Update param-value parameters below with credentials of an admin user if required.
Restart Apache Tomcat and access
http://wso2is.local:8080/playground2/By default Tomcat runs on port 8080. If you have configured it to run on a different port make sure to update the URL and access the playground application.
You are directed to the landing page of the sample application. Click on Import Photos and the following page appears.
Are you getting the error that is given below?
The sample applications do not have a keystore in them. Therefore, after changing the tomcat hostname you might get this error because the public key of the WSO2 Identity Server does not exist in the Java certificate store. For more information on the steps you need to follow to overcome the error, see FAQ.
This application is used to request access tokens using the four OAuth2 grant types: