Installatie

Als de toepassing wordt gestart en er is geen Trust1Connector geïnstalleerd, wordt de volgende lay-out weergegeven:

Op de start pagina kan de gebruiker de Trust1Connector downloaden of zien welke versie momenteel is geïnstalleerd.

Hoewel de connector kan bepalen op welk besturingssysteem de browser wordt uitgevoerd, toont de pagina alle mogelijke downloads.

Beschikbare installers zijn er voor:

• Windows 32/64 bit (LTS)

• Mac Intel/ARM (LTS)

• Linux (Ubuntu/Debian of andere op aanvraag)

Na het downloaden kan het ondertekende pakket op je systeem worden geïnstalleerd. De connector is zo gemaakt dat hij weinig ruimte in beslag neemt. Na een succesvolle installatie moet de pagina worden herladen (ververst). De applicatie is gebouwd om expliciet opvragen van lezers voorafgaand aan de installatie te vermijden.

De installatiewizard wordt gestart wanneer het gedownloade installatieprogramma wordt uitgevoerd:

Gebruiker's Toestemming

Na een succesvolle installatie en wanneer de pagina wordt vernieuwd, wordt de gebruiker om toestemming (consent) gevraagd. De toestemming is nodig om toegang te krijgen tot kaartlezers op het apparaat van de gebruiker.

Als u toestemming geeft, verdwijnt de vorige pagina en wordt er een nieuwe pagina geladen, waarop wordt gezocht naar beschikbare kaartlezers. Het volgende scherm toont het resultaat als er geen kaartlezers aanwezig zijn:

Overzicht

De beheerpagina haalt de volgende secties op:

• apparaat informatie

• gebruikers informatie

• status van gebruikte services

Apparaat Informatie

Gebruikers Informatie

Status van afhankelijke Services

Check the depending services used by the application

Kaartlezers

When one or more readers are connected to the device, the application will display an overview with basic card reader or physical token information.

The table informs about the following reader semantics:

Kaart ATR

