From: Tommaso Cucinotta (cucinottasssup.it)
Date: Wed Jul 23 2003 - 14:06:07 CDT

• Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

Hi all,

a JNI port of the MuscleCard API has been developed,
allowing Java applications and Applets to access
MuscleCard supported smart-card services directly from
the Java language. See bottom for further details.

The package sources are available for download from the
Smart Sign web site:

        http://smartsign.sourceforge.net

Please, follow the links to the SF Download area, then
download the JMuscleCard-0.0.1.tar.gz tarball.

Please, submit any comments to the Smart Sign mailing
lists:

        mailto:smartsign-userslists.sourceforge.net
        mailto:smartsign-devellists.sourceforge.net

Bye,
        Tommaso.

============================================================
   JMUSCLECARD - MuscleCard API for Java
============================================================

Main developer: Alessandro Pieroni - apieronitin.it
Coordinator: Tommaso Cucinotta - cucinottasssup.it
Organization: Scuola Superiore Sant'Anna, Pisa - Italy

------------------------------------------------------------
DESCRIPTION
------------------------------------------------------------
JMuscleCard is a JNI bridge allowing Java applications and
Applets to use MuscleCard API. By using JMuscleCard it is
possible to use, directly from the Java language, all the
smart-card devices that are supported by the MuscleCard
project (e.g. JavaCard compliant devices, Cyberflex, ...).

The bridge has been kept as simple as possible, so it almost
maps one-to-one the C functions of the MuscleCard API to
Java. The two main classes are:
- the JMuscleCard class, that manages smart-card connections
   and allows listing of devices and connecting to the card.
- the MSCTokenConnection class, that handles a single
   connection to a smart-card device, allowing to manage on
   board PINs, objects and cryptographic keys.

------------------------------------------------------------
REQUIREMENTS
------------------------------------------------------------
Software
- PCSC-Lite with MuscleCard enabled
   - the PCSC-Lite driver for your smart-card reader
   - the MuscleCard driver for your smart-card
   - Note: JavaCard cards need a MuscleCard Applet instance
     on-board, and it must already have been formatted
- Java Development Kit (J2SDK)
- Java CSP (only required for the tests)

Hardware
- a smart-card reader supported by PCSC-Lite
- a smart-card supported by the MuscleCard project

------------------------------------------------------------
LICENSE OF USE
------------------------------------------------------------
This project is distributed under the terms of the GNU GPL
license. See the file COPYING for details.

------------------------------------------------------------
COMPILATION
------------------------------------------------------------
Download the package tarball, unpack it, switch to sources
directory, arrange paths in Makefile, then type 'make':

[~] tar -xzf JMuscleCard-0.0.1.tar.gz
[~] cd JMuscleCard
[~/JMuscleCard] emacs Makefile
[~/JMuscleCard] make

------------------------------------------------------------
SELF TEST
------------------------------------------------------------
There is a test program that you can launch with 'make test'.
It requires a cryptographic Java CSP to be installed on your
machine, otherwise crypto tests will fail.

WARNING: The test program creates resources on the smart card,
such as cryptographic keys. If a JavaCard device is used, with
the MuscleCard Applet, then the created keys can only be
removed by deleting and re-instantiating the Applet.

[~/JMuscleCard] make test

You should start seeing a set of 'OK'.

------------------------------------------------------------
INSTALLATION
------------------------------------------------------------
Just type 'make install'. The two dynamic libraries and the
JAR class archive are copied in the path specified on the
Makefile (defaults to /usr/local/lib).

------------------------------------------------------------
USE
------------------------------------------------------------
Just insert the "JMuscleCard.jar" archive into the classpath
when compiling an application using JMuscleCard. A line like
this:

   import JMuscleCard.*;

shall suffice to make all JMuscleCard functionalities available
to your application.

------------------------------------------------------------
DOCUMENTATION
------------------------------------------------------------
Sorry, no documentation is available at the moment. Please,
refer to the MuscleCard API specification, available on the
MUSCLE project web page: http://www.musclecard.com

--
,------------------------------------------------.
| Dr. Tommaso Cucinotta <t.cucinottasssup.it> |
>------------------------------------------------<
! Scuola Superiore di Studi Universitari !
! e Perfezionamento S.Anna !
! Pisa Italy !
`------------------------------------------------'

_______________________________________________
Muscle mailing list
Musclelists.musclecard.com
http://lists.musclecard.com/mailman/listinfo/muscle

• Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]