@@ -11,19 +11,35 @@ The source code for the Mock TPP is hosted on the [Open Banking Applications Exa
The Mock TPP is currently being improved by the conformance suite team, however, if you would like to contribute to developing this tool, feel free to raise any P.R. against the repository. Similarly, if you have any suggestions of improvement or if you experience any issues on executing the solution, please raise an issue at the [Conformance Suite Issues Page](https://gitlab.com/obb1/certification/-/issues)
# Quick Start - Running the Mock TPP
# Quick Start - Running the Mock TPP locally
The Mock TPP can be executed after downloading the source code presented above with the following steps
### First time set-up
(1) Add a local DNS entry in your hosts file:
- Open your hosts file and add a "tpp.localhost" in the same line as your 127.0.0.1 host - it should be added after the "localhost" file, like the picture below (example for a Mac):
**(1) Add a local DNS entry in your hosts file:**
To be able to successfully run the Mock TPP locally, you need to add a DNS entry to your localhost.
- Open your hosts file and add a "tpp.localhost" in the same line as your 127.0.0.1 host - it should be added after the "localhost" file.
For a MacOS, you can do this by:
```
1. Open a terminal
2. Type: sudo nano /private/etc/hosts
3. Enter your password
4. You should see your current hosts configuration. Scroll down with your keys until you reach the 127.0.0.1 part and go right just after the 'localhost'
5. Add 'tpp.localhost'
6. Press "Ctrl + O" to write and "Ctrl + X" to exit
```
In the end, it should look like the picture below (example for a Mac):
As the updated version for the Mock TPP is currently using Vue for the front-end, you'll have to run two npm install commands, one inside the tpp-views folder and one inside the tpp-payments-client folder
For the current Mock TPP version, we require that you install two package dependencies using npm, one inside the tpp-payments-client folder (the backend) and one inside the tpp-views (the frontend).
Open a terminal window and execute the following command inside the tpp-views (inside the tpp-payments-client) folder:
...
...
@@ -37,24 +53,30 @@ After that, go back to the tpp-payments-client folder and execute:
npm install
```
After it finished installing, run the command:
After it finished installing, you should be able to run the command:
```
npm run start
```
**This will execute a batch script that runs both the front-end and the backend together**
**If this is the first time executing:**
(3) After, open a browser window to <https://tpp.localhost> and your browser will prompt to ask if you trust this website - press yes.
(3) Open a Browser to <https://tpp.localhost> and your browser will prompt to ask if you trust this website - press yes
(4) Now close the window and open another window to <https://localhost:8080/> and you'll be able to select if you want to Customer Data or Payments
(4) Now close the window and open another window to <https://tpp.localhost:8080/> and you'll be able to select if you want to Customer Data or Payments
To help with the start we have also recorded a [Quick Start 4 Minutes video](https://youtu.be/VKLpds4e4uQ) showing the end-to-end process of executing the Mock TPP
### Executing the Mock TPP normally
If you've went through the previous setup before, you just need to run the following command inside the tpp-payments-client folder:
