diff --git a/docs/.buildinfo b/docs/.buildinfo index e28e409..6f1ab4c 100644 --- a/docs/.buildinfo +++ b/docs/.buildinfo @@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 8e5f2a4bcebac1b2d77d5116e3094531 +config: b6c0a435aa7d2e7b87f7f3b438fbe297 tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/docs/ACardEmulator/README.html b/docs/ACardEmulator/README.html index 422f73d..4489c36 100644 --- a/docs/ACardEmulator/README.html +++ b/docs/ACardEmulator/README.html @@ -1,35 +1,23 @@ - - +
- - -The Android Smart Card Emulator allows the emulation of a contact-less smart card. -The emulator uses Android’s HCE to fetch APDUs from a contact-less reader. +The emulator uses Android’s HCE to fetch APDUs from a contact-less reader. The app allows to process the Command APDUs either by delegating them to a remote virtual smart card or by a built-in Java Card simulator. The response APDUs are then returned to the smart card reader. Together with -Tizen Smart Card Emulator it is also possible to use a smartwatch as communication +Tizen Smart Card Emulator it is also possible to use a smartwatch as communication device instead of the phone.
-With the built-in Java Card runtime of jCardSim [1] the app includes the following +
With the built-in Java Card runtime of jCardSim 1 the app includes the following Applets:
OpenPGP Applet 2 (application identifier D2760001240102000000000000010000)
OATH Applet 3 (application identifier A000000527210101)
ISO Applet 4 (application identifier F276A288BCFBA69D34F31001)
GIDS Applet 5 (application identifier A000000397425446590201)
The remote interface can be used together with the Virtual Smart Card, which allows +
The remote interface can be used together with the Virtual Smart Card, which allows emulating the following cards:
Generic ISO-7816 smart card
German electronic identity card (nPA)
Electronic passport
The remote interface can also be used together with the PC/SC Relay, +
The remote interface can also be used together with the PC/SC Relay, which allows emulating a contactless card from an existing contact-based card (by relaying the commands from PC/SC to the phone).
You may also attach your own simulation to the remote interface by implementing a simple interface through a socket communication.
-Simulate a contact-less Java Card with Android Smart Card Emulator
Simulate a contact-less smart card with a remote virtual smart card
Relaying a contact-based smart card with pcsc-relay
The Android Smart Card Emulator has the following dependencies:
+Simulate a contact-less Java Card with Android Smart Card Emulator
+Simulate a contact-less smart card with a remote virtual smart card
+Relaying a contact-based smart card with pcsc-relay
+The Android Smart Card Emulator has the following dependencies:
NFC hardware built into the smartphone for HCE
Android 4.4 “KitKat” (or newer) or CyanogenMod 11 (or newer)
permissions for a data connection (communication with Virtual Smart Card) and for using NFC (communication to the reader); scanning the configuration via -QR code requires permission to access the camera
Virtual Smart Card installed on the host computer for +using the remote interface
Please note that the currently emulated applets are verifying the PIN by transmitting it without any protection between card and terminal. You may want -to have a look at Erik Nellesson’s -Virtual Keycard [7], which uses the PACE protocol for PIN verification.
+to have a look at Erik Nellesson’s +Virtual Keycard 6, which uses the PACE protocol for PIN verification.The Android Smart Card Emulator is available on F-Droid [8].
+The Android Smart Card Emulator is available on F-Droid 7.
To manually compile the app you need to fetch the sources and initialize the submodules:
-git clone https://github.com/frankmorgner/vsmartcard.git
-cd vsmartcard
-# fetch the applets that are in the submodules
+git clone https://github.com/frankmorgner/vsmartcard.git
+cd vsmartcard
+# fetch the applets that are in the submodules
git submodule init
git submodule update
-We use Android Studio [9] to build and deploy the application. Use
-File ‣ Open to select vsmartcard/ACardEmulator.
-Attach your smartphone and choose Run ‣ Run ‘app’.
+We use Android Studio 8 to build and deploy the application. Use
+ to select vsmartcard/ACardEmulator.
+Attach your smartphone and choose .
| [1] | http://www.jcardsim.org/ |
| [2] | https://github.com/licel/jcardsim/blob/master/src/main/java/com/licel/jcardsim/samples/HelloWorldApplet.java |
| [3] | https://developers.yubico.com/ykneo-openpgp/ |
| [4] | https://developers.yubico.com/ykneo-oath/ |
| [5] | http://www.pwendland.net/IsoApplet/ |
| [6] | https://github.com/vletoux/GidsApplet |
| [7] | https://github.com/eriknellessen/Virtual-Keycard |
| [8] | https://f-droid.org/repository/browse/?fdid=com.vsmartcard.remotesmartcardreader.app |
| [9] | http://developer.android.com/sdk/installing/studio.html |
The Tizen Smart Card Emulator allows the emulation of a contact-less smart card. -The emulator uses Tizen’s HCE to fetch APDUs from a contact-less reader. -The headless Tizen service delegates the Command APDUs via Samsung’s Accessory -Protocol to the Android Smart Card Emulator. The android app processes the commands and +The emulator uses Tizen’s HCE to fetch APDUs from a contact-less reader. +The headless Tizen service delegates the Command APDUs via Samsung’s Accessory +Protocol to the Android Smart Card Emulator. The android app processes the commands and sends responses back to the contact-less reader via the Tizen Smart Card Emulator.
You may also attach your own simulation by using the Samsung Accessory Protocol for communicating with the tizen service.
-Simulate a contact-less smart card with Android Smart Card Emulator
Simulate a contact-less smart card with Android Smart Card Emulator
+To manually compile the app you need to fetch the sources and initialize the submodules:
-git clone https://github.com/frankmorgner/vsmartcard.git
+git clone https://github.com/frankmorgner/vsmartcard.git
-We use Tizen SDK [1] to build and deploy the application. Use
-Import... to select Tizen ‣ Tizen Project.
-In the next dialog choose Tizen/TCardEmulator. To be able to build and
+
We use Tizen SDK 1 to build and deploy the application. Use
+ to select .
+In the next dialog choose Tizen/TCardEmulator. To be able to build and
install the Tizen service on the smartwatch, you need to install the
-appropriate SDK extensions and register as app developer [2].
+appropriate SDK extensions and register as app developer 2.
+More usefull ressources:
+
| [1] | https://developer.tizen.org/development/tools/download |
| [2] | https://developer.tizen.org/community/tip-tech/tizen-sdk-install-guide-certificate-extensions-included |