Copyright  2016 HID Global Corporation/ASSA ABLOY AB. All rights reserved.

==============================
HID Global PIV API Java sample
==============================

This sample demonstrates how to use the PIV API version 800-73-3 Client API provided with ActivID ActivClient 7.1 from a Java program.
It implements the following scenarios:
-	How to use a PIV signature key to sign data (this sample only supports certificats with 2048-bit RSA keys).
-	How to read PIV objects from the card.

		----------------------------------------------------

1 - Required runtime environment

	- Microsoft Windows 7 SP1 or later (32 and 64-bit editions)
	- ActivID ActivClient 7.1
	- Oracle Java Runtime Environment 1.7 or later

		----------------------------------------------------

2 - Recommended development environment

	- Oracle Java Development Kit 1.7 or later

	Sample sources are located in the SDK\PIV\Java\Sample folder.

	Add the ActivClient 7.1 installation directory to the CLASSPATH environment variable (for example: set CLASSPATH=%CLASSPATH%;C:\Program Files\HID Global\ActivClient\).
	
	The Java sample is provided together with two batch files. Simply copy the SDK\PIV\Java\Sample folder from the ActivClient distribution CD to a hard disk location, and open a command prompt at that location.
	
	First, run 'piv.javasample_compilation.bat' to produce the  .\Binaries\piv.javasample.jar file.
	Then, run 'piv.javasample_execution.bat' to run the sample.

		----------------------------------------------------

3 - Sample description

	You must be familiar with the PIV specifications to use this sample.
	
	This Java applet relies on acpivapi.dll implementing the PIV API and on aijnipiv.dll/aijnipiv.jar for the Java Native Interface.
	
	It demonstrates the following PIV functions: 
pivMiddlewareVersion, 
pivConnect, 
pivDisconnect, 
pivLogIntoCardApplication, 
pivSelectCardApplication, 
pivGetData, 
pivLogoutOfCardApplication, 
pivCrypt (for signature only)