Ga naar inhoud

Developers

Bouw digitale identiteit in.

Laat gebruikers inloggen met een wallet, vraag geverifieerde gegevens op of geef digitale verklaringen uit. Kies je integratie en werk verder vanuit de productdocumentatie.

Open de documentatieInloggen in Studio

Welke taak wil je koppelen?

Je configureert de flow in Studio. De Ver.iD Gateway begeleidt de gebruiker bij de walletinteractie. Je applicatie verwerkt het resultaat dat bij jouw taak hoort.

Inloggen met een wallet

Authenticatie via OpenID Connect, voor een login in je eigen applicatie.

Handleiding authenticatie

Ver.iD verzorgt

De walletinteractie en een ondertekend ID-token. Het afzonderlijke access-token geeft toegang tot UserInfo.

Jouw applicatie verzorgt

Gebruik een onderhouden OIDC-client met Authorization Code en PKCE. Valideer het ID-token voordat je een gebruikerssessie aanmaakt.

Gegevens opvragen

Een disclosure vraagt geselecteerde gegevens op, bijvoorbeeld voor onboarding. Het resultaat is geen logintoken.

Handleiding disclosures

Ver.iD verzorgt

De gegevensuitvraag, de ingestelde mapping en een ondertekend disclosure-resultaat.

Jouw applicatie verzorgt

Kies de browser-SDK voor een browserflow of de Node.js-SDK voor verwerking op je server. Controleer de callback en verifieer het resultaat voordat je gegevens gebruikt.

Digitale verklaringen uitgeven

Geef een digitale verklaring uit aan een wallet die voor jouw uitgifte is geconfigureerd.

Handleiding uitgifte

Ver.iD verzorgt

De vastgelegde structuur, de walletinteractie en een ondertekend uitgifteresultaat met een run-ID.

Jouw applicatie verzorgt

Valideer de waarden op je server en maak een issuance intent voor die uitgifte. Gebruik een vertrouwelijke serverclient en koppel het gecontroleerde resultaat aan je transactie.

Regel je toegang en configuratie.

Studio-toegang volgt na beoordeling en een uitnodiging. Een account geeft niet automatisch sandboxrechten of productie-toegang. Stem de omgeving, het gebruik en de voorwaarden af voor jouw toepassing.

Zo vraag je Studio-toegang aanEen voorstel op maat
Organisatie, domein en merk
Zorg voor toegang tot de juiste organisatie, een actief domein en een actief merk. Die bepalen waar het resultaat naartoe mag en welke organisatie de gebruiker ziet.
Een beschikbare wallet en flow
Kies een wallet die Studio voor jouw organisatie en taak aanbiedt. Testondersteuning is geen productieondersteuning. Zorg dat de wallet het gevraagde gegeven kan delen en activeer de flow.
Issuer, client-ID en redirect URI
Neem issuer URI en client-ID over uit Configuration van je actieve flow. Registreer de exacte redirect URI van je applicatie. De SDK ontdekt de bijbehorende endpoints via de issuer.
Geheimen en flowcontext
Houd client secrets op je server. Bewaar state en PKCE-context voor de callback; gebruik gedeelde opslag bij meerdere serverinstanties. Neem tokens en persoonsgegevens niet op in logs.

Vraag één gegeven op. Bekijk het resultaat.

Begin met de disclosure-oefening uit de productdocumentatie. Met Studio-toegang en een beschikbare wallet doorloop je de interactie zonder eerst applicatiecode te schrijven.

  1. Maak een kleine disclosure

    Open Verify → Disclosures in Studio. Kies één wallet en één beschikbaar attribuut, koppel je actieve merk en stel de testcallback in. Activeer de disclosure volgens de handleiding.

  2. Start de test vanuit Studio

    Klik op Test bij de actieve disclosure. De OAuth Debugging Tool vult issuer en client-ID in. Laat de optionele intentvelden leeg, klik op Send request en doorloop de gekozen wallet.

  3. Controleer wat terugkomt

    Na een geslaagde flow toont de tool de OAuth-respons en het gedecodeerde JWT. Vergelijk het gedeelde attribuut met je configuratie en, indien ingesteld, je mapping. Dit is het eerste resultaat van deze oefening.

Handleiding: disclosure configurerenDaarna: aansluiten op je applicatie

Callback voor deze oefening

Selecteer test.ver.id bij Redirect URIs. Studio stelt HTTPS, poort 443 en het callbackpad voor de debuggingtool in.

Geregistreerde redirect URI
https://test.ver.id/disclosure/callback

Deze callback hoort bij de testtool. Registreer voor je eigen applicatie een eigen, exact overeenkomende redirect URI. Gebruik alleen gegevens die je voor de test mag delen.

Geen resultaat?
  • Controleer of de disclosure actief is, de redirect URI exact overeenkomt en de gekozen wallet het gevraagde attribuut heeft.
  • Bij een fout of afgebroken walletinteractie toont de tool de teruggegeven OAuth-fout. Behandel die als een mislukte of geannuleerde flow.
  • In je eigen applicatie: controleer de callback met finalize en verifieer het disclosure-JWT met decode en assertDisclosureV1JwtPayload, zoals de SDK-handleiding beschrijft.

OAuth Authorization Code + PKCE. Gebaseerd op de Studio-handleiding, geraadpleegd op 1 oktober 2026.

Bron: Test a disclosure

Verder bouwen, terugzoeken of overleggen.

De technische bronnen bevatten de volledige configuratie, voorbeelden en responsdetails. De gelinkte documentatie is Engelstalig.

  • TypeScript SDK en voorbeelden

    Onderhouden browser- en Node.js-clients, voorbeeldapps en wijzigingshistorie per package. De SDK is pre-1.0: zet de gekozen versie vast en lees de migratie-instructies bij een upgrade.

  • GraphQL API

    Platformgegevens lezen en je organisatie beheren. De handleiding beschrijft clientrollen, authenticatie en het publieke schema. Houd de client secret in je backend.

  • Wallets en beschikbaarheid

    Controleer per wallet de actuele test- of productiestatus en de handleiding voor jouw flow. Studio toont de opties voor jouw organisatie.