appendix-b.html

Smart Card Developer s Kit, a smart card manual for development, English

<TR>
<TD VALIGN="TOP">3-byte numeric value to be added on to the current record
<TD>The first 6 bytes of the encryption of the response to the immediately preceding <TT>Get Challenge</TT> command if the directory in which the file is being created specifies protected-mode authentication for the <TT>Create File</TT> command
<TR>
<TD COLSPAN="2"><HR>
</TABLE>
<P><FONT SIZE="+1"><B>Response Application Protocol Data Unit</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH ALIGN="LEFT">Response
<TR>
<TD><HR>
<TR>
<TD>2-byte status
<TR>
<TD><HR>
</TABLE>
<P><FONT SIZE="+1"><B>Example of Use</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH WIDTH="45%" ALIGN="LEFT">APDU
<TH WIDTH="55%" ALIGN="LEFT">Interpretation
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD VALIGN="TOP">F0<SUB>16</SUB> 32<SUB>16</SUB> 00<SUB>16</SUB> 00<SUB>16</SUB> 03<SUB>16</SUB> 00<SUB>16</SUB> 00<SUB>16</SUB> 02<SUB>16</SUB>
<TD>Add 2 to the value in the last 6 bytes of the current record in the currently selected cyclic file and write the record thereby created over the record previous to the current one in the cyclic file; make this overwritten record the current record
<TR>
<TD COLSPAN="2"><HR>
</TABLE>
<P><FONT SIZE="+1"><B>Status Word Return</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH WIDTH="20%" ALIGN="LEFT">Value
<TH WIDTH="80%" ALIGN="LEFT">Description
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD VALIGN="TOP">61XX<SUB>16</SUB>
<TD>Command executed successfully; XX<SUB>16</SUB> bytes of response data are available
<TR>
<TD>6283<SUB>16</SUB>
<TD>Currently selected file is invalidated
<TR>
<TD>6300<SUB>16</SUB>
<TD>Invalid protected-mode cryptogram
<TR>
<TD>6500<SUB>16</SUB>
<TD>Too much data for protected-mode
<TR>
<TD>6581<SUB>16</SUB>
<TD>Update impossible
<TR>
<TD>67XX<SUB>16</SUB>
<TD>Incorrect Parameter 3 value; expected value was XX<SUB>16</SUB>
<TR>
<TD>6981<SUB>16</SUB>
<TD>No PIN or key defined
<TR>
<TD>6986<SUB>16</SUB>
<TD>Currently selected file is not an elementary file
<TR>
<TD>6A80<SUB>16</SUB>
<TD>Type of currently selected file is inconsistent with the instruction
<TR>
<TD>6D00<SUB>16</SUB>
<TD>Unknown INS
<TR>
<TD>6E00<SUB>16</SUB>
<TD>Unknown CLA
<TR>
<TD>6F00<SUB>16</SUB>
<TD>Internal problem with no additional information given
<TR>
<TD VALIGN="TOP">9850<SUB>16</SUB>
<TD>Increase cannot be performed; new value would be greater than maximum value
<TR>
<TD COLSPAN="2"><HR>
</TABLE>
<H3><A NAME="Heading11"></A><FONT COLOR="#000077">Internal Authentication</FONT></H3>
<P><FONT SIZE="+1"><B>Description</B></FONT></P>
<P>The terminal wishes to authenticate the card to ensure it is a valid card, so it sends the card a challenge that the card must encrypt using a specified key in the internal authorization file (0001<SUB>16</SUB>) for the current directory. A following <TT>Get Response</TT> command returns the first 6 bytes of the card&#146;s encryption of the challenge using the indicated key.</P>
<P><FONT SIZE="+1"><B>Command Application Protocol Data Unit</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH WIDTH="10%" ALIGN="LEFT">CLA
<TH WIDTH="10%" ALIGN="LEFT">INS
<TH WIDTH="20%" ALIGN="LEFT">Parameter 1
<TH WIDTH="20%" ALIGN="LEFT">Parameter 2
<TH WIDTH="40%" ALIGN="LEFT">Parameter 3
<TR>
<TD COLSPAN="5"><HR>
<TR>
<TD VALIGN="TOP">C0<SUB>16</SUB>
<TD VALIGN="TOP">88<SUB>16</SUB>
<TD VALIGN="TOP">00<SUB>16</SUB>
<TD>Key number:<BR>00<SUB>16</SUB>, 01<SUB>16</SUB>, 02<SUB>16</SUB>, ..., 09<SUB>16</SUB>, 0A<SUB>16</SUB>, ..., 0E<SUB>16</SUB>, 0F<SUB>16</SUB>
<TD VALIGN="TOP">08<SUB>16</SUB>
<TR>
<TD COLSPAN="5"><HR>
</TABLE>
<P>
</P>
<TABLE WIDTH="100%"><TR>
<TH ALIGN="LEFT">Data Field 1
<TH ALIGN="LEFT">Data Field 2
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD>8-byte challenge
<TD>N/A
<TR>
<TD COLSPAN="2"><HR>
</TABLE>
<P><FONT SIZE="+1"><B>Response Application Protocol Data Unit</B></FONT></P>
<TABLE WIDTH="100%">
<TH WIDTH="20%"ALIGN="LEFT">Response
<TR>
<TD><HR>
<TR>
<TD>2-byte status
<TR>
<TD><HR>
</TABLE>
<P><FONT SIZE="+1"><B>Example of Use</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH WIDTH="35%" ALIGN="LEFT">APDU
<TH ALIGN="LEFT">Interpretation
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD VALIGN="TOP">C0<SUB>16</SUB> 88<SUB>16</SUB> 00<SUB>16</SUB> 03<SUB>16</SUB> 08<SUB>16</SUB> 64<SUB>16</SUB> 69<SUB>16</SUB> 73<SUB>16</SUB> 6B<SUB>16</SUB> 65<SUB>16</SUB> 74<SUB>16</SUB> 74<SUB>16</SUB> 65<SUB>16</SUB>
<TD>The terminal sends the challenge <TT>diskette</TT> to the card and expects it to be encrypted with key 3 in the internal authorization key file (0001<SUB>16</SUB>) associated with the current directory
<TR>
<TD COLSPAN="2"><HR>
</TABLE>
<P><FONT SIZE="+1"><B>Status Word Return</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH WIDTH="20%" ALIGN="LEFT">Value
<TH WIDTH="80%" ALIGN="LEFT">Description
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD VALIGN="TOP">61XX<SUB>16</SUB>
<TD>Command executed successfully; XX<SUB>16</SUB> bytes of response data are available
<TR>
<TD>67XX<SUB>16</SUB>
<TD>Incorrect Parameter 3 value; expected value was XX<SUB>16</SUB>
<TR>
<TD>6981<SUB>16</SUB>
<TD>No PIN or key defined
<TR>
<TD>6982<SUB>16</SUB>
<TD>Access condition not fulfilled
<TR>
<TD>6B00<SUB>16</SUB>
<TD>Incorrect Parameter 1 or Parameter 2
<TR>
<TD>6D00<SUB>16</SUB>
<TD>Unknown INS
<TR>
<TD>6E00<SUB>16</SUB>
<TD>Unknown CLA
<TR>
<TD>6F00<SUB>16</SUB>
<TD>Internal problem with no additional information given
<TR>
<TD COLSPAN="2"><HR>
</TABLE>
<H3><A NAME="Heading12"></A><FONT COLOR="#000077">Invalidate</FONT></H3>
<P><FONT SIZE="+1"><B>Description</B></FONT></P>
<P>The currently selected elementary file is invalidated and will subsequently only respond successfully to the <TT>Select File</TT> and <TT>Rehabilitate</TT> commands.</P>
<P><FONT SIZE="+1"><B>Command Application Protocol Data Unit</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH WIDTH="10%" ALIGN="LEFT">CLA
<TH WIDTH="10%" ALIGN="LEFT">INS
<TH WIDTH="20%" ALIGN="LEFT">Parameter 1
<TH WIDTH="20%" ALIGN="LEFT">Parameter 2
<TH WIDTH="40%" ALIGN="LEFT">Parameter 3
<TR>
<TD COLSPAN="5"><HR>
<TR>
<TD VALIGN="TOP">F0<SUB>16</SUB>
<TD VALIGN="TOP">04<SUB>16</SUB>
<TD VALIGN="TOP">00<SUB>16</SUB>
<TD VALIGN="TOP">00<SUB>16</SUB>
<TD>00<SUB>16</SUB> if issuing the <TT>Invalidate</TT> command for this file does not require protected-mode access;<BR>or<BR>06<SUB>16</SUB>, the length of the following cryptogram, if it does
<TR>
<TD COLSPAN="5"><HR>
</TABLE>
<TABLE WIDTH="100%">
<TR>
<TH WIDTH="60%" ALIGN="LEFT">Data Field 1
<TH ALIGN="LEFT">Data Field 2
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD VALIGN="TOP">The first 6 bytes of the encryption of response to immediately preceding <TT>Get Challenge</TT> command if the currently selected file requires protected-mode authentication for this command
<TD VALIGN="TOP">N/A
<TR>
<TD COLSPAN="2"><HR>
</TABLE>
<P><FONT SIZE="+1"><B>Response Application Protocol Data Unit</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH ALIGN="LEFT">Response
<TR>
<TD><HR>
<TR>
<TD>2-byte status
<TR>
<TD><HR>
</TABLE>
<P><FONT SIZE="+1"><B>Example of Use</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH WIDTH="40%" ALIGN="LEFT">APDU
<TH WIDTH="60%" ALIGN="LEFT">Interpretation
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD VALIGN="TOP">F0<SUB>16</SUB> 04<SUB>16</SUB> 00<SUB>16</SUB> 00<SUB>16</SUB> 00<SUB>16</SUB>
<TD>The currently selected file which does not require protected-mode authentication to be invalidated is invalidated
<TR>
<TD COLSPAN="2"><HR>
</TABLE>
<P><FONT SIZE="+1"><B>Status Word Return</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH WIDTH="20%" ALIGN="LEFT">Value
<TH WIDTH="80%" ALIGN="LEFT">Description
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD>6283<SUB>16</SUB>
<TD>Current file is already invalidated
<TR>
<TD>6300<SUB>16</SUB>
<TD>Invalid protected-mode cryptogram
<TR>
<TD>6581<SUB>16</SUB>
<TD>Memory problem
<TR>
<TD>67XX<SUB>16</SUB>
<TD>Incorrect Parameter 3 value; expected value was XX<SUB>16</SUB>
<TR>
<TD>6981<SUB>16</SUB>
<TD>No PIN or key defined
<TR>
<TD>6982<SUB>16</SUB>
<TD>Access condition not fulfilled
<TR>
<TD>6985<SUB>16</SUB>
<TD>No <TT>Get Challenge</TT> immediately preceding command
<TR>
<TD>6986<SUB>16</SUB>
<TD>No file selected
<TR>
<TD>6D00<SUB>16</SUB>
<TD>Unknown INS
<TR>
<TD>6E00<SUB>16</SUB>
<TD>Unknown CLA
<TR>
<TD>6F00<SUB>16</SUB>
<TD>Internal problem with no additional information given
<TR>
<TD>9000<SUB>16</SUB>
<TD>Command executed successfully
<TR>
<TD COLSPAN="2"><HR>
</TABLE>
<H3><A NAME="Heading13"></A><FONT COLOR="#000077">Read Binary</FONT></H3>
<P><FONT SIZE="+1"><B>Description</B></FONT></P>
<P>Reads a sequence of bytes from the currently selected transparent file.
</P>
<P><FONT SIZE="+1"><B>Command Application Protocol Data Unit</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH WIDTH="10%" ALIGN="LEFT">CLA
<TH WIDTH="10%" ALIGN="LEFT">INS
<TH WIDTH="18%" ALIGN="LEFT">Parameter 1
<TH WIDTH="18%" ALIGN="LEFT">Parameter 2
<TH ALIGN="LEFT">Parameter 3
<TR>
<TD COLSPAN="5"><HR>
<TR>
<TD VALIGN="TOP">C0<SUB>16</SUB>
<TD VALIGN="TOP">B0<SUB>16</SUB>
<TD>High byte of the 2-byte offset number
<TD>Low byte of the 2-byte offset number
<TD VALIGN="TOP">Number of bytes to read starting at the offset byte
<TR>
<TD COLSPAN="5"><HR>
</TABLE>
<P>
</P>
<TABLE WIDTH="100%"><TR>
<TH ALIGN="LEFT">Data Field 1
<TH ALIGN="LEFT">Data Field 2
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD>N/A
<TD>N/A
<TR>
<TD COLSPAN="2"><HR>
</TABLE>
<P><FONT SIZE="+1"><B>Response Application Protocol Data Unit</B></FONT></P>
<TABLE WIDTH="100%">
<TH WIDTH="20" ALIGN="LEFT">Response
<TR>
<TD><HR>
<TR>
<TD>The number of bytes requested followed by the 2-byte status
<TR>
<TD><HR>
</TABLE>
<P><FONT SIZE="+1"><B>Example of Use</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH WIDTH="40%" ALIGN="LEFT">APDU
<TH WIDTH="60%" ALIGN="LEFT">Interpretation
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD VALIGN="TOP">C0<SUB>16</SUB> B0<SUB>16</SUB> 00<SUB>16</SUB> 00<SUB>16</SUB> 10<SUB>16</SUB>
<TD>Read 16 bytes from the currently selected transparent file starting with the first byte in the file
<TR>
<TD COLSPAN="2"><HR>
</TABLE>
<P><FONT SIZE="+1"><B>Status Word Return</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH WIDTH="20%" ALIGN="LEFT">Value
<TH WIDTH="80%" ALIGN="LEFT">Description
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD>6283<SUB>16</SUB>
<TD>Currently selected file is invalidated
<TR>
<TD>6300<SUB>16</SUB>
<TD>Invalid protected-mode cryptogram
<TR>
<TD>6581<SUB>16</SUB>
<TD>Memory problem
<TR>
<TD>67XX<SUB>16</SUB>
<TD>Incorrect Parameter 3 value; expected value was XX<SUB>16</SUB>
<TR>
<TD>6981<SUB>16</SUB>
<TD>No PIN or key defined
<TR>
<TD>6986<SUB>16</SUB>
<TD>No currently selected elementary file
<TR>
<TD>6A80<SUB>16</SUB>
<TD>Current file type is inconsistent with the instruction
<TR>
<TD>6B00<SUB>16</SUB>
<TD>Offset out of range
<TR>
<TD>6D00<SUB>16</SUB>
<TD>Unknown INS
<TR>
<TD>6E00<SUB>16</SUB>
<TD>Unknown CLA
<TR>
<TD>6F00<SUB>16</SUB>
<TD>Internal problem with no additional information given
<TR>
<TD>9000<SUB>16</SUB>
<TD>Command executed successfully
<TR>
<TD COLSPAN="2"><HR>
</TABLE>
<H3><A NAME="Heading14"></A><FONT COLOR="#000077">Read Record</FONT></H3>
<P><FONT SIZE="+1"><B>Description</B></FONT></P>
<P>Reads one record from the currently selected record file.
</P>
<P><FONT SIZE="+1"><B>Command Application Protocol Data Unit</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH WIDTH="10%" ALIGN="LEFT">CLA
<TH WIDTH="10%" ALIGN="LEFT">INS
<TH WIDTH="20%" ALIGN="LEFT">Parameter 1
<TH WIDTH="20%" ALIGN="LEFT">Parameter 2
<TH ALIGN="LEFT">Parameter 3
<TR>
<TD COLSPAN="5"><HR>
<TR>
<TD VALIGN="TOP">C0<SUB>16</SUB>
<TD VALIGN="TOP">B2<SUB>16</SUB>
<TD VALIGN="TOP">Index of the record to be read (01<SUB>16</SUB>, 02<SUB>16</SUB>, ..., FF<SUB>16</SUB>) OR 00<SUB>16</SUB> if the current record is to be read
<TD>Selection of record to be read: 00 first record; 01 last record; 02 next record; 03 previous record; 04 current record; if index is 0 or index record, if it isn&#146;t
<TD VALIGN="TOP">The number of bytes to be read from the record identified by Parameter 1 and Parameter 2; must be equal to the length of the record in the file
<TR>
<TD COLSPAN="5"><HR>
</TABLE>
<P>
</P>
<TABLE WIDTH="100%"><TR>
<TH ALIGN="LEFT">Data Field 1
<TH ALIGN="LEFT">Data Field 2
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD>N/A
<TD>N/A
<TR>
<TD COLSPAN="2"><HR>
</TABLE>
<P><FONT SIZE="+1"><B>Response Application Protocol Data Unit</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH ALIGN="LEFT">Response
<TR>
<TD><HR>
<TR>
<TD>The number of bytes in the record if the command is successful followed by the usual byte status
<TR>
<TD><HR>
</TABLE>
<P><FONT SIZE="+1"><B>Example of Use</B></FONT></P>
<TABLE WIDTH="100%">
<TR>
<TH WIDTH="40%" ALIGN="LEFT">APDU
<TH WIDTH="60%" ALIGN="LEFT">Interpretation
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD VALIGN="TOP">C0<SUB>16</SUB> B2<SUB>16</SUB> 06<SUB>16</SUB> 04<SUB>16</SUB> 14<SUB>16</SUB>