UniMate USB CSP Manual - Revision history

Bao: Slightly altered spacings

2016-07-27T06:33:17Z

Slightly altered spacings

← Older revision		Revision as of 17:33, 27 July 2016
Line 29:		Line 29:
	WINDOWS is a registered trademark of Microsoft Corporation.		WINDOWS is a registered trademark of Microsoft Corporation.

	The WINDOWS-logo is a registered trademark <sup>(TM)</sup> of Microsoft Corporation.		The WINDOWS-logo is a registered trademark <sup>(TM)</sup> of Microsoft Corporation.

	<b>Software License</b>		<b>Software License</b>
Line 45:		Line 45:
	<b>Email: </b> [mailto:sales@eSecuTech.com sales@esecutech.com]		<b>Email: </b> [mailto:sales@eSecuTech.com sales@esecutech.com]

	Please Email any comments, suggestions or questions regarding this document or our products to us at: [mailto:sales@eSecuTech.com sales@esecutech.com]		Please Email any comments, suggestions or questions regarding this document or our products to us at: [mailto:sales@eSecuTech.com sales@esecutech.com]

	<br>		<br>
Line 67:		Line 67:
	: All UniMate products are environmentally friendly with ROHS certificates.		: All UniMate products are environmentally friendly with ROHS certificates.
	<br><br><br><br>		<br><br><br><br>


	<div style="page-break-before:always"></div>		<div style="page-break-before:always"></div>

	==Introduction==		==Introduction==

Line 76:		Line 76:
	CAPI allows multiple cryptographic service providers (CSP) to coexist on the same computer and to be used in the same application. It is also possible to associate a CSP with a particular smartcard, so that smartcard-enabled Windows applications will call the correct CSP. MS Windows contains many helper functions that application developers may use to simplify code when working with cryptographic functions or with complicated data structures (such as certificates).		CAPI allows multiple cryptographic service providers (CSP) to coexist on the same computer and to be used in the same application. It is also possible to associate a CSP with a particular smartcard, so that smartcard-enabled Windows applications will call the correct CSP. MS Windows contains many helper functions that application developers may use to simplify code when working with cryptographic functions or with complicated data structures (such as certificates).

	Choosing which API to use when developing applications is dependent on the needs of the particular application.		Choosing which API to use when developing applications is dependent on the needs of the particular application.


	==Algorithms and APIs==		==Algorithms and APIs==

	<table class="wikitable">		<table class="wikitable">
	<tr >		<tr>
	<td style="background-color: red;" colspan="2"><b style="color: #fff;">Connection functions</b></td>		<td style="background-color: red;" colspan="2"><b style="color: #fff;">Connection functions</b></td>
	</tr>		</tr>
Line 101:		Line 100:
	<td>Set parameters of CSP</td>		<td>Set parameters of CSP</td>
	</tr>		</tr>
	<tr >		<tr>
	<td style="background-color: red;" colspan="2"><b style="color: #fff;">Generate and exchange key functions</b></td>		<td style="background-color: red;" colspan="2"><b style="color: #fff;">Generate and exchange key functions</b></td>
	</tr>		</tr>
Line 144:		Line 143:
	<td>Gets a handle to a permanent user key</td>		<td>Gets a handle to a permanent user key</td>
	</tr>		</tr>
	<tr >		<tr>
	<td style="background-color: red;" colspan="2"><b style="color: #fff;">Data encryption function</b></td>		<td style="background-color: red;" colspan="2"><b style="color: #fff;">Data encryption function</b></td>
	</tr>		</tr>
Line 194:		Line 193:

	<div style="page-break-before:always"></div>		<div style="page-break-before:always"></div>
			==Samples==
	==Samples==
	All the samples are implemented in the C++ language, and they all support the MS-CAPI standard. We provide the samples below, located in path: <code>SDK\CSP(MS-CAPI)\Sample</code>		All the samples are implemented in the C++ language, and they all support the MS-CAPI standard. We provide the samples below, located in path: <code>SDK\CSP(MS-CAPI)\Sample</code>

Line 219:		Line 217:
	<td>This sample demonstrates operations on a certificate list.</td>		<td>This sample demonstrates operations on a certificate list.</td>
	</tr>		</tr>
	</table>		</table>

			===Algorithm samples===
	===Algorithm samples===
	<b>These samples include 3 functions:</b>		<b>These samples include 3 functions:</b>
	* <code>int GenerateAlgTest(ULONG ulALG)</code>		* <code>int GenerateAlgTest(ULONG ulALG)</code>
Line 255:		Line 252:
	<td>CryptDecrypt</td>		<td>CryptDecrypt</td>
	</tr>		</tr>
	</table>		</table>

	<b>DeviceAlgTest is used for key derivation, data encryption and decryption operations:</b>		<b>DeviceAlgTest is used for key derivation, data encryption and decryption operations:</b>
Line 288:		Line 285:
	<td>CryptDecrypt</td>		<td>CryptDecrypt</td>
	</tr>		</tr>
	</table>		</table>

	<b>RstTest is used for RSA key generation, data encryption and decryption operations:</b>		<b>RstTest is used for RSA key generation, data encryption and decryption operations:</b>
Line 313:		Line 310:
	<td>CryptDecrypt</td>		<td>CryptDecrypt</td>
	</tr>		</tr>
	</table>		</table>

			===Container sample===
	===Container sample===
	This sample demonstrates how to enumerate, add and delete containers with the function - <code>int kcsTest(ULONG ulActive)</code>		This sample demonstrates how to enumerate, add and delete containers with the function - <code>int kcsTest(ULONG ulActive)</code>

Line 388:		Line 384:
	<td>CryptAcquireContext</td>		<td>CryptAcquireContext</td>
	</tr>		</tr>
	</table>		</table>


	===List Certificate sample===		===List Certificate sample===
	This sample demonstrates how to enumerate certificates with the function - <code>int listcerts(void)</code>		This sample demonstrates how to enumerate certificates with the function - <code>int listcerts(void)</code>

Line 417:		Line 412:

	<div style="page-break-before:always"></div>		<div style="page-break-before:always"></div>
			==PKI package==
			UniMate provides a PKI package for developers and end users respectively. The package provides the UniMate PKI installation, if you want to use the PKI package, you must install it.

	~~==PKI package==~~		===Installation===
	~~UniMate provides a PKI package for developers and end users respectively. The package provides the UniMate PKI installation, if you want to use the PKI package, you must install it.~~		The UniMate PKI package can be found in the redists folder of the SDK.

	===Installation===
	The UniMate PKI package can be found in the redists folder of the SDK.

	For the developer package, double click the icon to run PKI package.exe, and follow the instructions below:		For the developer package, double click the icon to run PKI package.exe, and follow the instructions below:
Line 430:		Line 424:
	[[File:UniMate PKI Setup.PNG\|alt=UniMate PKI setup window]]		[[File:UniMate PKI Setup.PNG\|alt=UniMate PKI setup window]]

	~~<br>~~
	Afterwards, click Finish to close the setup wizard.		Afterwards, click Finish to close the setup wizard.

	[[File:UniMate PKI Finish.PNG\|alt=UniMate PKI setup finished]]		[[File:UniMate PKI Finish.PNG\|alt=UniMate PKI setup finished]]

			===Uninstallation===
	===Uninstallation===
	To uninstall the software, select <code>Start Menu -- All apps -- UniMate Drive\PKI package\uninstall</code> (on Windows 8/10 you may need to right-click the file in the folder, mouse over More and select Open file location). Otherwise, by default the uninstaller is located in: <code>C:\Users\<your_username>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\UniMate Drive\PKI package</code>		To uninstall the software, select <code>Start Menu -- All apps -- UniMate Drive\PKI package\uninstall</code> (on Windows 8/10 you may need to right-click the file in the folder, mouse over More and select Open file location). Otherwise, by default the uninstaller is located in: <code>C:\Users\<your_username>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\UniMate Drive\PKI package</code>

