This is an old revision of the document!
CeRTNA Sample Web Service Toolbox Project
CeRTNA has uploaded a sample Visual Studio 2015 C# project entitled Web Service Toolbox that provides a high-level demonstration of how to call the CeRTNA web services that are sending and retrieving payloads and checking a transaction status.
Disclaimer: This sample project is provided as is for reference purposes only. It is not intended to represent production quality code.
The application demonstrates functions like:
- Logging in to obtain a soft-token for use with the various web services.
- Obtaining a list of payloads that reside in a remote folder (repository).
- Locking, unlocking, and deleting a payload from a remote folder (repository).
- Sending/Retrieving payloads to/from remote folders.
- Getting a transaction status and transaction history.
The project can be downloaded by clicking this link: (Checksum Tool)
The ChecksumTool project uses the following NuGet packages, which you will need to install into your Visual Studio setup, if you do not already have them installed:
- Newtonsoft.Json
- RestSharp
The project uses the Windows Presentation Foundation (WPF) classes for the UI.
Following is a brief outline of how to use the tool:
After starting the tool, the following UI will be displayed:
To use the tool, the typical order of steps would be:
| Step | Comment |
|---|---|
| Enter User Name & PW | These are special web service user accounts provided to you by CeRTNA. |
| Select/Load an XML file | You can use a REQUEST or RESPONSE file. |
| Enter a Doc Seq# | This identies which Doc Seq# contained in the XML file that you wish to work with. |
| Click the Calculate button | The SHA3 checksum is calculated and displayed in the Base64 Document Checksum field. |
| Click the Store button | The calculated checksum is stored in the CeRTNA Portal and a Checksum Key is returned and displayed in the Base64 Document Checksum Key field. |
| Click the Validate button | The ChecksumKey and Checksum values displayed on the form are used to validate the locally calculated checksum value against the stored value in the database. |
| Click the Reset button | This clears the form fields. |
Note: The Checksum Value field is unprotected so that you can modify the checksum value manually to test the negative result of the ValidateChecksum flow.
There are plenty of other tools available for testing web services as well. One of the tools CeRTNA works with is POSTMAN. You can download a free version of POSTMAN from the following URL: https://www.getpostman.com/apps