aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorpetrs2016-09-09 15:05:25 +0200
committerGitHub2016-09-09 15:05:25 +0200
commitcb661b56ba05f5c08eeb12f23a18b20d89ac4c3c (patch)
treed5df5357edca42cc7b204a855064b99f563ffee0
parent73206ddb81584f6710f45e81a8a6d19acd608901 (diff)
downloadECTester-cb661b56ba05f5c08eeb12f23a18b20d89ac4c3c.tar.gz
ECTester-cb661b56ba05f5c08eeb12f23a18b20d89ac4c3c.tar.zst
ECTester-cb661b56ba05f5c08eeb12f23a18b20d89ac4c3c.zip
-rw-r--r--README.md29
1 files changed, 24 insertions, 5 deletions
diff --git a/README.md b/README.md
index b9868be..82d5cc7 100644
--- a/README.md
+++ b/README.md
@@ -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
@@ -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
+