OpenCard Framework 1.2 Programmer's Guide - OpenSCDP

Contents
Trademarks and service marks . . . . iii
Figures . . . . . . . . . . . . . . vii
Preface . . . . . . . . . . . . . . . ix
About this manual . . . . . . . . . . . . ix
How to use this manual . . . . . . . . . . ix
Assumptions . . . . . . . . . . . . . . ix
Where you can get OpenCard Framework . . . . x
Font conventions used in this manual . . . . . . x
Related documents . . . . . . . . . . . . x
Feedback . . . . . . . . . . . . . . . x
Chapter 1. Introduction . . . . . . . . 1
Developing smart card applications. . . . . . . 1
Developing applications using OpenCard Framework 2
Chapter 2. Getting started . . . . . . . 5
Preparing the system . . . . . . . . . . . 5
Writing your first sample application . . . . . . 5
Writing your second sample application . . . . . 8
Chapter 3. OCF architectural concepts 11
Architecture overview . . . . . . . . . . . 11
The CardTerminal layer . . . . . . . . . . 12
The CardService layer . . . . . . . . . . . 14
FileAccessCardService . . . . . . . . . . 14
SignatureCardService . . . . . . . . . . 15
AppletAccessCardService and
AppletManagerCardService . . . . . . . . 15
Chapter 4. Programming with OCF. . . 17
Configuring the OpenCard Framework . . . . . 17
Configuring the registries. . . . . . . . . 17
Configuring tracing output . . . . . . . . 17
OpenCardPropertyFileLoader . . . . . . . 18
Loading properties with your own mechanism 19
Initializing the OpenCard Framework . . . . . 20
Waiting for a smart card . . . . . . . . . . 20
Obtaining a card service . . . . . . . . . . 21
Handling exceptions . . . . . . . . . . . 21
Listing applications. . . . . . . . . . . . 23
Working with files . . . . . . . . . . . . 24
FileAccessCardService . . . . . . . . . . 24
The CardFilePath class. . . . . . . . . . 24
The CardFileInput/OutputStream classes . . . 25
The CardRandomRecordAccess class . . . . . 25
Signature generation and verification . . . . . . 25
Generating signatures . . . . . . . . . . 26
Verifying signatures . . . . . . . . . . 26
Importing keys . . . . . . . . . . . . 27
Generating keys . . . . . . . . . . . . 27
Chapter 5. Advanced programming
with OCF . . . . . . . . . . . . . . 29
Working with OpenCard events . . . . . . . 29
CardTerminalEvent . . . . . . . . . . . 29
Locking a CardTerminal . . . . . . . . . 29
TracerEvents . . . . . . . . . . . . . 30
Using optional CardTerminal functions . . . . . 30
Getting a smart card via event-notification . . . . 32
Obtaining a smart card from a particular card
terminal . . . . . . . . . . . . . . . 34
Gaining exclusive access to the smart card . . . . 35
Referencing files . . . . . . . . . . . . . 35
Working with credentials . . . . . . . . . . 37
Performing cardholder verification . . . . . . 39
Using the trace utility . . . . . . . . . . . 40
Chapter 6. Using the OpenCard
Framework in applets . . . . . . . . 43
Usage scenario . . . . . . . . . . . . . 43
The security model of the Java Platform 1.1 . . . 43
The security model of the Java Platform 1.2 . . . 43
The Java Plug-In. . . . . . . . . . . . . 44
Writing secure applets with OCF and the Java
Plug-In . . . . . . . . . . . . . . . . 44
Differences in the procedure between Java Platform
1.1 and 1.2. . . . . . . . . . . . . . . 45
Writing secure applets with OCF for Java
Platform 1.1 . . . . . . . . . . . . . 45
Using secure applets with OCF for the Java
Platform 1.1 . . . . . . . . . . . . . 46
Writing secure applets with OCF for the Java
Platform 1.2 . . . . . . . . . . . . . 46
Using secure applets with OCF for the Java
Platform 1.2 . . . . . . . . . . . . . 47
Native Browser support . . . . . . . . . . 48
The opencard.core.util.SystemAccess class . . . 48
Writing secure applets with OpenCard and
Netscape Communicator . . . . . . . . . 48
Writing secure applets with OpenCard and
Microsoft Explorer . . . . . . . . . . . 49
Chapter 7. Writing a CardTerminal . . . 51
Implementing a CardTerminal . . . . . . . . 51
The interface layer . . . . . . . . . . . 51
The function layer . . . . . . . . . . . 56
The communication layer. . . . . . . . . 57
Implementing the Lockable interface . . . . . 57
Implementation of a CardTerminalFactory . . . . 58
Chapter 8. Writing a card service . . . 61
CardService environment — overview . . . . . 61
Application interfaces . . . . . . . . . . . 61
Using standard CardService interfaces . . . . 61
Standard application interfaces . . . . . . . 62
v