Line 470:		Line 462:
	{\| class="wikitable"		{\| class="wikitable"
	\|+ style="text-align:left;" \| Contact Us:		\|+ style="text-align:left;" \| Contact Us:
	!		!
	! scope="col"\| North America		! scope="col"\| North America
	! scope="col"\| China		! scope="col"\| China

Bao: Added alt tags

2016-07-27T03:10:04Z

Added alt tags

← Older revision		Revision as of 14:10, 27 July 2016
Line 428:		Line 428:
	Click Install.		Click Install.

	[[File:UniMate PKI Setup.PNG]]		[[File:UniMate PKI Setup.PNG\|alt=UniMate PKI setup window]]

	<br>		<br>
	Afterwards, click Finish to close the setup wizard.		Afterwards, click Finish to close the setup wizard.

	[[File:UniMate PKI Finish.PNG]]		[[File:UniMate PKI Finish.PNG\|alt=UniMate PKI setup finished]]


Line 441:		Line 441:
	Click OK and restart your computer to finish the uninstallation.		Click OK and restart your computer to finish the uninstallation.

	[[File:UniMate PKI Uninstall.PNG]]		[[File:UniMate PKI Uninstall.PNG\|alt=UniMate PKI has been removed]]

	<div style="page-break-before:always"></div>		<div style="page-break-before:always"></div>

Administrator at 06:24, 30 June 2016

2016-06-30T06:24:44Z

← Older revision		Revision as of 17:24, 30 June 2016
Line 192:		Line 192:
	</tr>		</tr>
	</table>		</table>


	~~[[#Table of Contents\|CONTENTS]]~~

	<div style="page-break-before:always"></div>		<div style="page-break-before:always"></div>
Line 418:		Line 415:
	</table>		</table>


	~~[[#Table of Contents\|CONTENTS]]~~

	<div style="page-break-before:always"></div>		<div style="page-break-before:always"></div>

Bao at 05:47, 30 June 2016

2016-06-30T05:47:11Z

← Older revision		Revision as of 16:47, 30 June 2016
Line 67:		Line 67:
	: All UniMate products are environmentally friendly with ROHS certificates.		: All UniMate products are environmentally friendly with ROHS certificates.
	<br><br><br><br>		<br><br><br><br>

			<div style="page-break-before:always"></div>

	==Introduction==		==Introduction==
Line 193:		Line 195:

	[[#Table of Contents\|CONTENTS]]		[[#Table of Contents\|CONTENTS]]

			<div style="page-break-before:always"></div>

	==Samples==		==Samples==
	All the samples are implemented in the C++ language, and they all support the MS-CAPI standard. We provide the samples below, located in path: <code>SDK\CSP(MS-CAPI)\Sample</code>		All the samples are implemented in the C++ language, and they all support the MS-CAPI standard. We provide the samples below, located in path: <code>SDK\CSP(MS-CAPI)\Sample</code>
Line 415:		Line 420:

	[[#Table of Contents\|CONTENTS]]		[[#Table of Contents\|CONTENTS]]

			<div style="page-break-before:always"></div>

	==PKI package==		==PKI package==
	UniMate provides a PKI package for developers and end users respectively. The package provides the UniMate PKI installation, if you want to use the PKI package, you must install it.		UniMate provides a PKI package for developers and end users respectively. The package provides the UniMate PKI installation, if you want to use the PKI package, you must install it.
Line 439:		Line 447:

	[[File:UniMate PKI Uninstall.PNG]]		[[File:UniMate PKI Uninstall.PNG]]

			<div style="page-break-before:always"></div>

	<br><br>		<br><br>

Administrator at 03:17, 30 June 2016

2016-06-30T03:17:53Z

← Older revision		Revision as of 14:17, 30 June 2016
Line 1:		Line 1:
			[[category:UniMate Manuals]]

	<div id = "Table of Contents"></div>		<div id = "Table of Contents"></div>
	==<b>CSP Manual</b>==		==<b>CSP Manual</b>==

Bao at 01:48, 30 June 2016

2016-06-30T01:48:42Z

← Older revision		Revision as of 12:48, 30 June 2016
Line 482:		Line 482:
	\|-		\|-
	! scope="row"\| Fax		! scope="row"\| Fax
	\| + 1 -888-259-5825 ext.0		\| +1 -888-259-5825 ext.0
	\| + 8610-8288 8834		\| +8610-8288 8834
	\| 00612-9888 6185		\| 00612-9888 6185
	\| +33-042-600-2810		\| +33-042-600-2810

Bao: /* Uninstallation */

2016-06-29T23:22:59Z

Uninstallation

← Older revision		Revision as of 10:22, 30 June 2016
Line 459:		Line 459:
	SecuTech Solution Inc. is a company specializing in data protection and strong authentication, providing total customer satisfaction in security systems & services for banks, financial institutions & other industries. Having extensive and in-depth experience within the information security market, SecuTech has drawn upon this experience to utilize today's cutting-edge technologies that are effective against increasingly sophisticated cyber attacks. Enabling enterprises, financial institutions, and government to safely adopt the economic benefits of mobile and cloud computing.		SecuTech Solution Inc. is a company specializing in data protection and strong authentication, providing total customer satisfaction in security systems & services for banks, financial institutions & other industries. Having extensive and in-depth experience within the information security market, SecuTech has drawn upon this experience to utilize today's cutting-edge technologies that are effective against increasingly sophisticated cyber attacks. Enabling enterprises, financial institutions, and government to safely adopt the economic benefits of mobile and cloud computing.

	<b>http://www.~~eSecuTech~~.com<br>SecuTech Solution Inc.</b>		<b>http://www.esecutech.com<br>SecuTech Solution Inc.</b>

	{\| class="wikitable"		{\| class="wikitable"

Bao: /* PKI package */

2016-06-29T06:48:50Z

PKI package

← Older revision		Revision as of 17:48, 29 June 2016
Line 439:		Line 439:

	<br><br>		<br><br>
			If you have any questions, please feel free to contact us at: http://www.esecutech.com/support or [mailto:support@esecutech.com support@esecutech.com]

			<br>
	{\| style="border-style: solid; border-width: 1px;" align="center"		{\| style="border-style: solid; border-width: 1px;" align="center"
	\|		\|

Bao: /* CSP Manual */

2016-06-29T05:12:23Z

CSP Manual

@@ Line 2: / Line 2: @@
 ==<b>CSP Manual</b>==
 <b><i>Version 2.0</i></b>
 The data and information contained in this document cannot be altered without the express written permission of SecuTech Solution Inc. No part of this document can be reproduced or transmitted for any purpose whatsoever, either by electronic or mechanical means.
@@ Line 29: / Line 44: @@
 Please Email any comments, suggestions or questions regarding this document or our products to us at: [mailto:sales@eSecuTech.com sales@esecutech.com]
 <br>

Bao: Added page, images, links. Altered tables

2016-06-29T04:39:51Z

Added page, images, links. Altered tables

New page

<div id = "Table of Contents"></div>
==CSP Manual==

Version 2.0

The data and information contained in this document cannot be altered without the express written permission of SecuTech Solution Inc. No part of this document can be reproduced or transmitted for any purpose whatsoever, either by electronic or mechanical means.

The general terms of trade of SecuTech Solution Inc. apply. Diverging agreements must be made in writing.

Copyright SecuTech Solution Inc. All rights reserved.

WINDOWS is a registered trademark of Microsoft Corporation.

The WINDOWS-logo is a registered trademark (TM) of Microsoft Corporation.

Software License

The software and the enclosed documentation are copyright-protected. By installing the software, you agree to the conditions of the licensing agreement.

Licensing Agreement

SecuTech Solution Inc. (SecuTech for short) gives the buyer the simple, exclusive and non-transferable licensing right to use the software on one individual computer or networked computer system (LAN). Copying and any other form of reproduction of the software in full or in part as well as mixing and linking it with others is prohibited. The buyer is authorized to make one single copy of the software as backup. SecuTech reserves the right to change or improve the software without notice or to replace it with a new development. SecuTech is not obliged to inform the buyer of changes, improvements or new developments or to make these available to him. A legally binding promise of certain qualities is not given. SecuTech is not responsible for damage unless it is the result of deliberate action or negligence on the part of SecuTech or its aids and assistants. SecuTech accepts no responsibility of any kind for indirect, accompanying or subsequent damage.

Contact Information

Web: http://www.esecutech.com

Email: [mailto:sales@eSecuTech.com sales@esecutech.com]

Please Email any comments, suggestions or questions regarding this document or our products to us at: [mailto:sales@eSecuTech.com sales@esecutech.com]

<table class="wikitable">
<tr>
<td style="background-color: red;">Version</td>
<td style="background-color: red;">Date</td>
</tr>
<tr>
<td>1.0</td>
<td>2015.7</td>
</tr>
<tr>
<td>2.0</td>
<td>2016.7</td>
</tr>
</table>

 
; CE Attestation of Conformity
[[File:CE Attestation.png|left|100px|top]]
: UniMate is in conformity with the protection requirements of CE Directives 89/336/EEC Amending Directive 92/31/EEC. UniMate satisfies the limits and verifying methods: EN55022/CISPR 22 Class B, EN55024: 1998.
 
; FCC Standard
[[File:FCC.png|left|100px|top]]
: This device is in conformance with Part 15 of the FCC Rules and Regulation for Information Technology Equipment.
: Operation of this product is subject to the following two conditions: (1) this device may not cause harmful interference, and (2) this device must accept any interference received, including interference that may cause undesired operation.
 
[[File:USB Logo.png|left|100px|top]] The equipment of UniMate is USBbased.
 
; Conformity to ISO 9001<nowiki>:</nowiki>2000
[[File:ISO 9001.png|left|100px|top]]
: The Quality System of SecuTech Solution Inc., including its implementation, meets the requirements of the standard ISO 9001:2000
 
; ROHS
[[File:ROHS.png|left|100px|top]]
: All UniMate products are environmentally friendly with ROHS certificates.
 

==Introduction==

CAPI (Cryptographic Application Programming Interface), developed by Microsoft as part of Microsoft Windows, is an interface to a library of functions software developers can call upon for security and cryptography services. It is intended for use by developers of applications for MS Windows platforms.

CAPI allows multiple cryptographic service providers (CSP) to coexist on the same computer and to be used in the same application. It is also possible to associate a CSP with a particular smartcard, so that smartcard-enabled Windows applications will call the correct CSP. MS Windows contains many helper functions that application developers may use to simplify code when working with cryptographic functions or with complicated data structures (such as certificates).

Choosing which API to use when developing applications is dependent on the needs of the particular application.

==Algorithms and APIs==

<table class="wikitable">
<tr >
<td style="background-color: red;" colspan="2">Connection functions</td>
</tr>
<tr>
<td>CryptAcquireContext</td>
<td>Create a context and initialize access to CSP which must be specified</td>
</tr>
<tr>
<td>CryptReleaseContext</td>
<td>Release the context created in CryptAcquireContext and other resources</td>
</tr>
<tr>
<td>CryptGetProvParam</td>
<td>Return information related to CSP</td>
</tr>
<tr>
<td>CryptSetProvParam</td>
<td>Set parameters of CSP</td>
</tr>
<tr >
<td style="background-color: red;" colspan="2">Generate and exchange key functions</td>
</tr>
<tr>
<td>CryptGenKey</td>
<td>Generate key or key pair</td>
</tr>
<tr>
<td>CryptDeriveKey</td>
<td>Derive a session key from a data hash and guarantee the generated key difference</td>
</tr>
<tr>
<td>CryptSetKeyParam</td>
<td>Set key attributes</td>
</tr>
<tr>
<td>CryptGetKeyParam</td>
<td>Retrieves the data that controls the operations of the key</td>
</tr>
<tr>
<td>CryptExportKey</td>
<td>Export key from container</td>
</tr>
<tr>
<td>CryptImportKey</td>
<td>Import the key to CSP container</td>
</tr>
<tr>
<td>CryptDestroyKey</td>
<td>Release key handle, after which the handle will be invalid and cannot be accessed</td>
</tr>
<tr>
<td>CryptDuplicateKey</td>
<td>Create a duplicate of the key</td>
</tr>
<tr>
<td>CryptGenRandom</td>
<td>Generate random data</td>
</tr>
<tr>
<td>CryptGetUserKey</td>
<td>Gets a handle to a permanent user key</td>
</tr>
<tr >
<td style="background-color: red;" colspan="2">Data encryption function</td>
</tr>
<tr>
<td>CryptDecrypt</td>
<td>Decrypt document</td>
</tr>
<tr>
<td>CryptEncrypt</td>
<td>Encrypt document</td>
</tr>
<tr>
<td>CryptCreateHash</td>
<td>Returns a handle to a created hashing object and initializes it</td>
</tr>
<tr>
<td>CryptDestroyHash</td>
<td>Delete hashing object handle</td>
</tr>
<tr>
<td>CryptDuplicateHash</td>
<td>Duplicates a hashing object, including state, up to when the duplication is done</td>
</tr>
<tr>
<td>CryptHashData</td>
<td>Hash input data</td>
</tr>
<tr>
<td>CryptGetHashParam</td>
<td>Get the hash value and data that control the operations of the hash object</td>
</tr>
<tr>
<td>CryptHashSessionKey</td>
<td>Hash a session key without revealing the key value to the application</td>
</tr>
<tr>
<td>CryptSetHashParam</td>
<td>Set the attributes of a hash object, such as specific algorithm or initial contents</td>
</tr>
<tr>
<td>CryptSignHash</td>
<td>Sign a hash object</td>
</tr>
<tr>
<td>CryptVerifySignature</td>
<td>Verifies the signature of a hash object</td>
</tr>
</table>

[[#Table of Contents|CONTENTS]]
==Samples==
All the samples are implemented in the C++ language, and they all support the MS-CAPI standard. We provide the samples below, located in path: <code>SDK\CSP(MS-CAPI)\Sample</code>

<table class="wikitable">
<tr>
<td style="background-color: red;">Function</td>
<td style="background-color: red;">Files</td>
<td style="background-color: red;">Description</td>
</tr>
<tr>
<td>Algorithm</td>
<td>algorithmTest.cpp algorithmTest.h</td>
<td>This sample demonstrates operations on symmetric keys, hashing and asymmetric keys.</td>
</tr>
<tr>
<td>Container</td>
<td>kcsTest.cpp kcsTest.h</td>
<td>This sample demonstrates enumeration, deletion and creation of files.</td>
</tr>
<tr>
<td>Certificates</td>
<td>listcerts.cpp listcerts.h</td>
<td>This sample demonstrates operations on a certificate list.</td>
</tr>
</table>

===Algorithm samples===
These samples include 3 functions:
* <code>int GenerateAlgTest(ULONG ulALG)</code>
* <code>int DeviceAlgTest(ULONG ulALG)</code>
* <code>int RstTest(ULONG version)</code>

GenerateAlgTest is used for DES key generation, encryption and decryption operations:

<table class="wikitable">
<tr>
<td style="background-color: red;">Steps</td>
<td style="background-color: red;">Function</td>
</tr>
<tr>
<td>1. Create a container</td>
<td>CryptAcquireContext</td>
</tr>
<tr>
<td>2. Retrieve parameters that govern the operations of a CSP</td>
<td>CryptGetProvParam</td>
</tr>
<tr>
<td>3. Generate a key</td>
<td>CryptGenKey</td>
</tr>
<tr>
<td>4. Data Encryption</td>
<td>CryptEncrypt</td>
</tr>
<tr>
<td>5. Data Decryption</td>
<td>CryptDecrypt</td>
</tr>
</table>

DeviceAlgTest is used for key derivation, data encryption and decryption operations:

<table class="wikitable">
<tr>
<td style="background-color: red;">Steps</td>
<td style="background-color: red;">Function</td>
</tr>
<tr>
<td>1. Create a container</td>
<td>CryptAcquireContext</td>
</tr>
<tr>
<td>2. Initiate the hashing of a stream of data</td>
<td>CryptCreateHash</td>
</tr>
<tr>
<td>3. Add data to a specified hash object</td>
<td>CryptHashData</td>
</tr>
<tr>
<td>4. Derive a key</td>
<td>CryptDeriveKey</td>
</tr>
<tr>
<td>5. Data Encryption</td>
<td>CryptEncrypt</td>
</tr>
<tr>
<td>6. Data Decryption</td>
<td>CryptDecrypt</td>
</tr>
</table>

RstTest is used for RSA key generation, data encryption and decryption operations:

<table class="wikitable">
<tr>
<td style="background-color: red;">Steps</td>
<td style="background-color: red;">Function</td>
</tr>
<tr>
<td>1. Create a container</td>
<td>CryptAcquireContext</td>
</tr>
<tr>
<td>2. Generate a key</td>
<td>CryptGenKey</td>
</tr>
<tr>
<td>3. Data Encryption</td>
<td>CryptEncrypt</td>
</tr>
<tr>
<td>4. Data Decryption</td>
<td>CryptDecrypt</td>
</tr>
</table>

===Container sample===
This sample demonstrates how to enumerate, add and delete containers with the function - <code>int kcsTest(ULONG ulActive)</code>

For enumerating a container: 

<table class="wikitable">
<tr>
<td style="background-color: red;">Steps</td>
<td style="background-color: red;">Function</td>
</tr>
<tr>
<td>1. Acquire a "VERIFYCONTEXT" handle</td>
<td>CryptAcquireContext</td>
</tr>
<tr>
<td>2. Enumerate through the key containers</td>
<td>CryptGetProvParam</td>
</tr>
<tr>
<td>3. Acquire a handle to the key container found</td>
<td>CryptAcquireContext</td>
</tr>
<tr>
<td>4. Try to get a handle to the key pair</td>
<td>CryptGetUserKey</td>
</tr>
<tr>
<td>5. Get key permissions</td>
<td>CryptGetKeyParam</td>
</tr>
<tr>
<td>6. Display key permissions</td>
<td></td>
</tr>
</table>

For adding a container:

<table class="wikitable">
<tr>
<td style="background-color: red;">Steps</td>
<td style="background-color: red;">Function</td>
</tr>
<tr>
<td>1. Check whether the container already exists</td>
<td>CryptAcquireContext</td>
</tr>
<tr>
<td>2. If not, create a container</td>
<td>CryptAcquireContext</td>
</tr>
</table>

For deleting a container:

<table class="wikitable">
<tr>
<td style="background-color: red;">Steps</td>
<td style="background-color: red;">Function</td>
</tr>
<tr>
<td>1. Check whether the container already exists</td>
<td>CryptAcquireContext</td>
</tr>
<tr>
<td>2. If it does, release the handle to the context</td>
<td>CryptReleaseContext</td>
</tr>
<tr>
<td>3. Delete the container</td>
<td>CryptAcquireContext</td>
</tr>
</table>

===List Certificate sample===
This sample demonstrates how to enumerate certificates with the function - <code>int listcerts(void)</code>

For enumerating certificates:

<table class="wikitable">
<tr>
<td style="background-color: red;">Steps</td>
<td style="background-color: red;">Function</td>
</tr>
<tr>
<td>1. Open a handle to the certificate store: MY\\UniMateStore</td>
<td>CertOpenStore</td>
</tr>
<tr>
<td>2. Go over each and every certificate within the certificate store</td>
<td>CertEnumCertificatesInStore</td>
</tr>
<tr>
<td>3. Get and display the subject name from the certificate</td>
<td>CertGetNameString</td>
</tr>
</table>

[[#Table of Contents|CONTENTS]]
==PKI package==
UniMate provides a PKI package for developers and end users respectively. The package provides the UniMate PKI installation, if you want to use the PKI package, you must install it.

===Installation===
The UniMate PKI package can be found in the redists folder of the SDK.

For the developer package, double click the icon to run PKI package.exe, and follow the instructions below:

Click Install.

[[File:UniMate PKI Setup.PNG]]

 
Afterwards, click Finish to close the setup wizard.

[[File:UniMate PKI Finish.PNG]]

===Uninstallation===
To uninstall the software, select <code>Start Menu -- All apps -- UniMate Drive\PKI package\uninstall</code> (on Windows 8/10 you may need to right-click the file in the folder, mouse over More and select Open file location). Otherwise, by default the uninstaller is located in: <code>C:\Users\<your_username>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\UniMate Drive\PKI package</code>

Click OK and restart your computer to finish the uninstallation.

[[File:UniMate PKI Uninstall.PNG]]

 
{| style="border-style: solid; border-width: 1px;" align="center"
|
<gallery class="center" mode="nolines" widths=175px heights=50px caption="Follow Us!">
File:Twitter.png|'''[https://twitter.com/eSecuTech Twitter]'''
File:Facebook.png|'''[https://www.facebook.com/eSecuTech/ Facebook]'''
File:YouTube.png|'''[https://www.youtube.com/user/esecutech YouTube]'''
File:Linked In.png|'''[https://ca.linkedin.com/in/secutech-solutions-inc-39110b25 LinkedIn]'''
</gallery>
|}

 
[[File:Footer Logo List.png|left]]
 
About SecuTech

SecuTech Solution Inc. is a company specializing in data protection and strong authentication, providing total customer satisfaction in security systems & services for banks, financial institutions & other industries. Having extensive and in-depth experience within the information security market, SecuTech has drawn upon this experience to utilize today's cutting-edge technologies that are effective against increasingly sophisticated cyber attacks. Enabling enterprises, financial institutions, and government to safely adopt the economic benefits of mobile and cloud computing.

http://www.eSecuTech.com SecuTech Solution Inc.

{| class="wikitable"
|+ style="text-align:left;" | Contact Us:
!
! scope="col"| North America
! scope="col"| China
! scope="col"| Asia-Pacific
! scope="col"| EMEA
|-
! scope="row"| Address
| 1250 Boulevard Ren-Lvesque Ouest, #2200, Montreal, QC, H3B 4W8, Canada
| Level 12, #67 Bei Si Huan Xi Lu, Beijing, China, 100080
| Suite 5.14, 32 Delhi Rd, North Ryde, NSW, 2113, Australia
| 4 Cours Bayard 69002 Lyon, France
|-
! scope="row"| Phone
| +1 -888-259-5825
| +8610-8288 8834
| 00612-9888 6185
| +33-042-600-2810
|-
! scope="row"| Fax
| + 1 -888-259-5825 ext.0
| + 8610-8288 8834
| 00612-9888 6185
| +33-042-600-2810
|-
! scope="row"| Email
| [mailto:info@esecutech.com info@esecutech.com]
| [mailto:cn@esecutech.com cn@esecutech.com]
| [mailto:aus@esecutech.com aus@esecutech.com]
| [mailto:europe@esecutech.com europe@esecutech.com]
|}

Copyright 2012 SecuTech Solution Inc. All rights reserved. Reproduction in whole or in part without written permission from SecuTech is prohibited. SecuTech UniMate and the SecuTech logo are trademarks of SecuTech Inc. Windows and all other trademarks are properties of their respective owners. Features and specifications are subject to change without notice.

[[File:SecuTech Logo.png]]

 
[[#top|TOP]]