Welcome to the claim service! This component provides a convenience style api for creating and validating claims based on the ICTU discipl project.
The service will first receive the data set linked to the provided person Uri. This has to be either a brp uri or "Haal Centraal" uri.
Based on the type specified in the post the claim service will then fill the claim with the required data from the person object.
It then provides the claim both as a JSON object and a JWT token.
It also generates a QR code in base64 format containing the claim.
We differentiate between two way's of installing this component, a local installation as part of the provided developers toolkit or an helm installation on an development or production environment.
First make sure you have docker desktop running on your computer. Then clone the repository to a directory on your local machine through a git command or git kraken (ui for git). If successful you can now navigate to the directory of your cloned repository in a command prompt and execute docker-compose up.
$ docker-compose up
This will build the docker image and run the used containers and when seeing the log from the php container: "NOTICE: ready to handle connections", u are ready to view the documentation at localhost on your preferred browser.
As a haven compliant commonground component this component is installable on kubernetes trough helm. The helm files can be found in the api/helm folder. For installing this component trough helm simply open your (still) favorite command line interface and run
$ helm install [name] ./api/helm --kubeconfig kubeconfig.yaml --namespace [name] --set settings.env=prod,settings.debug=0,settings.cache=1
For an in depth installation guide you can refer to the installation guide, it also contains a short tutorial on getting your cluster ready to expose your installation to the world
This component adheres to international, national and local standards (in that order), notable standards are:
You can find the data model, OAS documentation and other helpfull developers material like a postman collection under api/public/schema, development support is provided trough the samenorganiseren slack channel.
Couple of quick tips when you start developing
First of al please read the Contributing guideline's ;)
But most imporantly, welcome! We strife to keep an active community at commonground.nl, please drop by and tell is what you are thinking about so that we can help you along.
Information about the authors of this component can be found here
Copyright © Utrecht 2019