De kaart ATR (ref: https://en.wikipedia.org/wiki/Answer_to_reset - Answer-To-Reset) wordt gebruikt om het smartcard schema te bepalen dat kan worden gebruikt met de Trust1Connector.

Als een kaart onbekend is voor de connector, kan een module worden voorgesteld. Dit zal een override activeren voor het geselecteerde token. De connector zal de juiste module laden om de kaartinformatie te parsen en de use cases uit te voeren met behulp van de geselecteerde module.

Vanaf de lezerspagina, wanneer een token is gedetecteerd en herkend, kan een 'select'-knop worden gebruikt om alle bekende informatie van het geselecteerde token te dumpen:

Biometrische informatie

Het eerste deel van de 'Kaart Details Pagina' toont een visuele weergave van de kaart, dit bevat de 'biometrische' informatie van een kaart. Merk op dat deze informatie kan worden opgevraagd wanneer:

• de smartcard of het token een aangepaste toepassing heeft die deze informatie vrijgeeft

• de smartcard of het token beschikt over basisgebruikersinformatie in de certificaten op het token

Het tweede deel bevat specifieke gegevens voor het geselecteerde token en kan variëren afhankelijk van het gebruikte schema. In het gegeven voorbeeld is het adres niet beschikbaar in de kaartcertificaten, maar wordt het rechtstreeks uitgelezen uit de Belgische eID-toepassing. Aangezien deze functie niet door alle tokens wordt ondersteund, is het mogelijk dat het adres niet wordt gevisualiseerd.

Certificaten

De volgende sectie toont alle beschikbare certificaten van het token

Certificaat Details

De certificaatgegevens voeren een certificeringsvalidatieproces uit. Dit wordt gedaan met behulp van de Trust1Connector Validation Service, een service die wordt gehost door Trust1Team.

De service voert alle benodigde validaties uit en retourneert een 'kleurcode' vergezeld van een korte beschrijving van het antwoord dat door de validatieservice is verkregen.

Het voorbeeld, met de testkaart, toont een waarschuwing (omdat dit een testkaart is):

When selecting the option 'Show Details', a short summary of the validation feedback can be obtianed:

Als dezelfde stroom wordt uitgevoerd met een geldige kaart, is het resultaat als volgt:

Certificaat Types

De verkregen certificaten zijn in binair base64-formaat. Toekomstige versies van ReadMyCards zullen het verkregen certificaat ontleden en de resulterende certificaateigenschappen in een leesbaar formaat weergeven. De volgende certificaattypes worden gebruikt door de connector:

Hoof Menu

Het linkermenu toont de mogelijkheden van ReadMyCards:

Applicatie Instellingen

Rechtsboven wordt het instellingenmenu weergegeven als een 'tandwiel'. Wanneer u hierop klikt, zijn de volgende opties beschikbaar:

Applicatie Versie

De ReadMyCards applicatie volgt een ander semantisch versiebeleid dan de Trust1Connector. De applicatieversie wordt linksboven onder het logo weergegeven:

Referenties

Ga voor meer diepgaande details over de technische stroom voor PIN-validatie naar:

Introductie

Een gebruikersauthenticatie kan worden uitgevoerd vanuit de ReadMyCards toepassing. Onderaan de pagina zijn er 3 use cases beschikbaar:

• verifieer gebruiker met browser OF besturingssysteem pin dialoog

• een PDF-document uploaden als voorwaarde voor het uitvoeren van een digitale handtekening

• een PDF-document digitaal ondertekenen

Pin Dialoog

De Trust1Connector vraagt de gebruiker om een PIN bij het uitvoeren van een authenticatie of een digitale handtekening. Wanneer een gebruiker de PIN in een browserdialoogvenster invoert, heeft de Trust1Connector de nodige functies in de SDK om de PIN te versleutelen die vanuit de browser naar de Trust1Connector instantie wordt verzonden. De redenering achter deze aanpak is:

• de Trust1Connector vertrouwt NIET de lokale browser: de browser kan bijvoorbeeld corrupt zijn met een 'malafide' plugin;

• er zal geen pincode zichtbaar zijn in de 'debug console' van de browser applicaties, behalve bij het presenteren van een geldig token en bij het uitvoeren van een sleuteluitwisseling voorafgaand aan het gebruik van de connector

Als u de optie 'Pin-dialoog besturingssysteem gebruiken' inschakelt, vraagt u om het invoeren van de pincode in de browser te negeren door het invoeren van de pincode te delegeren aan het besturingssysteem.

Als deze optie is ingeschakeld, zal de Trust1Connector het onderliggende besturingssysteem vragen om de PIN-invoer af te handelen.

Dit betekent dat de PIN-invoer VOLLEDIG gescheiden is van de webtoepassing of browser.

Als de use case succesvol is afgerond, verschijnt rechtsboven korte tijd het volgende bericht:

Functionaliteiten

Als u het menu 'File Explorer' selecteert, verschijnt het volgende scherm:

De Bestandsverkenner contextualiseert het toewijzen van mappen op basis van de verbonden toepassing (virtueel gedaan met behulp van een toepassingsidentificatie).

Elke toepassing kan een of meer 'entiteiten' hebben. De voorbeeldentiteit die in deze toepassing wordt gebruikt, heet 'RMC'. Je kunt meer applicatie-entiteiten definiëren met behulp van de Trust1Connector.

Voor de voorbeeldtoepassing is er één voorgedefinieerd.

Binnen een Entiteit kunnen een of meer mapkoppelingen worden gedefinieerd, dit wordt een 'Type' mapping genoemd.

Het komt erop neer dat je een virtuele naam aanmaakt en deze koppelt aan een bestaande map op je lokale apparaat. Selecteer de knop 'Type aanmaken en locatie toewijzen':

Na het definiëren van de naam verschijnt er een bestandskiezer van de Trust1Connector, nu kun je een map aanmaken en selecteren. De map wordt gekoppeld aan het 'type', wat betekent dat alle bestanden in de map beschikbaar worden voor de webapplicatie. Hiervoor is toestemming van de gebruiker nodig:

Het resultaat van het aanmaken en toewijzen van bestanden wordt weergegeven in het hoofdapplicatieoverzicht:

Referenties

Ga voor meer diepgaande details over de technische stroom voor PIN-validatie naar:

Introductie

Een gebruiker kan een document digitaal ondertekenen met ReadMyCard.

Onderaan de pagina zijn 3 use cases beschikbaar:

• gebruiker authenticeren met browser OF besturingssysteem pin dialoog

• een PDF-document opladen als voorwaarde voor het uitvoeren van een digitale handtekening

• een PDF-document digitaal ondertekenen

Pin Dialoog

De Trust1Connector vraagt de gebruiker om een PIN bij het uitvoeren van een authenticatie of een digitale handtekening. Wanneer een gebruiker de PIN in een browserdialoogvenster invoert, heeft de Trust1Connector de nodige functies in de SDK om de PIN te versleutelen die vanuit de browser naar de Trust1Connector instantie wordt verzonden. De redenering achter deze aanpak is:

• de Trust1Connector vertrouwt NIET de lokale browser: de browser kan bijvoorbeeld corrupt zijn met een 'malafide' plugin;

• er zal geen pincode zichtbaar zijn in de 'debug console' van de browser applicaties, behalve bij het presenteren van een geldig token en bij het uitvoeren van een sleuteluitwisseling voorafgaand aan het gebruik van de connector

Als u de optie 'Pin-dialoog besturingssysteem gebruiken' inschakelt, vraagt u om het invoeren van de pincode in de browser te negeren door het invoeren van de pincode te delegeren aan het besturingssysteem. Als deze optie is ingeschakeld, zal de Trust1Connector het onderliggende besturingssysteem vragen om de PIN-invoer af te handelen. Dit betekent dat de PIN-invoer VOLLEDIG gescheiden is van de webtoepassing of browser.

Als de use case succesvol is afgerond, verschijnt rechtsboven korte tijd het volgende bericht:

Digitale Handtekening

Met de ReadMyCard toepassing kan een gebruiker een PDF-document ondertekenen met behulp van het baseline PAdES-LTV profiel (Long Term Validation). Dit is het formaat voor langlevende handtekeningen. Met dit profiel kunt u de geldigheid van handtekeningen in PDF-formaat onbeperkt verlengen. Het kan gebruikt worden in combinatie met andere PAdEs profielen. Dit profiel wordt gebruikt om validatie te garanderen vele jaren nadat de handtekening is voltooid. Het garandeert validatie op lange termijn.

U kunt beginnen met het uploaden van een PDF-document door de 'file-drop'-zone te selecteren of door een bestand naar de 'file-drop'-zone te slepen.

Zodra een bestand is geüpload, verschijnt de bestandsnaam in de dropzone.

Start de handtekeningstroom met 'Onderteken geüpload document':

Als de flow succesvol is voltooid, wordt het volgende pop-upvenster weergegeven:

Vanuit de pop-up kun je:

• het ondertekende PDF-document downloaden (via de downloadlink)

• de pop-up sluiten en teruggaan naar het vorige scherm

Het openen van het document in Adobe Acrobat Reader demonstreert de toepassing van de digitale handtekening.

Door de details van de handtekening te openen, kunnen de eigenschappen van de handtekening worden gecontroleerd:

De webtoepassing ReadMyCards is een voorbeeld implementatie van de Trust1Connector. De applicatie faciliteert de volgende use cases:

• Visualiseer beschikbare smartcard lezers en fysieke tokens

• Ophalen van certificaten, certificaat lijsten

• Visualiseren van smartcards en fysieke tokens personalisatie-informatie

• Verificatie van gebruikers

• Een PDF-document digitaal ondertekenen

• Inhoud afdrukken naar beschikbare printers

• Lokale bestandstoewijzing voor uploaden, downloaden en synchroniseren van bestanden

ReadMyCards is beschikbaar op: https://rmc.t1t.io/

Dit document beschrijft de beschikbare functionaliteiten voor ReadMyCards en hoe dit waardevol kan zijn voor partners en eindgebruikers.

Introductie

Met de bestandsuitwisselingscontainer kan Trust1Connector bestanden en mappen beheren en bestanden uploaden naar of downloaden van het bestandssysteem van of naar de aanvragende partij (vooral voor webtoepassingen).

De gebruiker van het apparaat moet toestemming geven voor bestandsoperaties. De File Explorer biedt een gecontroleerde en beveiligde abstractie voor bestandsoperaties.

De Bestandsuitwisselingscontainer biedt de volgende functionaliteiten:

• selecteren van een map op basis van applicatietype

• bestanden in het geselecteerde toepassingstype weergeven

• een of meer bestanden downloaden naar het geselecteerde applicatietype

• een of meer bestanden uploaden vanuit het geselecteerde applicatietype

• submappen maken in 'gemapte' mappen (toepassingstypes)

De Trust1Connector staat NIET toe dat mappen of bestanden op het apparaat van de gebruiker worden verwijderd.

Een applicatietype verwijst lokaal naar een absoluut bestandssysteempad. Een applicatie kan extra mappen maken voor een bepaald applicatietype, deze mappen zijn relatief ten opzichte van het absolute pad dat lokaal is toegewezen aan het applicatietype. Dit betekent dat de webtoepassing de gebruiker kan vragen om submappen aan te maken in een applicatietype dat al in kaart is gebracht.

De bestandsuitwisselingscontainer biedt bovendien

• optionele gebruikersmelding voor voltooiing van bestandsoverdracht

• bestanden kopiëren en verplaatsen tussen applicatietypes

• toestemming van de gebruiker om de consumerende applicatie bestandsbewerkingen te laten uitvoeren

• toepassing/domein scoped, toepassingstypen zijn gebonden aan het toepassingsdomein

• OS native bestands- en mappenkiezer dialogen

Folder Gerelateerde Functies

Voor een bestaand 'Type' (zie Overzicht) kun je een nieuwe map aanmaken in de hoofdmap:

Bestand Opladen

Een bestand kan worden geüpload naar de webapplicatie vanaf het lokale apparaat.

Na het selecteren en bevestigen van de bestandsupload wordt het bestand weergegeven in het applicatieoverzicht

Als een bestand is geselecteerd, zijn er extra opties beschikbaar:

• bestand downloaden

• bestand afdrukken

• bestand hernoemen

• bestand verplaatsen

• bestand kopiëren

Bestand Downloaden

De betekenis van 'Bestand downloaden' is vanuit het perspectief van het lokale apparaat - aka - het lokale apparaat downloadt een bestand vanuit de webapplicatie (uploaden en downloaden MOET worden gezien vanuit het perspectief van het lokale apparaat).

Bij het downloaden van een bestand kan de gebruiker dit natuurlijk in elke systeemmap doen.

Bestand Printen

De Trust1Connector heeft een printermodule ingeschakeld, wat betekent dat een printer (beschikbaar op het besturingssysteem) kan worden geselecteerd en geactiveerd voor een afdruktaak.

Bestand Hernoemen

Hernoem een bestand vanuit de webapplicatie zoals dat het geval zou zijn op het lokale besturingssysteem.

Bestand Verplaatsen

Verplaats een bestand vanuit de webapplicatie zoals het geval zou zijn met het lokale besturingssysteem, maar met de extra beperking dat dit alleen kan worden gedaan tussen toegankelijke mappen, of binnen dezelfde map. Het verplaatsen van bestanden naar ontoegankelijke mappen is niet toegestaan en zal worden verhinderd door de Trust1Connector.

Bestand Kopieren

Kopieer een bestand vanuit de webapplicatie zoals het geval zou zijn vanuit het lokale besturingssysteem, maar met de extra beperking dat dit alleen kan tussen toegankelijke mappen, of binnen dezelfde map. Het kopiëren van bestanden naar ontoegankelijke mappen is niet toegestaan en zal worden verhinderd door de Trust1Connector.