ESYAE-imza Kütüphaneleri

Bu sayfa salt okunur. Kaynağı görebilirsiniz ama değiştiremezsiniz. Bunun yanlış olduğunu düşünüyorsanız yöneticiye danışın.

<h2>Configuration</h2> <div class="level2"> <p> ESYA Smartcard API uses configuration file in order to </p> <ol> <li class="level1"> define a new card type</li> <li class="level8"> specify a card driver</li> <li class="level8"> add new ATR values to existing card types, which are used to detect card.</li> </ol> <p> The configuration file is <code>smartcard-config.xml</code> and distributed within the API package. Initial values are set in this file and these initial values are also embedded in the API source. If no new card configuration exists, then there is no need to use the configuration file. </p> <p> If the configuration file is modified, then it must be read via <code>SmartCardConfigParser</code> and the class <code>CardType</code> must be configured accordingly. </p> <p> Sample Code: Using the configuration file <code>smartcard-config.xml</code> . <em><</em>sxh java> </p> <pre class="code"> List&lt;CardTypeConfig&gt; cards = new SmartCardConfigParser().readConfig(); CardType.applyCardTypeConfig(cards); </pre><p> </p> <p> <em><</em>/sxh> </p> <p> If the configuration file has different name or it is at some other location then the method which is taking <code>InputStream</code> of <code>SmartCardConfigParser</code> can be used. </p> <p> <em><</em>sxh java> </p> <pre class="code"> List&lt;CardTypeConfig&gt; cards = new SmartCardConfigParser().readConfig(inputStream); CardType.applyCardTypeConfig(cards); </pre><p> </p> <p> <em><</em>/sxh> </p> </div> <h3>Defining a New Card Type</h3> <div class="level3"> <p> A sample card definition is as follows: <em><</em>sxh xml> <em><</em>card-type name="AKIS"> </p> <pre class="code"> &lt;lib name="akisp11"/&gt; &lt;atr value="3BBA11008131FE4D55454B41452056312E30AE"/&gt; &lt;atr value="3B9F968131FE45806755454B41451112318073B3A180E9"/&gt; ... </pre><p> </p> <p> <em><</em>/card-type> <em><</em>/sxh> </p> <p> <code><em><</em>card-type></code> defines the new card type. <code><em><</em>lib></code> specifies the operationg system specific driver of the card. If 32 bit and 64 bit platforms requires different driver this seperation is indicated as follows: <em><</em>sxh xml> </p> <pre class="code"> &lt;card-type name="NCIPHER"&gt; &lt;lib name="cknfast" arch="32"/&gt; &lt;lib name="cknfast-64" arch="64"/&gt; </pre><p> </p> <p> <em><</em>/sxh> </p> </div> <h3>ATR Değeri</h3> <div class="level3"> <p> To detect the card type you need to know the ATR (Answer To Reset) value of the card. As defined in the communication protocol of the card, it sends out a byte sequence when it is reset. If this byte sequence is known and it includes a unique information for a specific card then the card type is detected. For all known ATR sequences there must be an <code><em><</em>atr></code> element in <code><em><</em>card-type></code> in the configuration file. </p> <p> To retrieve ATR value from a card with Java, you can use the code segment below. The code simply prints out the ATR of the smartcard in the first reader. <em><</em>sxh java;title:Java> Card card = TerminalFactory.getDefault().terminals().list().get(0).connect("*"); ATR atr = card.getATR(); String historicalBytesStr = StringUtil.toString(atr.getHistoricalBytes()); System.out.println("historical bytes >"+historicalBytesStr); String atrHex = StringUtil.toString(card.getATR().getBytes()); System.out.println("ATR >"+atrHex); <em><</em>/sxh> </p> </div>