Local Development environment

Setup local development environment

Follow the Get started tutorial to setup your local development environment.

Postman configuration settings

In each microservice there is authentication. This makes testing the endpoints often difficult as you need to be authenticated. To make it easier to develop we will guide you in setting up your postman configuration.

To make this easier we've made an Postman collection with all the authorization options you need. The only thing the developer has to do is click the 'generate new token' button within Postman to generate a new token.

The collection contains a few default requests, but not for every endpoint.

Setup postman

1. Install postman if you haven't already.
2. Download the ACI-Rental Postman Collection.

Generating new access token

❗ Make sure you've imported the collection

⚠️ You need to make sure you've setup keycloak properly. Follow the steps here to do so

📝 We are assuming you are running the docker-compose file as explained here

1. Click on the 'ACI-Rental' collection

2. Click on authorization

3. At the bottom click on Get new Access token

4. In the prompt click on surfconext

5. Navigae to SurfConext Test Idp and click on it

6. Login wih credentials staff1 staff1

7. Click 'Use Token' in the popup

Now you can make authenticated requests.