background image

Chapter 1

Installing the SATSA Reference Implementation

7

The optional

internal.config

file parameters are:

keygen

- specifies that a key be generated. Setting this parameter to

false

specifies that no key be generated.

opaquesig

- specifies that opaque signatures be used. Setting this parameter to

false

does not allow the use of opaque signatures.

certsig

- specifies that a certificate signature be used. Setting this parameter ro

false

does not allow the use of certificate signatures.

The default SATSA 1.0 RI configuration defines two card slots,

0H

and

1H

. In

CODE EXAMPLE 2

, above, the parameter

hostsandports

provides the location

of the Java Card platform emulator for each of the configured slots (that is, on the
machine

localhost

, slot

0H

of the Java Card emulator listens on socket

9025

and

slot

1H

listens on socket

9026

).

The

system.config

File

The

system.config

file defines several parameters, only one of which is used by

the SATSA 1.0 Reference Implementation.

CODE EXAMPLE 3

describes the

microedition.smartcardslots

parameter, which defines the slots where the

Java Card platform emulator listens on the machine

localhost

(shown in

CODE EXAMPLE 2

, above).

CODE EXAMPLE 3

The

system.config

File

__________________________________________________________________

(......)

microedition.smartcardslots: 0H, 1H

(......)

__________________________________________________________________

For additional information regarding the

microedition.smartcardslots

parameter, see the

Security and Trust Services APIs for the Java 2 Platform, Micro

Edition Specification

.

Summary of Contents for 1.0

Page 1: ...ystems Inc 4150 Network Circle Santa Clara California 95054 U S A 650 960 1300 Security and Trust Services APIs for Java 2 Platform Micro Edition Version 1 0 Reference Implementation Installation Guide July 2004 ...

Page 2: ...ERS ARE HELD TO BE LEGALLY INVALID Copyright 2004 Sun Microsystems Inc 4150 Network Circle Santa Clara California 95054 Etats Unis Tous droits réservés Sun Microsystems Inc a les droits de propriété intellectuels relatants à la technologie incorporée dans le produit qui est décrit dans ce document En particulier et sans la limitation ces droits de propriété intellectuels peuvent inclure un ou plus...

Page 3: ...Setting System Variables 2 Installing the SATSA Packages 3 Contents of the Reference Implementation 3 Running the SATSA 1 0 Reference Implementation 4 Starting the MIDP 2 0 Emulator 4 Starting the Java Card Emulator 4 SATSA 1 0 Configuration Files 6 The internal config File 6 The system config File 7 Glossary 9 Index 11 ...

Page 4: ...iv SATSA Installation Guide July 2004 ...

Page 5: ...E developers working with the Security and Trust Services APIs 1 0 Reference Implementation Before You Read This Guide In order to fully use the information in this document you must have thorough knowledge of the topics discussed in these guides Java Card Platform Version 2 2 1 Development Kit User s Guide MIDP Reference Implementation Version 2 0 Using MIDP MIDP Reference Implementation Version ...

Page 6: ...face Meaning Examples AaBbCc123 The names of commands files and directories on screen computer output Edit your login file Use ls a to list all files You have mail AaBbCc123 What you type when contrasted with on screen computer output su Password AaBbCc123 Book titles new words or terms words to be emphasized Command line variable replace with a real name or value Read Chapter 6 in the User s Guid...

Page 7: ...cumentation on the Web http java sun com reference docs index html Sun Welcomes Your Comments We are interested in improving our documentation and welcome your comments and suggestions Send us your comments at http java sun com docs forms sendusmail html Application Title Release Notes Security and Trust Services APIs Reference Implementation Release Notes ...

Page 8: ...viii SATSA Installation Guide July 2004 ...

Page 9: ... signature signing and basic user credential management using the Public Key Infrastructure PKI protocol SATSA CRYPTO Defines a subset of the Java 2 Platform Standard Edition J2SE cryptography API It provides basic cryptographic operations to support message digest signature verification encryption and decryption The SATSA 1 0 Reference Implementation is designed to run on top of a J2ME platform I...

Page 10: ...on 2 2 1 For complete instructions on how to download and install the Java Card Platform Development Kit 2 2 1 Reference Implementation see http java sun com products javacard dev_kit html Setting System Variables The installation of the required software shown above is straightforward and can be accomplished by using the documentation included with each software set When all the required software...

Page 11: ...t points to the location where you have installed the SATSA 1 0 RI distribution For example if you install to the location shown in Step 1 MIDP_HOME would point to C satsa1 0 3 Append MIDP_HOME bin to your PATH variable 4 Append MIDP_HOME lib to your CLASSPATH variable Contents of the Reference Implementation The SATSA 1 0 Reference Implementation contains the following subdirectories appdb contai...

Page 12: ... this document such as writing an HTML page to point to the sample midlet suites and running a web server such as Apache or TomCat to handle the HTTP requests sent by the emulator For more information see Using MIDP and Creating Midlet Suites in the MIDP 2 0 documentation set Starting the Java Card Emulator The SATSA 1 0 Reference Implementation works in conjunction with the Java Card platform 2 2...

Page 13: ... __________________________________________________________________ Java Card 2 2 1 C Reference Implementation Simulator version 0 41 32 bit Address Space implementation no cryptography support Copyright 2003 Sun Microsystems Inc All rights reserved Memory Configuration Type Base Size MAX Addr RAM 0x0 0x500 0x4ff ROM 0x2000 0xa000 0xbfff E2P 0x10020 0xffe0 0x1ffff ROM Mask size 0x578c 22412 bytes ...

Page 14: ...pecifically for the SATSA 1 0 RI are displayed in CODE EXAMPLE 2 CODE EXAMPLE 2 The internal config File __________________________________________________________________ com sun satsa keygen true com sun satsa opaquesig true com sun satsa certsig true com sun midp io j2me apdu hostsandports localhost 9025 localhost 9026 com sun midp io j2me apdu satselectedapdu 00 a4 04 07 a0 00 00 00 62 3 1 7F ...

Page 15: ...each of the configured slots that is on the machine localhost slot 0H of the Java Card emulator listens on socket 9025 and slot 1H listens on socket 9026 The system config File The system config file defines several parameters only one of which is used by the SATSA 1 0 Reference Implementation CODE EXAMPLE 3 describes the microedition smartcardslots parameter which defines the slots where the Java...

Page 16: ...8 SATSA Installation Guide July 2004 ...

Page 17: ...Card A smart card that has the capability of running Java code JCP Java Community Process JCP The process used by the world wide community of Java developers for formulating Java based standards and evaluating specifications JCRE Java Card Runtime Environment The execution environment for Java Card applets JCRMI Java Card Remote Method Invocation A subset version of Java 2 Platform Standard Editio...

Page 18: ...d Trust Services APIs A set of four J2ME optional packages that provide communication protocols such as APDU and JCRMI and security capabilities such as PKI and encryption for ensuring secure transactions between J2ME programs and a security element SE Security Element A smart card or other item that provides secure storage of private keys certificates digital signatures and user data ...

Page 19: ... CRef 5 D Downloading Supporting Software 2 I internal config File 6 J Java 2 Standard Edition 2 Java Card Development Kit 2 S SATSA Reference Implementation 3 Supporting Software Downloading 2 system config File 7 V Variables 2 ...

Page 20: ...12 SATSA Installation Guide July 2004 ...

Reviews: