appendix-b.html

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

<TD>6981<SUB>16</SUB>
<TD>No PIN defined
<TR>
<TD>6983<SUB>16</SUB>
<TD>The unblocking key is blocked
<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">9000<SUB>16</SUB>
<TD>Command executed successfully; failed attempts counter set to maximum value
<TR>
<TD COLSPAN="2"><HR>
</TABLE>
<H3><A NAME="Heading19"></A><FONT COLOR="#000077">Update Binary</FONT></H3>
<P><FONT SIZE="+1"><B>Description</B></FONT></P>
<P>A sequence of bytes is written into the currently selected transparent elementary 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">D6<SUB>16</SUB>
<TD VALIGN="TOP">High byte of the 2-byte offset number
<TD VALIGN="TOP">Low byte of the 2-byte offset number
<TD>The number of bytes to be written into the file starting at the offset byte plus 6 if a protected-mode cryptogram is provided
<TD>
<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 VALIGN="TOP">The data bytes to be written into the transparent file starting at the offset byte
<TD>The first 6 bytes of the encryption of the response to the immediately preceding <TT>Get Challenge</TT> command if the currently selected file specifies protected-mode authentication for this 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="40%" ALIGN="LEFT">APDU
<TH ALIGN="LEFT">Interpretation
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD VALIGN="TOP">C0<SUB>16</SUB> D6<SUB>16</SUB> 00<SUB>16</SUB> 00<SUB>16</SUB> 17<SUB>16</SUB> FF<SUB>16</SUB> FF<SUB>16</SUB> FF<SUB>16</SUB> 31<SUB>16</SUB> 32<SUB>16</SUB> 33<SUB>16</SUB> 34<SUB>16</SUB> FF<SUB>16</SUB> FF<SUB>16</SUB> FF<SUB>16</SUB> FF<SUB>16</SUB> 03<SUB>16</SUB> 03<SUB>16</SUB> 38<SUB>16</SUB> 37<SUB>16</SUB> 36<SUB>16</SUB> 35<SUB>16</SUB> 34<SUB>16</SUB> 33<SUB>16</SUB> 32<SUB>16</SUB> 31<SUB>16</SUB> 03<SUB>16</SUB> 03<SUB>16</SUB>
<TD VALIGN="TOP">Suppose the currently selected transparent file is the PIN file (0001) in the currently selected directory; this <TT>Update Binary</TT> command sets the PIN to <TT>1234</TT> and the Unblock PIN to <TT>87654321</TT> both with tries set to 3
<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>The file at the current pointer 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>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 currently selected 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="Heading20"></A><FONT COLOR="#000077">Update Record</FONT></H3>
<P><FONT SIZE="+1"><B>Description</B></FONT></P>
<P>One record in the currently selected record file is overwritten with new data.
</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">DC<SUB>16</SUB>
<TD VALIGN="TOP">Index of the record to be overwritten (01<SUB>16</SUB>, 02<SUB>16</SUB>, ..., FF<SUB>16</SUB>) OR 0 if the current record is to be overwritten
<TD>Selection of record to be overwritten: 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 written into the record identified by Parameter 1 and Parameter 2; must be equal to the length of the record in the file; add 6 if a protected-mode cryptogram is provided
<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 VALIGN="TOP">The data bytes to be written into the record identified by Parameter 1 and Parameter 2
<TD>The first 6 bytes of the encryption of the response to the immediately preceding <TT>Get Challenge</TT> command if the currently selected file specifies protected-mode authentication for this 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="40%" ALIGN="LEFT">APDU
<TH ALIGN="LEFT">Interpretation
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD>C0<SUB>16</SUB> DC<SUB>16</SUB> 06<SUB>16</SUB> 04<SUB>16</SUB> 14<SUB>16</SUB> 53<SUB>16</SUB> 61<SUB>16</SUB> 6C<SUB>16</SUB> 6C<SUB>16</SUB> 79<SUB>16</SUB> 20<SUB>16</SUB> 47<SUB>16</SUB> 72<SUB>16</SUB> 65<SUB>16</SUB> 65<SUB>16</SUB> 6E<SUB>16</SUB> 00<SUB>16</SUB> 00<SUB>16</SUB> 00<SUB>16</SUB> 00<SUB>16</SUB> 00<SUB>16</SUB> 00<SUB>16</SUB> 00<SUB>16</SUB> 00<SUB>16</SUB> 00<SUB>16</SUB>
<TD VALIGN="TOP">The records in the selected fixed- length record file are 20 bytes long; this command writes <TT>Sally Green</TT> into the sixth record in this 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>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>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 EF selected as current
<TR>
<TD>6A80<SUB>16</SUB>
<TD>Current file type is inconsistent with the instruction
<TR>
<TD>6A83<SUB>16</SUB>
<TD>Out of range/record not found
<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>9000<SUB>16</SUB>
<TD>Command executed successfully
<TR>
<TD COLSPAN="2"><HR>
</TABLE>
<H3><A NAME="Heading21"></A><FONT COLOR="#000077">Verify PIN</FONT></H3>
<P><FONT SIZE="+1"><B>Description</B></FONT></P>
<P>Attempt to match the 8 bytes in the command with the 8-byte PIN in the PIN file for the current directory. If the match is exact, then PIN access privileges are granted.
</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>C0<SUB>16</SUB>
<TD>20<SUB>16</SUB>
<TD>00<SUB>16</SUB>
<TD>01<SUB>16</SUB>
<TD>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 PIN to be matched against the 8-byte PIN on the card
<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 ALIGN="LEFT">Interpretation
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD>C0<SUB>16</SUB> 20<SUB>16</SUB> 00<SUB>16</SUB> 01<SUB>16</SUB> 08<SUB>16</SUB> 31<SUB>16</SUB> 32<SUB>16</SUB> 33<SUB>16</SUB> 34<SUB>16</SUB> FF<SUB>16</SUB> FF<SUB>16</SUB> FF<SUB>16</SUB> FF<SUB>16</SUB>
<TD VALIGN="TOP">Presentation of the PIN code <TT>1234</TT>
<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>6300<SUB>16</SUB>
<TD>PIN authentication failed
<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 defined
<TR>
<TD>6983<SUB>16</SUB>
<TD>PIN currently blocked
<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="Heading22"></A><FONT COLOR="#000077">Verify Key</FONT></H3>
<P><FONT SIZE="+1"><B>Description</B></FONT></P>
<P>Match a byte sequence with a key in the external authorization file (0011<SUB>16</SUB>) for the current directory. If the match is exact, external authorization access privileges are granted.</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">F0<SUB>16</SUB>
<TD VALIGN="TOP">2A<SUB>16</SUB>
<TD VALIGN="TOP">00<SUB>16</SUB>
<TD>Key Number: 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">Length of the following key
<TR>
<TD COLSPAN="5"><HR>
</TABLE>
<P>
</P>
<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>Key to be presented to the external authorization file (0011<SUB>16</SUB>) for the current directory
<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 ALIGN="LEFT">Interpretation
<TR>
<TD COLSPAN="2"><HR>
<TR>
<TD>F0<SUB>16</SUB> 2A<SUB>16</SUB> 00<SUB>16</SUB> 01<SUB>16</SUB> 47<SUB>16</SUB> 46<SUB>16</SUB> 58<SUB>16</SUB> 49<SUB>16</SUB> 32<SUB>16</SUB> 56<SUB>16</SUB> 78<SUB>16</SUB> 40<SUB>16</SUB>
<TD VALIGN="TOP">Match the transportation key in the Multiflex card included in this book
<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>6300<SUB>16</SUB>
<TD>Key verify rejected
<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 key defined
<TR>
<TD>6983<SUB>16</SUB>
<TD>Key blocked
<TR>
<TD>6A82<SUB>16</SUB>
<TD>File not found
<TR>
<TD>6B00<SUB>16</SUB>
<TD>Incorrect Parameter 1 or Parameter 2
<TR>
<TD>6D00<SUB>16</SUB>
<TD>Unknown INS
<