Digital Signature Storage ICR (3539)

Name

Value

NUMBER

3539

IA #

3539

DATE CREATED

2002/04/22

CUSTODIAL PACKAGE

KERNEL

CUSTODIAL ISC

San Francisco

USAGE

Controlled Subscription

TYPE

Routine

DBIC APPROVAL STATUS

APPROVED

ROUTINE

XUSSPKI

NAME

Digital Signature Storage

GENERAL DESCRIPTION

This IA is for a set of API's to facilitate the use of
PKI Digital Signatures in VistA applications.

STATUS

Active

KEYWORDS

PKI

XUSSPKI

COMPONENT/ENTRY POINT

COMPONENT DESCRIPTION

VARIABLES

$$STORESIG

This API is used to save a base64 encoded Digital
Signature.  It returns a 1 if the signature is filed OK.  or it retunes
"-1^message".

VARIABLES	TYPE	VARIABLES DESCRIPTION
P1	Input	This is the base64 encoded HASH of the data, That is used to link the Signature with the data. We currently use SHA-1 for the hash function.
P2	Input	This is the length of the Signature. It can be used to check that all the data was received. It is used to check that the length received matches that was sent.
P3	Input	This is the array that has the Digital Signature. It is passed by reference. (.ABC)
P4	Input	This is the DUZ of the user whos signagture we are storing.
P5	Input	This is the file number that holds the data that was signed.

$$VERIFY

This API is used to verify a Digital Signature.  The
hash of the data is checked against the hash stored in the Signature.
Revocation checking is done.  Returns "OK" if every thing checks.  or returns
"-1^message".

VARIABLES	TYPE	VARIABLES DESCRIPTION
P1	Input	The Hash to lookup the signature to be checked.
P2	Input	This is the closed root to where the data is.
P3	Input	[optional] This is the date that should be used to check the validity of the signature.

$$CRLURL

This API is used to save the URL's needed to colect
the CRL's that are needed for Certificate revocation checking.

VARIABLES

TYPE

VARIABLES DESCRIPTION

Input

This is a string of CRLURL's seperated by $C(9).
Only ones that start with http: or ldap: will be stored.  The entries in this
file are sent to the Verification Server every hour so current CRL files can
be loaded into the server.

SUBSCRIBING PACKAGE

SUBSCRIBING PACKAGE	ISC	SUBSCRIBING DETAILS
ORDER ENTRY/RESULTS REPORTING	Salt Lake City
OUTPATIENT PHARMACY		ADDED 10/26/2011