289 lines
14 KiB
HTML
289 lines
14 KiB
HTML
<!DOCTYPE html>
|
|
|
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
|
|
<title>Remote Smart Card Reader — vsmartcard 2017-01-08 documentation</title>
|
|
|
|
<link rel="stylesheet" href="../_static/basic.css" type="text/css" />
|
|
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
|
<link rel="stylesheet" href="../_static/bootswatch-3.3.4/flatly/bootstrap.min.css" type="text/css" />
|
|
<link rel="stylesheet" href="../_static/bootstrap-sphinx.css" type="text/css" />
|
|
|
|
<script type="text/javascript">
|
|
var DOCUMENTATION_OPTIONS = {
|
|
URL_ROOT: '../',
|
|
VERSION: '2017-01-08',
|
|
COLLAPSE_INDEX: false,
|
|
FILE_SUFFIX: '.html',
|
|
HAS_SOURCE: true
|
|
};
|
|
</script>
|
|
<script type="text/javascript" src="../_static/jquery.js"></script>
|
|
<script type="text/javascript" src="../_static/underscore.js"></script>
|
|
<script type="text/javascript" src="../_static/doctools.js"></script>
|
|
<script type="text/javascript" src="../_static/js/jquery-1.11.0.min.js"></script>
|
|
<script type="text/javascript" src="../_static/js/jquery-fix.js"></script>
|
|
<script type="text/javascript" src="../_static/bootstrap-3.3.4/js/bootstrap.min.js"></script>
|
|
<script type="text/javascript" src="../_static/bootstrap-sphinx.js"></script>
|
|
<link rel="shortcut icon" href="../_static/chip.ico"/>
|
|
<link rel="top" title="vsmartcard 2017-01-08 documentation" href="../index.html" />
|
|
<link rel="next" title="Android Smart Card Emulator" href="../ACardEmulator/README.html" />
|
|
<link rel="prev" title="Virtual Smart Card" href="../virtualsmartcard/README.html" />
|
|
<meta charset='utf-8'>
|
|
<meta http-equiv='X-UA-Compatible' content='IE=edge,chrome=1'>
|
|
<meta name='viewport' content='width=device-width, initial-scale=1.0, maximum-scale=1'>
|
|
<meta name="apple-mobile-web-app-capable" content="yes">
|
|
|
|
</head>
|
|
<body role="document">
|
|
|
|
<a href="https://github.com/frankmorgner/vsmartcard"
|
|
class="visible-desktop hidden-xs"><img
|
|
id="gh-banner"
|
|
style="position: absolute; top: 50px; right: 0; border: 0;"
|
|
src="https://s3.amazonaws.com/github/ribbons/forkme_right_white_ffffff.png"
|
|
alt="Fork me on GitHub"></a>
|
|
<script>
|
|
// Adjust banner height.
|
|
$(function () {
|
|
var navHeight = $(".navbar .container").css("height");
|
|
$("#gh-banner").css("top", navHeight);
|
|
});
|
|
</script>
|
|
|
|
|
|
<div id="navbar" class="navbar navbar-default ">
|
|
<div class="container">
|
|
<div class="navbar-header">
|
|
<!-- .btn-navbar is used as the toggle for collapsed navbar content -->
|
|
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".nav-collapse">
|
|
<span class="icon-bar"></span>
|
|
<span class="icon-bar"></span>
|
|
<span class="icon-bar"></span>
|
|
</button>
|
|
<a class="navbar-brand" href="../index.html">
|
|
vsmartcard</a>
|
|
<span class="navbar-text navbar-version pull-left"><b></b></span>
|
|
</div>
|
|
|
|
<div class="collapse navbar-collapse nav-collapse">
|
|
<ul class="nav navbar-nav">
|
|
|
|
|
|
<li class="dropdown globaltoc-container">
|
|
<a role="button"
|
|
id="dLabelGlobalToc"
|
|
data-toggle="dropdown"
|
|
data-target="#"
|
|
href="../index.html">Site <b class="caret"></b></a>
|
|
<ul class="dropdown-menu globaltoc"
|
|
role="menu"
|
|
aria-labelledby="dLabelGlobalToc"><ul class="current">
|
|
<li class="toctree-l1"><a class="reference internal" href="../virtualsmartcard/README.html">Virtual Smart Card</a></li>
|
|
<li class="toctree-l1 current"><a class="current reference internal" href="">Remote Smart Card Reader</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../ACardEmulator/README.html">Android Smart Card Emulator</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../pcsc-relay/README.html">PC/SC Relay</a></li>
|
|
<li class="toctree-l1"><a class="reference internal" href="../ccid/README.html">USB CCID Emulator</a></li>
|
|
</ul>
|
|
<ul>
|
|
<li class="toctree-l1"><a class="reference internal" href="../virtualsmartcard/api.html">Creating a Virtual Smart Card</a></li>
|
|
</ul>
|
|
</ul>
|
|
</li>
|
|
|
|
<li class="dropdown">
|
|
<a role="button"
|
|
id="dLabelLocalToc"
|
|
data-toggle="dropdown"
|
|
data-target="#"
|
|
href="#">Page <b class="caret"></b></a>
|
|
<ul class="dropdown-menu localtoc"
|
|
role="menu"
|
|
aria-labelledby="dLabelLocalToc"><ul>
|
|
<li><a class="reference internal" href="#">Remote Smart Card Reader</a><ul>
|
|
<li><a class="reference internal" href="#download-and-install">Download and Install</a></li>
|
|
<li><a class="reference internal" href="#question">Question</a></li>
|
|
<li><a class="reference internal" href="#notes-and-references">Notes and References</a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<li>
|
|
<a href="../virtualsmartcard/README.html" title="Previous Chapter: Virtual Smart Card"><span class="glyphicon glyphicon-chevron-left visible-sm"></span><span class="hidden-sm hidden-tablet">« Virtual Smart Ca...</span>
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="../ACardEmulator/README.html" title="Next Chapter: Android Smart Card Emulator"><span class="glyphicon glyphicon-chevron-right visible-sm"></span><span class="hidden-sm hidden-tablet">Android Smart Ca... »</span>
|
|
</a>
|
|
</li>
|
|
|
|
|
|
|
|
|
|
|
|
<li class="hidden-sm"></li>
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
<form class="navbar-form navbar-right" action="../search.html" method="get">
|
|
<div class="form-group">
|
|
<input type="text" name="q" class="form-control" placeholder="Search" />
|
|
</div>
|
|
<input type="hidden" name="check_keywords" value="yes" />
|
|
<input type="hidden" name="area" value="default" />
|
|
</form>
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<div class="container">
|
|
<div class="row">
|
|
<div class="col-md-12 content">
|
|
|
|
<div class="section" id="remote-smart-card-reader">
|
|
<span id="remote-reader"></span><h1>Remote Smart Card Reader<a class="headerlink" href="#remote-smart-card-reader" title="Permalink to this headline">¶</a></h1>
|
|
<div class="sidebar">
|
|
<p class="first sidebar-title">Use an Android phone as contact-less smart card reader</p>
|
|
<table class="last docutils field-list" frame="void" rules="none">
|
|
<col class="field-name" />
|
|
<col class="field-body" />
|
|
<tbody valign="top">
|
|
<tr class="field-odd field"><th class="field-name">License:</th><td class="field-body">GPL version 3</td>
|
|
</tr>
|
|
<tr class="field-even field"><th class="field-name" colspan="2">Tested Platform:</th></tr>
|
|
<tr class="field-even field"><td> </td><td class="field-body">Android, CyanogenMod</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<p>Allow a host computer to use the smartphone’s NFC hardware as contact-less
|
|
smartcard reader. On the host computer a special smart card driver, <abbr title="virtual smart card reader">vpcd</abbr>, must
|
|
be installed. The app establishes a connection to <abbr title="virtual smart card reader">vpcd</abbr> over the network when a
|
|
contact-less card is detected.</p>
|
|
<div class="figure">
|
|
<p><img src="../_images/tikz-45ae84ddba64f581420710f06ccc0cdc632a6e9b.png" alt="\input{%(wd)s/bilder/tikzstyles.tex}
|
|
\node (pcsc) [klein, aktivbox, inner xsep=.75cm, align=center] {PC/SC\\Framework};
|
|
\node (sca) [aktivbox, klein, left=.75cm of pcsc, align=center] {Smart Card\\Application};
|
|
\node (vpcd) [box, at=(pcsc.east), kleiner] {\texttt{vpcd}};
|
|
\node (phone) [right=2cm of vpcd] {\includegraphics[width=3cm]{%(wd)s/bilder/smartphone.pdf}};
|
|
\node (app) [at=(phone.center)] {\includegraphics[width=2.8cm, height=4.9cm]{%(wd)s/bilder/remote-reader.png}};
|
|
\node (card) [right=0cm of phone, rotate=45] {\includegraphics[width=2cm]{%(wd)s/bilder/smartcard.pdf}};
|
|
|
|
\begin{pgfonlayer}{background}
|
|
\node (box) [box, fit=(pcsc) (sca) (vpcd), inner ysep=1.5em] {};
|
|
\node [at=(box.north west)] {\includegraphics[width=1cm]{%(wd)s/bilder/computer-tango.pdf}};
|
|
\path[linie]
|
|
(sca) edge (pcsc)
|
|
(vpcd) edge node {\includegraphics[width=1.5cm]{%(wd)s/bilder/simplecloud.pdf}} (app)
|
|
;
|
|
\draw [rfid] (phone.center) -- (card.center) ;
|
|
\end{pgfonlayer}" /></p>
|
|
<p class="caption">Remote Smart Card Reader used to access a contact-less card</p></div><p>The Remote Smart Card Reader has the following dependencies:</p>
|
|
<ul class="simple">
|
|
<li>NFC hardware built into the smartphone</li>
|
|
<li>Android 4.4 “KitKat” or CyanogenMod 11 (or newer)</li>
|
|
<li>permissions for a data connection (communication with <abbr title="virtual smart card reader">vpcd</abbr>) and for using
|
|
NFC (communication to the card); scanning the configuration via QR code
|
|
requires permission to access the camera</li>
|
|
<li><abbr title="virtual smart card reader">vpcd</abbr> <a class="reference internal" href="../virtualsmartcard/README.html#vicc-install"><span>installed on the host computer</span></a></li>
|
|
</ul>
|
|
<p>For remotely accessing a traditional smart card reader on one computer from an
|
|
other computer, the <a class="reference internal" href="../virtualsmartcard/README.html#vicc"><span>Virtual Smart Card</span></a> in relay mode can be used:</p>
|
|
<div class="figure">
|
|
<p><img src="../_images/tikz-b656c61c22449778b2d8a4e7cff12ff17b559524.png" alt="\input{%(wd)s/bilder/tikzstyles.tex}
|
|
\node (pcsc) [klein, aktivbox, inner xsep=.75cm, align=center] {PC/SC\\Framework};
|
|
\node (sca) [aktivbox, klein, left=.75cm of pcsc, align=center] {Smart Card\\Application};
|
|
\node (vpcd) [box, at=(pcsc.east), kleiner] {\texttt{vpcd}};
|
|
\node (pcsc2) [klein, aktivbox, inner xsep=.75cm, align=center, below=2.5cm of vpcd] {PC/SC\\Framework};
|
|
\node (vicc) [aktivbox, left=1cm of pcsc2, kleiner] {\texttt{vicc -t relay}};
|
|
\node (reader) [right=1cm of pcsc2] {\includegraphics[width=2cm]{%(wd)s/bilder/my_cardreader.pdf}};
|
|
\node (card) [at=(reader.east), rotate=45] {\includegraphics[width=2cm]{%(wd)s/bilder/smartcard.pdf}};
|
|
|
|
\begin{pgfonlayer}{background}
|
|
\node (box) [box, fit=(pcsc) (sca) (vpcd), inner ysep=1.5em] {};
|
|
\node (box2) [box, fit=(vicc) (pcsc2), inner ysep=1.5em] {};
|
|
\node [at=(box.north west)] {\includegraphics[width=1cm]{%(wd)s/bilder/computer-tango.pdf}};
|
|
\node [at=(box2.north west)] {\includegraphics[width=1cm]{%(wd)s/bilder/computer-tango.pdf}};
|
|
\path[linie]
|
|
(sca) edge (pcsc)
|
|
(vpcd) edge [out=south, in=north] node {\includegraphics[width=1.5cm]{%(wd)s/bilder/simplecloud.pdf}} (vicc)
|
|
(vicc) edge (pcsc2)
|
|
(pcsc2) edge [usb] (reader.center)
|
|
;
|
|
\end{pgfonlayer}" /></p>
|
|
<p class="caption">Virtual Smart Card used in relay mode to remotely access a card</p></div><div class="admonition note">
|
|
<p class="first admonition-title">Note</p>
|
|
<p class="last">This software can actually be used in a relay attack allowing full access
|
|
to the card. We discussed the impact especially on the <a class="reference external" href="http://media.ccc.de/browse/congress/2010/27c3-4297-de-die_gesamte_technik_ist_sicher.html">Relay attack
|
|
against the German ID card</a>,
|
|
but it generally concerns <em>all</em> contact-less smart cards.</p>
|
|
</div>
|
|
<div class="section" id="download-and-install">
|
|
<h2>Download and Install<a class="headerlink" href="#download-and-install" title="Permalink to this headline">¶</a></h2>
|
|
<p>The Remote Smart Card Reader is available on <a class="reference external" href="https://f-droid.org/repository/browse/?fdid=com.vsmartcard.remotesmartcardreader.app">F-Droid</a> <a class="footnote-reference" href="#id3" id="id4">[2]</a>.</p>
|
|
<a class="reference external image-reference" href="https://f-droid.org/repository/browse/?fdid=com.vsmartcard.remotesmartcardreader.app"><img alt="Remote Smart Card Reader on F-Droid" src="../_images/remote-reader-qrcode.png" style="width: 265px; height: 265px;" /></a>
|
|
<p>To manually compile the app you need to fetch the sources:</p>
|
|
<div class="highlight-sh"><div class="highlight"><pre>git clone https://github.com/frankmorgner/vsmartcard.git
|
|
</pre></div>
|
|
</div>
|
|
<p>We use <a class="reference external" href="http://developer.android.com/sdk/installing/studio.html">Android Studio</a> <a class="footnote-reference" href="#id1" id="id2">[1]</a> to build and deploy the application. Use
|
|
<span class="menuselection">File ‣ Open</span> to select <code class="file docutils literal"><span class="pre">vsmartcard/remote-reader</span></code>.
|
|
Attach your smartphone and choose <span class="menuselection">Run ‣ Run ‘app’</span>.</p>
|
|
<p>On the host system, where the smart card at the phone’s NFC interface is relayed to,
|
|
<abbr title="virtual smart card reader">vpcd</abbr> needs to be installed. It can be installed on Windows and Unix. On the
|
|
host computer, <strong class="command">vpcd-config</strong> prints a QR code to configure the Remote
|
|
Smart Card Reader. Scan the configuration with the bar code scanner of your
|
|
choice.</p>
|
|
</div>
|
|
<div class="section" id="question">
|
|
<h2>Question<a class="headerlink" href="#question" title="Permalink to this headline">¶</a></h2>
|
|
<p>Do you have questions, suggestions or contributions? Feedback of any kind is
|
|
more than welcome! Please use our <a class="reference external" href="https://github.com/frankmorgner/vsmartcard/issues">project trackers</a>.</p>
|
|
</div>
|
|
<div class="section" id="notes-and-references">
|
|
<h2>Notes and References<a class="headerlink" href="#notes-and-references" title="Permalink to this headline">¶</a></h2>
|
|
<table class="docutils footnote" frame="void" id="id1" rules="none">
|
|
<colgroup><col class="label" /><col /></colgroup>
|
|
<tbody valign="top">
|
|
<tr><td class="label"><a class="fn-backref" href="#id2">[1]</a></td><td><a class="reference external" href="http://developer.android.com/sdk/installing/studio.html">http://developer.android.com/sdk/installing/studio.html</a></td></tr>
|
|
</tbody>
|
|
</table>
|
|
<table class="docutils footnote" frame="void" id="id3" rules="none">
|
|
<colgroup><col class="label" /><col /></colgroup>
|
|
<tbody valign="top">
|
|
<tr><td class="label"><a class="fn-backref" href="#id4">[2]</a></td><td><a class="reference external" href="https://f-droid.org/repository/browse/?fdid=com.vsmartcard.remotesmartcardreader.app">https://f-droid.org/repository/browse/?fdid=com.vsmartcard.remotesmartcardreader.app</a></td></tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</div>
|
|
|
|
|
|
</div>
|
|
|
|
</div>
|
|
</div>
|
|
<footer class="footer">
|
|
<div class="container">
|
|
<p class="pull-right">
|
|
<a href="#">Back to top</a>
|
|
|
|
</p>
|
|
<p>
|
|
© Copyright 2009-2017 by Dominik Oepen and Frank Morgner.<br/>
|
|
</p>
|
|
</div>
|
|
</footer>
|
|
</body>
|
|
</html> |