This project provides a full implementation example of how Discipl components can be used to issue and verify claims. In particular, how municipalities can issue
In order to make everything functional, we need to generate valid certificates for demo NLX environments and
ensure that the validation app can retrieve those. This is only needed for working with live NLX, when using docker-compose-travis.yml, these certificates are not needed.
- Generate certificates as described here, and place the
org.keyandorg.crtfiles at./mock-nlx/certs/
The easiest way to run is using docker-compose:
This will start 3 applications:
- clerk-frontend
- waardepapieren-service, with embedded ephemeral-server
- nlx-mock, which is an nlx-outway that provides access to a mock BRP service
This is done as follows:
- Set the environment variable CERT_HOST_IP is with an IP (or domain) that the validator app can use to reach the clerk-frontend container. Ensure that the validator app runs on the same (wifi) network as the clerk frontend.
- Run
docker-compose up
Alternatively, you can use an offline mock, which replicates the NLX environment.
- Run
docker-compose -f docker-compose-travis.yml up
The clerk frontend will be available at https://localhost:443
The validator app is made with Expo, which is a free and open-source react-native framework for mobile development. to run this on a mobile device, the expo-cli tool is required. to install this, run:
$npm install -g expo-cliconnect to the same network without firewall restrictions (if all else fails, starting an hotspot on your mobile device and connecting to it usually works). In the folder "validator-frontend", issue the command:
$expo startwait till the program has fully loaded and scan the QR code in the left bottom corner, with the Expo-app for Android or IOS.
Dit document heeft als doel om zowel het ontwikkelteam als de gemeente een duidelijk beeld te geven van de applicatie, middels een volledig implementatievoorbeeld van hoe Discipl-componenten kunnen worden gebruikt om claims af te geven en te verifiëren. In het bijzonder, hoe gemeenten die kunnen uitgeven. .
Architectuur en Hardware Om waardepapieren op te zetten gaan we in onze situatie een Docker instantie draaien. Deze Docker instantie zal in dit geval moeten draaien op een server bij de gemeente of in de cloud (Azure) De innovatie-proeftuin https://zuidugchelen.eu (macOS sierra) biedt de mogeljkheid om laagdrempelig nieuwe innovatieve ideeen uit te proberen.
- gemeentelijk ambtenaar klikt op https://zuidugchelen.eu en opent de clerk-frontend
- Systeem laat hoofdscherm zien.
- gemeentelijk abmtenaar tikt magisch nummer in. (BSN=663678651)
gemeenteambtenaar klikt op volgende
- Systeem laat doelbinding zien
gemeentelijk ambtenaar klikt op volgende
- Systeem laat detailpagina zien van de ingevoerde BSN
(nb op IOS mobile (iphone/ipad) gebeurt dit nog niet ) gemeenteambtenaar klikt op dit klopt!
- systeem laat uittreksel zien
- Gemeentelijk ambtenaar klikt op download
- Systeem laat downloadscherm zien
- Burger
koppeltqr-code aan Wallet of neemt printje mee, gemeentelijk ambtenaar klikt op afronden
nb download apple-wallet werkt nog niet
- Systeem laat weer het hoofdscherm zien.
Serving needs
Er is nu een automatisch gegenereerd document en daarom niet ondertekend.
De gegevens zijn verkregen via NLX en geborgd in de QR code. De validatie_app is bedoeld om de echtheid te controleren .
Met een standaard qr lezer kan bovenstaande QR code worden gescand, en de JSON code zichtbaar worden gemaakt.
JSON is een internetcommunicatiestandaard vanwege de eenvoudige integratie met JavaScript en het flexibele formaat, maar vereist codering om toegang te krijgen tot de gegevens in een JSON-document. Met Expo kunnen webontwikkelaars echt native apps bouwen die zowel op iOS als Android werken door ze èènmaal in JavaScript te schrijven.
https://apps.apple.com/nl/app/expo-client/id982107779
Scan [ ] nogmaals de QR code
