CeRTNA Sample Checksum Toolkit Project
CeRTNA has uploaded a sample Visual Studio 2015 C# project that provides a high-level demonstration of how to call the CeRTNA web services.
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:
- Obtaining the value of a Base64 document string from an XML file.
- Calculating a SHA384 Hash and converting the hash to a Base64 string.
- Logging in to obtain a soft-token for use with the various web services.
- Calling StoreChecksum web service to store a checksum value.
- Calling the ValidateChecksum web service to validate a checksum value.
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