Differences

This shows you the differences between two versions of the page.

--- guides:ws_validatechecksum [2018/10/26 21:55] – created brett.zamora
+++ guides:ws_validatechecksum [2019/06/04 23:52] (current) – brett.zamora
@@ Line 2: / Line 2: @@
-The ValidateChecksum web service is used to validate a locally calculated SHA384 checksum against a checksum record that was previously stored in the CeRTNA Portal. The locally calculated checksum_value is obtained by calculating the checksum of a Base64 string contained in a CeRTNA Standard XML PRIA_DOCUMENT node. The checksum_key value contained in RequestChecksumValue (supplied by agent) property or the ResponseChecksumValue (supplied by county) property of the PRIA_DOCUMENT node, provides the index for the checksum_value the caller is validating.
+The ValidateChecksum web service is used to validate a locally calculated SHA384 checksum against a checksum record that was previously stored in the CeRTNA Portal. The locally calculated checksum_value is obtained by [[guides:sample_sha384_hash|calculating the SHA384 checksum of a Base64 string]] contained in a CeRTNA Standard XML PRIA_DOCUMENT node. The checksum_key value contained in RequestChecksumValue (supplied by agent) property or the ResponseChecksumValue (supplied by county) property of the PRIA_DOCUMENT node, provides the index for the checksum_value the caller is validating.
 The ValidateChecksum web service, returns true, if the locally calculated value matches the value that was stored for the indexed record, otherwise it returns false.
@@ Line 9: / Line 9: @@
 <color #7092be>Request Endpoint</color>
-{{tablelayout?colwidth="100px,500px"&rowsFixed=1&rowsVisible=10&float=center}}
+{{tablelayout?colwidth="75px,575px"&rowsFixed=1&rowsVisible=10&float=center}}
 ^ Method ^ URL ^
-| POST | <nowiki>https://apex-prd.certna.org/validatechecksum</nowiki> |
+| POST | <nowiki>https://apex-prd.certna.org/APEX/Service/APEXPublicServer.svc/validatechecksum</nowiki> |
@@ Line 24: / Line 24: @@
 ^ Key ^ Value ^
 | Content-Type | application/json |
+| access_token | {soft-token} |
@@ Line 42: / Line 43: @@
-As noted, any condition that results in an unsuccessful call to the StoreChecksum web service will produce a JSON formatted response with a code and message property populated. Successful calls will result in the checksum_key property being returned. The checksum_key is a required parameter of the ValidateChecksum web service.
+As noted, any condition that results in an unsuccessful call to the ValidateChecksum web service will produce a JSON formatted response with a code and message property populated.
@@ Line 49: / Line 50: @@
 **Endpoint:**
-<nowiki>https://apex-prd.certna.org/validatechecksum</nowiki>
+<nowiki>https://apex-prd.certna.org/APEX/Service/APEXPublicServer.svc/validatechecksum</nowiki>
@@ Line 67: / Line 68: @@
-**Sample Response:**
+<color #7092be>Sample Response</color>
 Status Code: 200
@@ Line 113: / Line 114: @@
 **Comment 2:**
-Following is a C# / .NET sample code snippet that shows how to call the StoreChecksum web service. Your code will supply the values for the various parameters based on the following:
+Following is a C# / .NET sample code snippet that shows how to call the ValidateChecksum web service. Your code will supply the values for the various parameters based on the following:
@@ Line 194: / Line 195: @@
 **Comment 4:**
-CeRTNA has posted a simple Visual Studio 2015 WPF/C# project the CeRTNA Wiki that demonstrates how to look up values in an XML file and how to use the Login, StoreChecksum, and ValidateChecksum web services. The project can be downloaded from the Wiki. As stated earlier, the purpose of the code samples is not to demonstrate well structured code, but rather to provide a very simple, functional sample, that you can use for reference in adding CeRTNA web service calls to your existing application. The code sample is provided as is, however, your production code would be expected to contain more extensive error handling, etc.
+CeRTNA has posted a simple [[:guides:sample_web_service_project|Visual Studio 2015 WPF/C# project]] on the CeRTNA Wiki that demonstrates how to look up values in an XML file and how to use the Login, StoreChecksum, and ValidateChecksum web services. The project can be downloaded from the Wiki. As stated earlier, the purpose of the code samples is not to demonstrate well structured code, but rather to provide a very simple, functional sample, that you can use for reference in adding CeRTNA web service calls to your existing application. The code sample is provided as is, however, your production code would be expected to contain more extensive error handling, etc.