Een stub van de Signing API die dezelfde aanroepen beantwoordt zonder ondertekenaar, app of telefoon: trust-driver-stub-hash-signing.cleverbase.com, met zijn endpointdocumentatie op /docs. Gebruik hem om je leidingwerk kloppend te krijgen voordat je een mens betrekt.
Vraag je contactpersoon bij Cleverbase om ontwikkel- en testgegevens; die staan los van je clients voor acceptatie en productie.
Waar hij goed voor is
- De vorm van elke aanroep: de twee autorisaties,
credentials/list,credentials/info,signHash, de coderingen, de twee tokens en hun twee rollen. - Je eigen toestandsmachine: het verwerken van de redirects, de administratie rond
state, het foutpad, de time-outs. - Überhaupt een handtekeningwaarde terugkrijgen, zodat je het bouwen van de CMS en het schrijven van de PDF van begin tot eind kunt uitproberen.
Waar hij niet goed voor is
- Hij zet geen gebruikersinteractie in gang. Geen QR-pagina om te scannen, geen verzoek in de app, geen pincode. Hij kan je dus niet laten zien wat de ondertekenaar ziet, en hij kan geen weigering opleveren zoals een echte ondertekenaar die geeft.
- Hij levert nooit een echte handtekening. Wat terugkomt is geen gekwalificeerde handtekening en zal ook niet als zodanig valideren. Een document dat je ermee bouwt is voor je eigen leidingwerk, niet voor een validatierapport dat je aan iemand laat zien.
- Hij is beta, en de implementatie kan nog veranderen.
Hoe je hem in een testopstelling gebruikt
Zet je CSC-basis-URL op de stub en laat de rest identiek. Onze eigen referentiekoppeling doet precies dat, met de basis-URL in een omgevingsvariabele, en dat is wat een test op de stub de moeite maakt: het codepad dat je test is het pad dat in productie loopt.
Ga daarna naar acceptatie (connect.acc.cleverbase.com) met een echte telefoon, voor de dingen die de stub niet kan geven:
| Stub | Acceptatie | Productie | |
|---|---|---|---|
| Vorm van de aanroepen, tokens, coderingen | ja | ja | ja |
| De pagina's die de ondertekenaar ziet, de app, de pincode | nee | ja | ja |
| Weiger- en afbreekpaden | nee | ja | ja |
| Een handtekening die valideert | nee | ja, met testcertificaten, niet gekwalificeerd | ja, gekwalificeerd |
Het hoofdstuk "Controles voor je uitlevert" gaat over de uitvoer op acceptatie en in productie; op de stub is het enige dat je kunt controleren of je eigen code de juiste dingen in de juiste volgorde deed.