End-user apps in WSO2 Identity Server

Branch	Build Status	Travis CI Status
master

1. Install NodeJS from https://nodejs.org/en/download/.
2. Install Maven from https://maven.apache.org/download.cgi. * For Maven 3.8 and up, please check the Troubleshoot section.
3. Install JDK 1.8 https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html.

1. Download or clone the project source code from https://github.com/wso2/identity-apps
2. Run mvn clean install from the command line in the project root directory (where the root pom.xml is located).

If you are building product-is, the built identity apps dependencies will install to your local .m2 repository during the build above.

3. Then you just need to build WSO2 Identity Server after. (Follow the guide there)

4. Execute wso2server.sh (For unix environment) or wso2server.bat (For windows environment) file from the bin directory to run the WSO2 Identity Server.
5. Navigate to https://localhost:9443/myaccount or https://localhost:9443/console from the browser. (Add certificate exception if required)

1. Do only if you skip WSO2 Identity Server build step above: Download the built distribution of WSO2 Identity Server from https://wso2.com/identity-and-access-management/.

2. Add the following code to repository/conf/deployment.toml in WSO2 Identity Server distribution pack to allow CORS.

   [cors]
   allowed_origins = [
      "https://localhost:9000",
      "https://localhost:9001"
   ]
   supported_methods = [
      "GET",
      "POST",
      "HEAD",
      "OPTIONS",
      "PUT",
      "PATCH",
      "HEAD",
      "DELETE",
      "PATCH"
   ]
   exposed_headers = [ "Location" ]

3. Add your hostname and port as a trusted FIDO2 origin to the deployment.toml file as given below.

    [fido.trusted]
    origins=["https://localhost:9000"]

4. Currently, Console & My Account are considered as system applications hence they are readonly by default. So in order to configure the Callback Urls as specified in step 7, you need to add the following config to the deployment.toml file to override the default behaviour.

   [system_applications]
   read_only_apps = []

5. Execute wso2server.sh (For unix environment) or wso2server.bat (For windows environment) file from the bin directory to run WSO2 Identity Server.

6. Navigate to https://localhost:9443/carbon/ from the browser, and login to the system by entering an admin password.

Hint! Can find out the default password details here: https://docs.wso2.com/display/ADMIN44x/Configuring+the+System+Administrator

7. In the system, navigate to Service Providers -> List from left side panel. And then go to Edit option in the application that you want to configure in dev mode (ex: MY_ACCOUNT). Then click on Inbound Authentication Configuration -> OAuth/OpenID Connect Configuration -> Edit. And then update the Callback Url field with below corresponding values.

   My Account

   regexp=(https://localhost:9443/myaccount/login|https://localhost:9443/myaccount/logout|https://localhost:9000/myaccount/login|https://localhost:9000/myaccount/logout)
   

   Console

   regexp=(https://localhost:9443/console/login|https://localhost:9443/console/logout|https://localhost:9001/console/login|https://localhost:9001/console/logout)
   

8. Open cloned or downloaded Identity Apps repo and run the following commands from the command line in the project root directory (where the package.json is located) to build all the packages with dependencies. (Note:- Not necessary if you have already done above identity apps build steps)

   # `npm run bootstrap` will install npm dependencies and bootstrap lerna modules.
   npm run bootstrap && npm run build

   or

   # This will run `npm run bootstrap && npm run build` in the background.
   npm run build:dev

   Note:-

   To build a single package/app, you can use this command: npx lerna bootstrap --scope <package-name> && npx lerna run --scope <package-name> build.

   E.g. npx lerna bootstrap --scope @wso2is/myaccount && npx lerna run --scope @wso2is/myaccount build

9. Start the apps in development mode, Execute cd apps/<app> && npm start command. E.g. cd apps/myaccount && npm start.

10. Once the app is successfully started, you can access the via the URLs https://localhost:9000/myaccount or https://localhost:9001/console.

Product Unit tests have been implemented using Jest along with React Testing Library and you can run the unit test suites using the following commands.

npm run test

npx lerna run test --scope @wso2is/forms

Product integration tests have been written using Cypress Testing Framework and you can run the test suites using the following command.

npm run test:integration

npm run test:integration:interactive

npm run test:integration:smoke

For more information regarding the test module, checkout the README in the tests module.

The portals i.e. Console & My Account are configurable using the deployment.toml when they are hosted inside the Identity Server. Read through our configurations guidelines to learn about the configuration process.

It is possible to deploy the Console and My Account applications on an external server. To do so, the following steps has to be followed in order to build the applications.

Follow the steps in listed here in-order to build the project with maven.

Once the build is complete, execute the following commands in-order to build the Console & My Account applications for external deployment.

Console

npx lerna run build:external --scope @wso2is/console

npx lerna run build:external:static --scope @wso2is/console

Once the build is completed, you can find the build artifacts inside the build folder i.e apps/console/build.

My Account

npx lerna run build:external --scope @wso2is/myaccount

npx lerna run build:external:static --scope @wso2is/myaccount

Once the build is completed, you can find the build artifacts inside the build folder i.e apps/myaccount/build.

You can simply use npm to build the Console and My Account applications for external deployment by just executing the following script.

# From project root
npm run build:external

# From project root
npm run build:external:static

The respective build artifacts could be found inside the build folder. (apps/(myaccount|console)/build)

• If you face any out of memory build failures, make sure that you have set maven options to set MAVEN_OPTS=-Xmx384M
• For Maven v3.8 up, add below configuration to the ~/.m2/settings.xml (Create a new file if the file exist)

  <settings>
    <mirrors>
      <mirror>
        <id>wso2-nexus-public</id>
        <mirrorOf>external:http:*</mirrorOf>
        <url>http://maven.wso2.org/nexus/content/groups/wso2-public/</url>
        <blocked>false</blocked>
      </mirror>
      <mirror>
        <id>wso2-nexus-release</id>
        <mirrorOf>external:http:*</mirrorOf>
        <url>http://maven.wso2.org/nexus/content/repositories/releases/</url>
        <blocked>false</blocked>
      </mirror>
      <mirror>
        <id>wso2-nexus-snapshots</id>
        <mirrorOf>external:http:*</mirrorOf>
        <url>http://maven.wso2.org/nexus/content/repositories/snapshots/</url>
        <blocked>false</blocked>
      </mirror>
    </mirrors>
  </settings>

Go through our contributing guideline to get an understanding about our contribution process and other necessary instructions.

We encourage you to report issues, improvements and feature requests regarding the project through GitHub Issue Tracker.

Important: And please be advised that, security issues must be reported to [email protected], not as GitHub issues, in order to reach proper audience. We strongly advise following the WSO2 Security Vulnerability Reporting Guidelines when reporting the security issues.

Licenses this source under the Apache License, Version 2.0 (LICENSE), You may not use this file except in compliance with the License.