De simulatie op je eigen computer

De kijkdemo laat zien hoe de dataspace eruitziet, maar je kunt er niets veranderen. Wil je zelf een product aanbieden, een aanvraag goedkeuren, een app koppelen of een nieuwe organisatie aanmelden, start dan de simulatie op je eigen computer. Je krijgt dezelfde dataspace als in de kijkdemo: een Trust Authority, zeven organisaties met elk een eigen connector, gesimuleerde gebouwbeheersystemen en apps, en een achtste organisatie die zich nog moet aanmelden. Je bent overal beheerder.

Wat je nodig hebt

• Docker met compose: Docker Desktop op macOS en Windows, Docker Engine op Linux.
• Ongeveer 2 GB vrij geheugen voor de simulatie. Geef Docker Desktop minstens 4 GB.
• Ongeveer 3 GB schijfruimte voor de images.
• Poort 80 vrij, of kies een andere poort met --port.

Macs met Apple Silicon worden ondersteund. Op Windows is de simulatie nog niet getest.

Starten

1. Installeer de command line tool bl. Op macOS en Linux:

   curl -fsSL https://github.com/buildinglinks/cli/releases/latest/download/bl-installer.sh | sh

   Op Windows, in PowerShell:

   powershell -c "irm https://github.com/buildinglinks/cli/releases/latest/download/bl-installer.ps1 | iex"

   Open een nieuwe terminal en controleer de installatie:

   bl --version

2. Start de simulatie:

   bl sim start

   De eerste keer haalt Docker de images op. Daarna richt bl de dataspace in: de organisaties melden zich aan bij de Trust Authority, bieden hun gebouwdata aan en sluiten overeenkomsten. Reken op vijf tot tien minuten. bl sluit af met een overzicht van alle adressen.

3. Open http://localhost. Daar staat wat er draait, wie er meedoet, hoe je inlogt en een looproute langs de belangrijkste onderdelen.

Inloggen

Elke connector en de Trust Authority heeft een eigen inlogomgeving, zoals een echte organisatie een eigen identity provider heeft. Lokaal werken in elk daarvan dezelfde drie accounts:

Gebruiker	Wachtwoord	Mag
admin	admin	alles, ook instellingen en sleutels
operator	operator	aanbieden, aanvragen, beoordelen en het verzoekenlog instellen; verder geen instellingen
viewer	viewer	alleen kijken

Elke organisatie heeft een eigen adres, zoals http://sensortrust.localhost. Je kunt dus in één browser tegelijk bij meerdere organisaties ingelogd zijn, en zien hoe een aanvraag bij de ene organisatie een besluit bij de andere wordt.

Opgepast

De simulatie gebruikt vaste wachtwoorden en is bedoeld voor je eigen computer. Zet haar niet zonder eigen wachtwoord op internet; zie bl sim start --help voor --password.

Wat je kunt doen

Op http://localhost staat een looproute met stappen die je zelf uitvoert. Een paar voorbeelden van wat lokaal wel kan en in de kijkdemo niet:

• Als dataontvanger een product aanvragen onder Data zoeken, en het als rechthebbende goedkeuren onder Aanvragen.
• Een app aanmaken onder Apps, er een sleutel voor krijgen en daarmee de gateway aanroepen.
• De nieuwe connector aanmelden bij de Trust Authority, met een (gesimuleerde) gekwalificeerde handtekening.
• Een organisatie schorsen in de Trust Authority en zien hoe haar leveringen stoppen.

Stoppen en opnieuw beginnen

bl sim status    # wat er draait, de adressen en de inloggegevens
bl sim stop      # stoppen; de data blijft bewaard
bl sim reset     # alles terug naar het begin

bl sim start gaat verder waar je was. Alle commando’s en opties staan in de naslag van bl, of met bl --help.