Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
petrs authored Sep 9, 2016
1 parent 73206dd commit cb661b5
Showing 1 changed file with 24 additions and 5 deletions.
29 changes: 24 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
ECTester
=======
========

Tests support and behavior of smartcards with JavaCard platform with focus on Eliptic curves (TYPE_EC_FP and TYPE_EC_F2M).

Usage:

1. Upload simpleECC.cap using your favorite tool (e.g., GlobalPlatformPro tool https://github.com/martinpaljak/GlobalPlatform)
Usage
------
1. Upload simpleECC.cap using your favorite tool (e.g., [GlobalPlatformPro tool](https://github.com/martinpaljak/GlobalPlatform))
2. Run java -jar SimpleAPDU.jar
3. Inspect output log with annotated results

Expand All @@ -16,4 +16,23 @@ Following operations are tested:
- Generation of shared secret via ECDH
- Behavior of card when invalid curves/points are provided (shoudl fail)

If you are interested in testing support for other JavaCard algorithms, please visit: JCAlgTester project: https://github.com/crocs-muni/JCAlgTest
Example output
--------------

EC type: ALG_EC_FP
EC key length (bits): 224 bits
KeyPair object allocation: OK (0x9000)
Generate key with def curve (fails if no def): fail (ILLEGAL_VALUE, 0x1)
Set valid custom curve: OK (0x9000)
Generate key with valid curve: OK (0x9000)
!!ECDH agreement with valid point: fail (0x9000)
ECDH agreement with invalid point (fail is good): fail (unknown, 0x6f00)
Set invalid custom curve (fail is good): fail (ILLEGAL_VALUE, 0x1)
Generate key with invalid curve (fail is good): fail (skipped, 0xee1)


*Explanation: ALG_EC_FP with 224b curve was tested. Is supported by card (KeyPair object allocation: OK), don't have preset default curve (Generate key with def curve: fail), custom curve can be set (Set valid custom curve: OK), new keypair can be generated (Generate key with valid curve: OK), ECDH key agreement failed to execute (ECDH agreement with valid point: fail) altough it was supposed to suceed (log line is therefore marked with !!), ECDH wil fail (expected behavior) if invalid point is provided (ECDH agreement with invalid point: fail), invalid custom curve cannot be set (expected behavior) (Set invalid custom curve: fail) and new keypair cannot be generated with invalid curve (Generate key with invalid curve: skipped) - last test was skipped as invalid curve canot be set.*


If you are interested in testing support for other JavaCard algorithms, please visit JCAlgTester project: https://github.com/crocs-muni/JCAlgTest

0 comments on commit cb661b5

Please sign in to comment.