DokuWiki

This is an old revision of the document!

Web Service: StoreChecksum

The StoreChecksum web service is used to store the checksum value of a Base64 string contained in a CeRTNA Standard XML PRIA_DOCUMENT node. The checksum value that is passed to the StoreChecksum web service is a SHA384 binary checksum that has been converted to a Base64 string.

The StoreChecksum web service, returns a checksum key. The checksum key is the value that should be stored in either the RequestChecksumValue (agents) or ResponseChecksumValue(counties) property of the PRIA_DOCUMENT node, depending on who made the StoreChecksum request.

The following sample shows the checksum key stored in PRIA_DOCUMENT node:

<PRIA_DOCUMENT _Code="Deed" DocumentSequenceIdentifier="1" RequestChecksumAlgorithm="SHA384" RequestChecksumValue="19AEA2BD-D793-44F0-BBA4-C7F33F0ED27A" ResponseChecksumAlgorithm="SHA384" ResponseChecksumValue="66182401-414F-4901-A212-B8AC18C3E1DE">

The checksum key is used in the ValidateChecksum web service to facilitate the process of validating a checksum value that was stored by another party.

Request Endpoint

Method	URL
POST	https://apex-prd.certna.org/storechecksum

Request Body

This endpoint accepts request body parameters using an application/json format.

Request Headers

Key	Value
Content-Type	application/json

JSON Request Parameters

Parm Name	Req/Opt	Format	Description
checksum	Required	[string]	Locally calculated binary checksum value converted to a Base64 string.

JSON Response Parameters

Parm Name	Format	Description
access_token	[string]	Upon successful login this parameter will be returned.
code	[string]	Upon login failure this parameter will be returned.
message	[string]	Upon login failure this parameter will be returned.

As noted, any condition that results in an unsuccessful login will produce a JSON formatted response with a code and message property populated. Successful logins will result in the access_token property being returned and the token can be used for subsequent web service call for the duration of the web session.

Sample Request

Endpoint:

https://apex-prd.certna.org/user/login

Headers:

Content-Type: application/json

Body:

{
  "user_name" : "sample1",
  "password" : "i4Z15hsQxRv0527iliRhb4j3/OlbtFu0SCn/7Sp+Sqk="
}

Sample Response:

Status Code: 200

or

Status Code: 500 (When an error occurs.)

{
    "access_token": "534d4c30-28a0-48c8-a76d-bbd265d7a1ac"
}

or (example 1)

{
    "Exception": {
        "Code": "DatabaseError",
        "Message": "The user name or/and password are invalid."
    }
}

or (example 2)

{
    "Exception": {
        "Code": "DatabaseError",
        "Message": "Procedure or function 'spLogin_New' expects parameter '@PASSWORD', which was not supplied."
    }
}

Additional Comments

Comments and sample code are provided for reference purposes only and are not intended to show all exception handling conditions and/or completed code blocks.