From 761ebdf7fa5bd184f2482d4619c4a5ff2eefd7d9 Mon Sep 17 00:00:00 2001 From: petrs Date: Fri, 9 Sep 2016 14:40:49 +0200 Subject: Update README.md --- README.md | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index acab143..91f3805 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,16 @@ -# ECTester -Tester of Eliptic curves support on smartcards with JavaCard platform +ECTester +======= + +Tests support and behavior of smartcards with JavaCard platform with focus on Eliptic curves (TYPE_EC_FP and TYPE_EC_F2M). +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 + +Following operations are tested: + Allocation of new KeyPair class for specified parameters + Generation of keypair with default curve + Setting of custom curve and keypair generation + 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 -- cgit v1.2.3-70-g09d2 From 8a842fb6f65a29c5067647c9d7f92dea893c7f8a Mon Sep 17 00:00:00 2001 From: petrs Date: Fri, 9 Sep 2016 14:41:57 +0200 Subject: Update README.md --- README.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 91f3805..4f99c55 100644 --- a/README.md +++ b/README.md @@ -2,15 +2,19 @@ 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) + 2. Run java -jar SimpleAPDU.jar + 3. Inspect output log with annotated results Following operations are tested: - Allocation of new KeyPair class for specified parameters - Generation of keypair with default curve - Setting of custom curve and keypair generation - Generation of shared secret via ECDH - Behavior of card when invalid curves/points are provided (shoudl fail) +- Allocation of new KeyPair class for specified parameters +- Generation of keypair with default curve +- Setting of custom curve and keypair generation +- 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 -- cgit v1.2.3-70-g09d2 From 73206ddb81584f6710f45e81a8a6d19acd608901 Mon Sep 17 00:00:00 2001 From: petrs Date: Fri, 9 Sep 2016 14:42:20 +0200 Subject: Update README.md --- README.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/README.md b/README.md index 4f99c55..b9868be 100644 --- a/README.md +++ b/README.md @@ -4,10 +4,9 @@ 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) +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 Following operations are tested: -- cgit v1.2.3-70-g09d2 From cb661b56ba05f5c08eeb12f23a18b20d89ac4c3c Mon Sep 17 00:00:00 2001 From: petrs Date: Fri, 9 Sep 2016 15:05:25 +0200 Subject: Update README.md --- README.md | 29 ++++++++++++++++++++++++----- 1 file 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 + -- cgit v1.2.3-70-g09d2