adrianpohey / myinfo-demo-app

[PUBLIC] Demo client application for integrating with MyInfo

MyInfo Demo App

This is a demo application meant to illustrate how to integrate your application with MyInfo APIs

Changelog

20 Mar 2019:

• updated demo application for MyInfo v3 APIs which are to be released in April 2019

MyInfo Demo App Setup

1.1 Install Node and NPM

In order for the demo application to run, you will need to install Node and NPM.

Follow the instructions given by the links below depending on your OS.

• Install Node and NPM for Windows
• Install Node and NPM for Linux
• nstall Node and NPM for Mac

1.2 Run NPM install

Run the following command in the folder you unzipped the application:

npm install

1.3 Start the Application

For Linux/MacOS

Execute the following command to start the application:

  ./start.sh

For Windows

Execute the following command to start the application:

  .\start.bat

Access the Application on Your Browser You should be able to access the sample application via the following URL:

http://localhost:3001

---

Login with SingPass

Use this test ID and password to login to SingPass:

NRIC: S9812381D Password: MyInfo2o15

---

Enable PKI Digital Signature

Note:
As of version 2.2.0 of our API specifications, the URLs of the APIs have changed. Please note the different configurations accordingly.

v3 APIs (LATEST)

For Linux/MacOS

Edit the start.sh. Look for SANDBOX ENVIRONMENT, Comment out these configurations,

# SANDBOX ENVIRONMENT (no PKI digital signature)
# export AUTH_LEVEL=L0
# export MYINFO_API_AUTHORISE='https://sandbox.api.myinfo.gov.sg/com/v3/authorise'
# export MYINFO_API_TOKEN='https://sandbox.api.myinfo.gov.sg/com/v3/token'
# export MYINFO_API_PERSON='https://sandbox.api.myinfo.gov.sg/com/v3/person'

Look for TEST ENVIRONMENT, uncomment these configurations,

# TEST ENVIRONMENT (with PKI digital signature)
export AUTH_LEVEL=L2
export MYINFO_API_AUTHORISE='https://test.api.myinfo.gov.sg/com/v3/authorise'
export MYINFO_API_TOKEN='https://test.api.myinfo.gov.sg/com/v3/token'
export MYINFO_API_PERSON='https://test.api.myinfo.gov.sg/com/v3/person'

Execute the following command to start the application:

  ./start.sh

For Windows

Edit the start.bat. Look for SANDBOX ENVIRONMENT, comment out these configurations,

rem SANDBOX ENVIRONMENT (no PKI digital signature)
rem set AUTH_LEVEL=L0
rem set MYINFO_API_AUTHORISE=https://sandbox.api.myinfo.gov.sg/com/v3/authorise
rem set MYINFO_API_TOKEN=https://sandbox.api.myinfo.gov.sg/com/v3/token
rem set MYINFO_API_PERSON=https://sandbox.api.myinfo.gov.sg/com/v3/person

Look for TEST ENVIRONMENT, uncomment these configurations,

rem TEST ENVIRONMENT (with PKI digital signature)
set AUTH_LEVEL=L2
set MYINFO_API_AUTHORISE=https://test.api.myinfo.gov.sg/com/v3/authorise
set MYINFO_API_TOKEN=https://test.api.myinfo.gov.sg/com/v3/token
set MYINFO_API_PERSON=https://test.api.myinfo.gov.sg/com/v3/person

Execute the following command to start the application:

  .\start.bat

---

Reporting issues

You may contact [email protected] for any other technical issues, and we will respond to you within 5 working days.