VivoKey/vsmartcard
7
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Compromise with documentation: Include the most important parts of libnpa with

Browse Source 
breathe and reference the details with doxylink to external doxygen pages


git-svn-id: https://vsmartcard.svn.sourceforge.net/svnroot/vsmartcard@567 96b47cad-a561-4643-ad3b-153ac7d7599c
This commit is contained in:
frankmorgner
2011-10-25 19:35:29 +00:00
parent 1094a7ed22
commit 17428d2d74
10 changed files with 53 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

41
doc/npaapi.rst Normal file
View File

@@ -0,0 +1,41 @@
.. highlight:: c
****************
nPA API Overview
****************
The nPA library includes a generic implementation for Secure Messaging (SM),
which might also be used in conjunction with other cards. It is implemented to
be close to ISO 7816-8 focusing only on encoding rather than implementing
everything that is needed to get a secure channel. All cryptographic work is
done by call back functions, which should be appropriatly set for the specific
card.
Using the German identity card (neuer Personalausweis, nPA) requires user
authentication via entry of the PIN. Transmitting the PIN in plaintext is
risky, since it would be transmitted over the air and could be snooped. That's
why the PACE keyagreement is used to verify the PIN and establish an SM channel
to the nPA. :npa:`EstablishPACEChannel` does exactly that and if everything
went fine, it initializes :npa:`sm_ctx` for use of the SM channel. Now
:npa:`sm_transmit_apdu` can be used to securely transmit arbitrary APDUs to the
card. You could for example change your PIN or even continue the Extended
Access Control (EAC) with Terminal Authentication (TA) and Chit Authenitcation
(CA).
Please consider the following overview to the API as incomplete. The `Doxygen
documentation <_static/doxygen-npa/modules.html>`_ should be used as programmer's
reference since it is more detailed.
=====================
Secure Messaging (SM)
=====================
.. doxygenfile:: sm.h
==============================================================
Interface to German identity card (neuer Personalausweis, nPA)
==============================================================
.. doxygenfile:: npa.h
.. @author Frank Morgner <morgner@informatik.hu-berlin.de>