mirror of
git://git.gnupg.org/gnupg.git
synced 2024-12-22 10:19:57 +01:00
44f977d0e3
* scd/iso7816.c (iso7816_read_binary_ext): Handle the 0x6a86 SW the same as 6b00. * scd/apdu.c (apdu_get_atr): Modify debug messages. * scd/app-p15.c (app_select_p15): Print FCI on error. (read_p15_info): Clean up diag in presence of debug options. -- Some cards return 6a86 instead of 6b00. Signed-off-by: Werner Koch <wk@gnupg.org>
1185 lines
34 KiB
C
1185 lines
34 KiB
C
/* iso7816.c - ISO 7816 commands
|
|
* Copyright (C) 2003, 2004, 2008, 2009 Free Software Foundation, Inc.
|
|
*
|
|
* This file is part of GnuPG.
|
|
*
|
|
* GnuPG is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* GnuPG is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with this program; if not, see <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#include <config.h>
|
|
#include <errno.h>
|
|
#include <stdio.h>
|
|
#include <stdlib.h>
|
|
#include <string.h>
|
|
|
|
#if defined(GNUPG_MAJOR_VERSION)
|
|
# include "scdaemon.h"
|
|
#endif /*GNUPG_MAJOR_VERSION*/
|
|
|
|
#include "iso7816.h"
|
|
#include "apdu.h"
|
|
|
|
|
|
#define CMD_SELECT_FILE 0xA4
|
|
#define CMD_SELECT_DATA 0xA5
|
|
#define CMD_VERIFY ISO7816_VERIFY
|
|
#define CMD_CHANGE_REFERENCE_DATA ISO7816_CHANGE_REFERENCE_DATA
|
|
#define CMD_RESET_RETRY_COUNTER ISO7816_RESET_RETRY_COUNTER
|
|
#define CMD_GET_DATA 0xCA
|
|
#define CMD_PUT_DATA 0xDA
|
|
#define CMD_MSE 0x22
|
|
#define CMD_PSO 0x2A
|
|
#define CMD_GENERAL_AUTHENTICATE 0x87
|
|
#define CMD_INTERNAL_AUTHENTICATE 0x88
|
|
#define CMD_GENERATE_KEYPAIR 0x47
|
|
#define CMD_GET_CHALLENGE 0x84
|
|
#define CMD_READ_BINARY 0xB0
|
|
#define CMD_READ_RECORD 0xB2
|
|
#define CMD_UPDATE_BINARY 0xD6
|
|
|
|
static gpg_error_t
|
|
map_sw (int sw)
|
|
{
|
|
gpg_err_code_t ec;
|
|
|
|
switch (sw)
|
|
{
|
|
case SW_EEPROM_FAILURE: ec = GPG_ERR_HARDWARE; break;
|
|
case SW_TERM_STATE: ec = GPG_ERR_OBJ_TERM_STATE; break;
|
|
case SW_WRONG_LENGTH: ec = GPG_ERR_INV_VALUE; break;
|
|
case SW_ACK_TIMEOUT: ec = GPG_ERR_TIMEOUT; break;
|
|
case SW_SM_NOT_SUP: ec = GPG_ERR_NOT_SUPPORTED; break;
|
|
case SW_CC_NOT_SUP: ec = GPG_ERR_NOT_SUPPORTED; break;
|
|
case SW_FILE_STRUCT: ec = GPG_ERR_CARD; break;
|
|
case SW_CHV_WRONG: ec = GPG_ERR_BAD_PIN; break;
|
|
case SW_CHV_BLOCKED: ec = GPG_ERR_PIN_BLOCKED; break;
|
|
case SW_USE_CONDITIONS: ec = GPG_ERR_USE_CONDITIONS; break;
|
|
case SW_NO_CURRENT_EF: ec = GPG_ERR_ENOENT; break;
|
|
case SW_NOT_SUPPORTED: ec = GPG_ERR_NOT_SUPPORTED; break;
|
|
case SW_BAD_PARAMETER: ec = GPG_ERR_INV_VALUE; break;
|
|
case SW_FILE_NOT_FOUND: ec = GPG_ERR_ENOENT; break;
|
|
case SW_RECORD_NOT_FOUND:ec= GPG_ERR_NOT_FOUND; break;
|
|
case SW_REF_NOT_FOUND: ec = GPG_ERR_NO_OBJ; break;
|
|
case SW_INCORRECT_P0_P1:ec = GPG_ERR_INV_VALUE; break;
|
|
case SW_BAD_P0_P1: ec = GPG_ERR_INV_VALUE; break;
|
|
case SW_EXACT_LENGTH: ec = GPG_ERR_INV_VALUE; break;
|
|
case SW_INS_NOT_SUP: ec = GPG_ERR_CARD; break;
|
|
case SW_CLA_NOT_SUP: ec = GPG_ERR_CARD; break;
|
|
case SW_SUCCESS: ec = 0; break;
|
|
|
|
case SW_HOST_OUT_OF_CORE: ec = GPG_ERR_ENOMEM; break;
|
|
case SW_HOST_INV_VALUE: ec = GPG_ERR_INV_VALUE; break;
|
|
case SW_HOST_INCOMPLETE_CARD_RESPONSE: ec = GPG_ERR_CARD; break;
|
|
case SW_HOST_NOT_SUPPORTED: ec = GPG_ERR_NOT_SUPPORTED; break;
|
|
case SW_HOST_LOCKING_FAILED: ec = GPG_ERR_BUG; break;
|
|
case SW_HOST_BUSY: ec = GPG_ERR_EBUSY; break;
|
|
case SW_HOST_NO_CARD: ec = GPG_ERR_CARD_NOT_PRESENT; break;
|
|
case SW_HOST_CARD_INACTIVE: ec = GPG_ERR_CARD_RESET; break;
|
|
case SW_HOST_CARD_IO_ERROR: ec = GPG_ERR_EIO; break;
|
|
case SW_HOST_GENERAL_ERROR: ec = GPG_ERR_GENERAL; break;
|
|
case SW_HOST_NO_READER: ec = GPG_ERR_ENODEV; break;
|
|
case SW_HOST_ABORTED: ec = GPG_ERR_INV_RESPONSE; break;
|
|
case SW_HOST_NO_PINPAD: ec = GPG_ERR_NOT_SUPPORTED; break;
|
|
case SW_HOST_CANCELLED: ec = GPG_ERR_CANCELED; break;
|
|
case SW_HOST_USB_OTHER: ec = GPG_ERR_EIO; break;
|
|
case SW_HOST_USB_IO: ec = GPG_ERR_EIO; break;
|
|
case SW_HOST_USB_ACCESS: ec = GPG_ERR_EACCES; break;
|
|
case SW_HOST_USB_NO_DEVICE: ec = GPG_ERR_ENODEV; break;
|
|
case SW_HOST_USB_BUSY: ec = GPG_ERR_EBUSY; break;
|
|
case SW_HOST_USB_TIMEOUT: ec = GPG_ERR_TIMEOUT; break;
|
|
case SW_HOST_USB_OVERFLOW: ec = GPG_ERR_EOVERFLOW; break;
|
|
case SW_HOST_UI_CANCELLED: ec = GPG_ERR_CANCELED; break;
|
|
case SW_HOST_UI_TIMEOUT: ec = GPG_ERR_TIMEOUT; break;
|
|
|
|
default:
|
|
if ((sw & 0x010000))
|
|
ec = GPG_ERR_GENERAL; /* Should not happen. */
|
|
else if ((sw & 0xff00) == SW_MORE_DATA)
|
|
ec = 0; /* This should actually never been seen here. */
|
|
else if ((sw & 0xfff0) == 0x63C0)
|
|
ec = GPG_ERR_BAD_PIN;
|
|
else
|
|
ec = GPG_ERR_CARD;
|
|
}
|
|
return gpg_error (ec);
|
|
}
|
|
|
|
/* Map a status word from the APDU layer to a gpg-error code. */
|
|
gpg_error_t
|
|
iso7816_map_sw (int sw)
|
|
{
|
|
/* All APDU functions should return 0x9000 on success but for
|
|
historical reasons of the implementation some return 0 to
|
|
indicate success. We allow for that here. */
|
|
return sw? map_sw (sw) : 0;
|
|
}
|
|
|
|
|
|
/* This function is specialized version of the SELECT FILE command.
|
|
SLOT is the card and reader as created for example by
|
|
apdu_open_reader (), AID is a buffer of size AIDLEN holding the
|
|
requested application ID. The function can't be used to enumerate
|
|
AIDs and won't return the AID on success. The return value is 0
|
|
for okay or a GPG error code. Note that ISO error codes are
|
|
internally mapped. Bit 0 of FLAGS should be set if the card does
|
|
not understand P2=0xC0. */
|
|
gpg_error_t
|
|
iso7816_select_application (int slot, const char *aid, size_t aidlen,
|
|
unsigned int flags)
|
|
{
|
|
int sw;
|
|
sw = apdu_send_simple (slot, 0, 0x00, CMD_SELECT_FILE, 4,
|
|
(flags&1)? 0 :0x0c, aidlen, aid);
|
|
return map_sw (sw);
|
|
}
|
|
|
|
|
|
/* This is the same as iso7816_select_application but may return data
|
|
* at RESULT,RESULTLEN). */
|
|
gpg_error_t
|
|
iso7816_select_application_ext (int slot, const char *aid, size_t aidlen,
|
|
unsigned int flags,
|
|
unsigned char **result, size_t *resultlen)
|
|
{
|
|
int sw;
|
|
sw = apdu_send (slot, 0, 0x00, CMD_SELECT_FILE, 4,
|
|
(flags&1)? 0:0x0c, aidlen, aid,
|
|
result, resultlen);
|
|
return map_sw (sw);
|
|
}
|
|
|
|
|
|
/* Simple MF selection as supported by some cards. */
|
|
gpg_error_t
|
|
iso7816_select_mf (int slot)
|
|
{
|
|
int sw;
|
|
|
|
sw = apdu_send_simple (slot, 0, 0x00, CMD_SELECT_FILE, 0x000, 0x0c, -1, NULL);
|
|
return map_sw (sw);
|
|
}
|
|
|
|
|
|
gpg_error_t
|
|
iso7816_select_file (int slot, int tag, int is_dir)
|
|
{
|
|
int sw, p0, p1;
|
|
unsigned char tagbuf[2];
|
|
|
|
tagbuf[0] = (tag >> 8) & 0xff;
|
|
tagbuf[1] = tag & 0xff;
|
|
|
|
p0 = (tag == 0x3F00)? 0: is_dir? 1:2;
|
|
p1 = 0x0c; /* No FC return. */
|
|
sw = apdu_send_simple (slot, 0, 0x00, CMD_SELECT_FILE,
|
|
p0, p1, 2, (char*)tagbuf );
|
|
return map_sw (sw);
|
|
}
|
|
|
|
|
|
/* Do a select file command with a direct path. If TOPDF is set, the
|
|
* actual used path is 3f00/<topdf>/<path>. */
|
|
gpg_error_t
|
|
iso7816_select_path (int slot, const unsigned short *path, size_t pathlen,
|
|
unsigned short topdf)
|
|
{
|
|
int sw, p0, p1;
|
|
unsigned char buffer[100];
|
|
int buflen = 0;
|
|
|
|
if (pathlen*2 + 2 >= sizeof buffer)
|
|
return gpg_error (GPG_ERR_TOO_LARGE);
|
|
|
|
if (topdf)
|
|
{
|
|
buffer[buflen++] = topdf >> 8;
|
|
buffer[buflen++] = topdf;
|
|
}
|
|
|
|
for (; pathlen; pathlen--, path++)
|
|
{
|
|
buffer[buflen++] = (*path >> 8);
|
|
buffer[buflen++] = *path;
|
|
}
|
|
|
|
p0 = 0x08;
|
|
p1 = 0x0c; /* No FC return. */
|
|
sw = apdu_send_simple (slot, 0, 0x00, CMD_SELECT_FILE,
|
|
p0, p1, buflen, (char*)buffer );
|
|
return map_sw (sw);
|
|
}
|
|
|
|
|
|
/* This is a private command currently only working for TCOS cards. */
|
|
gpg_error_t
|
|
iso7816_list_directory (int slot, int list_dirs,
|
|
unsigned char **result, size_t *resultlen)
|
|
{
|
|
int sw;
|
|
|
|
if (!result || !resultlen)
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
|
|
sw = apdu_send (slot, 0, 0x80, 0xAA, list_dirs? 1:2, 0, -1, NULL,
|
|
result, resultlen);
|
|
if (sw != SW_SUCCESS)
|
|
{
|
|
/* Make sure that pending buffers are released. */
|
|
xfree (*result);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
}
|
|
return map_sw (sw);
|
|
}
|
|
|
|
|
|
/* Wrapper around apdu_send. RESULT can be NULL if no result is
|
|
* expected. In addition to an gpg-error return code the actual
|
|
* status word is stored at R_SW unless that is NULL. */
|
|
gpg_error_t
|
|
iso7816_send_apdu (int slot, int extended_mode,
|
|
int class, int ins, int p0, int p1,
|
|
int lc, const void *data,
|
|
unsigned int *r_sw,
|
|
unsigned char **result, size_t *resultlen)
|
|
{
|
|
int sw;
|
|
|
|
if (result)
|
|
{
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
}
|
|
|
|
sw = apdu_send (slot, extended_mode, class, ins, p0, p1, lc, data,
|
|
result, resultlen);
|
|
if (sw != SW_SUCCESS && result)
|
|
{
|
|
/* Make sure that pending buffers are released. */
|
|
xfree (*result);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
}
|
|
if (r_sw)
|
|
*r_sw = sw;
|
|
return map_sw (sw);
|
|
}
|
|
|
|
|
|
/* This function sends an already formatted APDU to the card. With
|
|
HANDLE_MORE set to true a MORE DATA status will be handled
|
|
internally. The return value is a gpg error code (i.e. a mapped
|
|
status word). This is basically the same as apdu_send_direct but
|
|
it maps the status word and does not return it in the result
|
|
buffer. However, it R_SW is not NULL the status word is stored
|
|
R_SW for closer inspection. */
|
|
gpg_error_t
|
|
iso7816_apdu_direct (int slot, const void *apdudata, size_t apdudatalen,
|
|
int handle_more, unsigned int *r_sw,
|
|
unsigned char **result, size_t *resultlen)
|
|
{
|
|
int sw, sw2;
|
|
|
|
if (result)
|
|
{
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
}
|
|
|
|
sw = apdu_send_direct (slot, 0, apdudata, apdudatalen, handle_more,
|
|
&sw2, result, resultlen);
|
|
if (!sw)
|
|
{
|
|
if (!result)
|
|
sw = sw2;
|
|
else if (*resultlen < 2)
|
|
sw = SW_HOST_GENERAL_ERROR;
|
|
else
|
|
{
|
|
sw = ((*result)[*resultlen-2] << 8) | (*result)[*resultlen-1];
|
|
(*resultlen)--;
|
|
(*resultlen)--;
|
|
}
|
|
}
|
|
if (sw != SW_SUCCESS && result)
|
|
{
|
|
/* Make sure that pending buffers are released. */
|
|
xfree (*result);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
}
|
|
if (r_sw)
|
|
*r_sw = sw;
|
|
return map_sw (sw);
|
|
}
|
|
|
|
|
|
/* Check whether the reader supports the ISO command code COMMAND on
|
|
the pinpad. Returns 0 on success. */
|
|
gpg_error_t
|
|
iso7816_check_pinpad (int slot, int command, pininfo_t *pininfo)
|
|
{
|
|
int sw;
|
|
|
|
sw = apdu_check_pinpad (slot, command, pininfo);
|
|
return iso7816_map_sw (sw);
|
|
}
|
|
|
|
|
|
/* Perform a VERIFY command on SLOT using the card holder verification
|
|
vector CHVNO. With PININFO non-NULL the pinpad of the reader will
|
|
be used. Returns 0 on success. */
|
|
gpg_error_t
|
|
iso7816_verify_kp (int slot, int chvno, pininfo_t *pininfo)
|
|
{
|
|
int sw;
|
|
|
|
sw = apdu_pinpad_verify (slot, 0x00, CMD_VERIFY, 0, chvno, pininfo);
|
|
return map_sw (sw);
|
|
}
|
|
|
|
/* Perform a VERIFY command on SLOT using the card holder verification
|
|
vector CHVNO with a CHV of length CHVLEN. Returns 0 on success. */
|
|
gpg_error_t
|
|
iso7816_verify (int slot, int chvno, const char *chv, size_t chvlen)
|
|
{
|
|
int sw;
|
|
|
|
sw = apdu_send_simple (slot, 0, 0x00, CMD_VERIFY, 0, chvno, chvlen, chv);
|
|
return map_sw (sw);
|
|
}
|
|
|
|
|
|
/* Some cards support a VERIFY command variant to check the status of
|
|
* the the CHV without a need to try a CHV. In contrast to the other
|
|
* functions this function returns the special codes ISO7816_VERIFY_*
|
|
* or a non-negative number with the left attempts. */
|
|
int
|
|
iso7816_verify_status (int slot, int chvno)
|
|
{
|
|
unsigned char apdu[4];
|
|
unsigned int sw;
|
|
int result;
|
|
|
|
apdu[0] = 0x00;
|
|
apdu[1] = ISO7816_VERIFY;
|
|
apdu[2] = 0x00;
|
|
apdu[3] = chvno;
|
|
if (!iso7816_apdu_direct (slot, apdu, 4, 0, &sw, NULL, NULL))
|
|
result = ISO7816_VERIFY_NOT_NEEDED; /* Not returned by all cards. */
|
|
else if (sw == 0x6a88 || sw == 0x6a80)
|
|
result = ISO7816_VERIFY_NO_PIN;
|
|
else if (sw == 0x6983)
|
|
result = ISO7816_VERIFY_BLOCKED;
|
|
else if (sw == 0x6985)
|
|
result = ISO7816_VERIFY_NULLPIN; /* TCOS card */
|
|
else if ((sw & 0xfff0) == 0x63C0)
|
|
result = (sw & 0x000f);
|
|
else
|
|
result = ISO7816_VERIFY_ERROR;
|
|
|
|
return result;
|
|
}
|
|
|
|
|
|
/* Perform a CHANGE_REFERENCE_DATA command on SLOT for the card holder
|
|
verification vector CHVNO. With PININFO non-NULL the pinpad of the
|
|
reader will be used. If IS_EXCHANGE is 0, a "change reference
|
|
data" is done, otherwise an "exchange reference data". */
|
|
gpg_error_t
|
|
iso7816_change_reference_data_kp (int slot, int chvno, int is_exchange,
|
|
pininfo_t *pininfo)
|
|
{
|
|
int sw;
|
|
|
|
sw = apdu_pinpad_modify (slot, 0x00, CMD_CHANGE_REFERENCE_DATA,
|
|
is_exchange ? 1 : 0, chvno, pininfo);
|
|
return map_sw (sw);
|
|
}
|
|
|
|
/* Perform a CHANGE_REFERENCE_DATA command on SLOT for the card holder
|
|
verification vector CHVNO. If the OLDCHV is NULL (and OLDCHVLEN
|
|
0), a "change reference data" is done, otherwise an "exchange
|
|
reference data". The new reference data is expected in NEWCHV of
|
|
length NEWCHVLEN. */
|
|
gpg_error_t
|
|
iso7816_change_reference_data (int slot, int chvno,
|
|
const char *oldchv, size_t oldchvlen,
|
|
const char *newchv, size_t newchvlen)
|
|
{
|
|
int sw;
|
|
char *buf;
|
|
|
|
if ((!oldchv && oldchvlen)
|
|
|| (oldchv && !oldchvlen)
|
|
|| !newchv || !newchvlen )
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
|
|
buf = xtrymalloc (oldchvlen + newchvlen);
|
|
if (!buf)
|
|
return gpg_error (gpg_err_code_from_errno (errno));
|
|
if (oldchvlen)
|
|
memcpy (buf, oldchv, oldchvlen);
|
|
memcpy (buf+oldchvlen, newchv, newchvlen);
|
|
|
|
sw = apdu_send_simple (slot, 0, 0x00, CMD_CHANGE_REFERENCE_DATA,
|
|
oldchvlen? 0 : 1, chvno, oldchvlen+newchvlen, buf);
|
|
wipememory (buf, oldchvlen+newchvlen);
|
|
xfree (buf);
|
|
return map_sw (sw);
|
|
|
|
}
|
|
|
|
|
|
gpg_error_t
|
|
iso7816_reset_retry_counter_with_rc (int slot, int chvno,
|
|
const char *data, size_t datalen)
|
|
{
|
|
int sw;
|
|
|
|
if (!data || !datalen )
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
|
|
sw = apdu_send_simple (slot, 0, 0x00, CMD_RESET_RETRY_COUNTER,
|
|
0, chvno, datalen, data);
|
|
return map_sw (sw);
|
|
}
|
|
|
|
|
|
gpg_error_t
|
|
iso7816_reset_retry_counter (int slot, int chvno,
|
|
const char *newchv, size_t newchvlen)
|
|
{
|
|
int sw;
|
|
|
|
sw = apdu_send_simple (slot, 0, 0x00, CMD_RESET_RETRY_COUNTER,
|
|
2, chvno, newchvlen, newchv);
|
|
return map_sw (sw);
|
|
}
|
|
|
|
|
|
/* Perform a SELECT DATA command to OCCURANCE of TAG. */
|
|
gpg_error_t
|
|
iso7816_select_data (int slot, int occurrence, int tag)
|
|
{
|
|
int sw;
|
|
int datalen;
|
|
unsigned char data[7];
|
|
|
|
data[0] = 0x60;
|
|
data[2] = 0x5c;
|
|
if (tag <= 0xff)
|
|
{
|
|
data[3] = 1;
|
|
data[4] = tag;
|
|
datalen = 5;
|
|
}
|
|
else if (tag <= 0xffff)
|
|
{
|
|
data[3] = 2;
|
|
data[4] = (tag >> 8);
|
|
data[5] = tag;
|
|
datalen = 6;
|
|
}
|
|
else
|
|
{
|
|
data[3] = 3;
|
|
data[4] = (tag >> 16);
|
|
data[5] = (tag >> 8);
|
|
data[6] = tag;
|
|
datalen = 7;
|
|
}
|
|
data[1] = datalen - 2;
|
|
|
|
sw = apdu_send_le (slot, 0, 0x00, CMD_SELECT_DATA,
|
|
occurrence, 0x04, datalen, data, 0, NULL, NULL);
|
|
return map_sw (sw);
|
|
}
|
|
|
|
|
|
/* Perform a GET DATA command requesting TAG and storing the result in
|
|
a newly allocated buffer at the address passed by RESULT. Return
|
|
the length of this data at the address of RESULTLEN. */
|
|
gpg_error_t
|
|
iso7816_get_data (int slot, int extended_mode, int tag,
|
|
unsigned char **result, size_t *resultlen)
|
|
{
|
|
int sw;
|
|
int le;
|
|
|
|
if (!result || !resultlen)
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
|
|
if (extended_mode > 0 && extended_mode < 256)
|
|
le = 65534; /* Not 65535 in case it is used as some special flag. */
|
|
else if (extended_mode > 0)
|
|
le = extended_mode;
|
|
else
|
|
le = 256;
|
|
|
|
sw = apdu_send_le (slot, extended_mode, 0x00, CMD_GET_DATA,
|
|
((tag >> 8) & 0xff), (tag & 0xff), -1, NULL, le,
|
|
result, resultlen);
|
|
if (sw != SW_SUCCESS)
|
|
{
|
|
/* Make sure that pending buffers are released. */
|
|
xfree (*result);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
return map_sw (sw);
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
|
|
/* Perform a GET DATA command requesting TAG and storing the result in
|
|
* a newly allocated buffer at the address passed by RESULT. Return
|
|
* the length of this data at the address of RESULTLEN. This variant
|
|
* is needed for long (3 octet) tags. */
|
|
gpg_error_t
|
|
iso7816_get_data_odd (int slot, int extended_mode, unsigned int tag,
|
|
unsigned char **result, size_t *resultlen)
|
|
{
|
|
int sw;
|
|
int le;
|
|
int datalen;
|
|
unsigned char data[5];
|
|
|
|
if (!result || !resultlen)
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
|
|
if (extended_mode > 0 && extended_mode < 256)
|
|
le = 65534; /* Not 65535 in case it is used as some special flag. */
|
|
else if (extended_mode > 0)
|
|
le = extended_mode;
|
|
else
|
|
le = 256;
|
|
|
|
data[0] = 0x5c;
|
|
if (tag <= 0xff)
|
|
{
|
|
data[1] = 1;
|
|
data[2] = tag;
|
|
datalen = 3;
|
|
}
|
|
else if (tag <= 0xffff)
|
|
{
|
|
data[1] = 2;
|
|
data[2] = (tag >> 8);
|
|
data[3] = tag;
|
|
datalen = 4;
|
|
}
|
|
else
|
|
{
|
|
data[1] = 3;
|
|
data[2] = (tag >> 16);
|
|
data[3] = (tag >> 8);
|
|
data[4] = tag;
|
|
datalen = 5;
|
|
}
|
|
|
|
sw = apdu_send_le (slot, extended_mode, 0x00, CMD_GET_DATA + 1,
|
|
0x3f, 0xff, datalen, data, le,
|
|
result, resultlen);
|
|
if (sw != SW_SUCCESS)
|
|
{
|
|
/* Make sure that pending buffers are released. */
|
|
xfree (*result);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
return map_sw (sw);
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
|
|
/* Perform a PUT DATA command on card in SLOT. Write DATA of length
|
|
DATALEN to TAG. EXTENDED_MODE controls whether extended length
|
|
headers or command chaining is used instead of single length
|
|
bytes. */
|
|
gpg_error_t
|
|
iso7816_put_data (int slot, int extended_mode, int tag,
|
|
const void *data, size_t datalen)
|
|
{
|
|
int sw;
|
|
|
|
sw = apdu_send_simple (slot, extended_mode, 0x00, CMD_PUT_DATA,
|
|
((tag >> 8) & 0xff), (tag & 0xff),
|
|
datalen, (const char*)data);
|
|
return map_sw (sw);
|
|
}
|
|
|
|
/* Same as iso7816_put_data but uses an odd instruction byte. */
|
|
gpg_error_t
|
|
iso7816_put_data_odd (int slot, int extended_mode, int tag,
|
|
const void *data, size_t datalen)
|
|
{
|
|
int sw;
|
|
|
|
sw = apdu_send_simple (slot, extended_mode, 0x00, CMD_PUT_DATA+1,
|
|
((tag >> 8) & 0xff), (tag & 0xff),
|
|
datalen, (const char*)data);
|
|
return map_sw (sw);
|
|
}
|
|
|
|
/* Manage Security Environment. This is a weird operation and there
|
|
is no easy abstraction for it. Furthermore, some card seem to have
|
|
a different interpretation of 7816-8 and thus we resort to let the
|
|
caller decide what to do. */
|
|
gpg_error_t
|
|
iso7816_manage_security_env (int slot, int p1, int p2,
|
|
const unsigned char *data, size_t datalen)
|
|
{
|
|
int sw;
|
|
|
|
if (p1 < 0 || p1 > 255 || p2 < 0 || p2 > 255 )
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
|
|
sw = apdu_send_simple (slot, 0, 0x00, CMD_MSE, p1, p2,
|
|
data? datalen : -1, (const char*)data);
|
|
return map_sw (sw);
|
|
}
|
|
|
|
|
|
/* Perform the security operation COMPUTE DIGITAL SIGANTURE. On
|
|
success 0 is returned and the data is available in a newly
|
|
allocated buffer stored at RESULT with its length stored at
|
|
RESULTLEN. For LE see do_generate_keypair. */
|
|
gpg_error_t
|
|
iso7816_compute_ds (int slot, int extended_mode,
|
|
const unsigned char *data, size_t datalen, int le,
|
|
unsigned char **result, size_t *resultlen)
|
|
{
|
|
int sw;
|
|
|
|
if (!data || !datalen || !result || !resultlen)
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
|
|
if (!extended_mode)
|
|
le = 256; /* Ignore provided Le and use what apdu_send uses. */
|
|
else if (le >= 0 && le < 256)
|
|
le = 256;
|
|
|
|
sw = apdu_send_le (slot, extended_mode,
|
|
0x00, CMD_PSO, 0x9E, 0x9A,
|
|
datalen, (const char*)data,
|
|
le,
|
|
result, resultlen);
|
|
if (sw != SW_SUCCESS)
|
|
{
|
|
/* Make sure that pending buffers are released. */
|
|
xfree (*result);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
return map_sw (sw);
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
|
|
/* Perform the security operation DECIPHER. PADIND is the padding
|
|
indicator to be used. It should be 0 if no padding is required, a
|
|
value of -1 suppresses the padding byte. On success 0 is returned
|
|
and the plaintext is available in a newly allocated buffer stored
|
|
at RESULT with its length stored at RESULTLEN. For LE see
|
|
do_generate_keypair. */
|
|
gpg_error_t
|
|
iso7816_decipher (int slot, int extended_mode,
|
|
const unsigned char *data, size_t datalen, int le,
|
|
int padind, unsigned char **result, size_t *resultlen)
|
|
{
|
|
int sw;
|
|
unsigned char *buf;
|
|
|
|
if (!data || !datalen || !result || !resultlen)
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
|
|
if (!extended_mode)
|
|
le = 256; /* Ignore provided Le and use what apdu_send uses. */
|
|
else if (le >= 0 && le < 256)
|
|
le = 256;
|
|
|
|
if (padind >= 0)
|
|
{
|
|
/* We need to prepend the padding indicator. */
|
|
buf = xtrymalloc (datalen + 1);
|
|
if (!buf)
|
|
return gpg_error (gpg_err_code_from_errno (errno));
|
|
|
|
*buf = padind; /* Padding indicator. */
|
|
memcpy (buf+1, data, datalen);
|
|
sw = apdu_send_le (slot, extended_mode,
|
|
0x00, CMD_PSO, 0x80, 0x86,
|
|
datalen+1, (char*)buf, le,
|
|
result, resultlen);
|
|
xfree (buf);
|
|
}
|
|
else
|
|
{
|
|
sw = apdu_send_le (slot, extended_mode,
|
|
0x00, CMD_PSO, 0x80, 0x86,
|
|
datalen, (const char *)data, le,
|
|
result, resultlen);
|
|
}
|
|
if (sw != SW_SUCCESS)
|
|
{
|
|
/* Make sure that pending buffers are released. */
|
|
xfree (*result);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
return map_sw (sw);
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
|
|
/* Perform the security operation COMPUTE SHARED SECRET. On success 0
|
|
is returned and the shared secret is available in a newly allocated
|
|
buffer stored at RESULT with its length stored at RESULTLEN. For
|
|
LE see do_generate_keypair. */
|
|
gpg_error_t
|
|
iso7816_pso_csv (int slot, int extended_mode,
|
|
const unsigned char *data, size_t datalen, int le,
|
|
unsigned char **result, size_t *resultlen)
|
|
{
|
|
int sw;
|
|
unsigned char *buf;
|
|
unsigned int nbuf;
|
|
|
|
if (!data || !datalen || !result || !resultlen)
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
|
|
if (!extended_mode)
|
|
le = 256; /* Ignore provided Le and use what apdu_send uses. */
|
|
else if (le >= 0 && le < 256)
|
|
le = 256;
|
|
|
|
/* Data needs to be in BER-TLV format. */
|
|
buf = xtrymalloc (datalen + 4);
|
|
if (!buf)
|
|
return gpg_error_from_syserror ();
|
|
nbuf = 0;
|
|
buf[nbuf++] = 0x9c;
|
|
if (datalen < 128)
|
|
buf[nbuf++] = datalen;
|
|
else if (datalen < 256)
|
|
{
|
|
buf[nbuf++] = 0x81;
|
|
buf[nbuf++] = datalen;
|
|
}
|
|
else
|
|
{
|
|
buf[nbuf++] = 0x82;
|
|
buf[nbuf++] = datalen << 8;
|
|
buf[nbuf++] = datalen;
|
|
}
|
|
memcpy (buf+nbuf, data, datalen);
|
|
sw = apdu_send_le (slot, extended_mode,
|
|
0x00, CMD_PSO, 0x80, 0xa6,
|
|
datalen+nbuf, (const char *)buf, le,
|
|
result, resultlen);
|
|
xfree (buf);
|
|
if (sw != SW_SUCCESS)
|
|
{
|
|
/* Make sure that pending buffers are released. */
|
|
xfree (*result);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
return map_sw (sw);
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
|
|
/* For LE see do_generate_keypair. */
|
|
gpg_error_t
|
|
iso7816_internal_authenticate (int slot, int extended_mode,
|
|
const unsigned char *data, size_t datalen,
|
|
int le,
|
|
unsigned char **result, size_t *resultlen)
|
|
{
|
|
int sw;
|
|
|
|
if (!data || !datalen || !result || !resultlen)
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
|
|
if (!extended_mode)
|
|
le = 256; /* Ignore provided Le and use what apdu_send uses. */
|
|
else if (le >= 0 && le < 256)
|
|
le = 256;
|
|
|
|
sw = apdu_send_le (slot, extended_mode,
|
|
0x00, CMD_INTERNAL_AUTHENTICATE, 0, 0,
|
|
datalen, (const char*)data,
|
|
le,
|
|
result, resultlen);
|
|
if (sw != SW_SUCCESS)
|
|
{
|
|
/* Make sure that pending buffers are released. */
|
|
xfree (*result);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
return map_sw (sw);
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
|
|
/* For LE see do_generate_keypair. */
|
|
gpg_error_t
|
|
iso7816_general_authenticate (int slot, int extended_mode,
|
|
int algoref, int keyref,
|
|
const unsigned char *data, size_t datalen,
|
|
int le,
|
|
unsigned char **result, size_t *resultlen)
|
|
{
|
|
int sw;
|
|
|
|
if (!data || !datalen || !result || !resultlen)
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
|
|
if (!extended_mode)
|
|
le = 256; /* Ignore provided Le and use what apdu_send uses. */
|
|
else if (le >= 0 && le < 256)
|
|
le = 256;
|
|
|
|
sw = apdu_send_le (slot, extended_mode,
|
|
0x00, CMD_GENERAL_AUTHENTICATE, algoref, keyref,
|
|
datalen, (const char*)data,
|
|
le,
|
|
result, resultlen);
|
|
if (sw != SW_SUCCESS)
|
|
{
|
|
/* Make sure that pending buffers are released. */
|
|
xfree (*result);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
return map_sw (sw);
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
|
|
/* LE is the expected return length. This is usually 0 except if
|
|
extended length mode is used and more than 256 byte will be
|
|
returned. In that case a value of -1 uses a large default
|
|
(e.g. 4096 bytes), a value larger 256 used that value. */
|
|
static gpg_error_t
|
|
do_generate_keypair (int slot, int extended_mode, int p1, int p2,
|
|
const char *data, size_t datalen, int le,
|
|
unsigned char **result, size_t *resultlen)
|
|
{
|
|
int sw;
|
|
|
|
if (!data || !datalen || !result || !resultlen)
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
|
|
sw = apdu_send_le (slot, extended_mode,
|
|
0x00, CMD_GENERATE_KEYPAIR, p1, p2,
|
|
datalen, data,
|
|
le >= 0 && le < 256? 256:le,
|
|
result, resultlen);
|
|
if (sw != SW_SUCCESS)
|
|
{
|
|
/* Make sure that pending buffers are released. */
|
|
xfree (*result);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
return map_sw (sw);
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
|
|
gpg_error_t
|
|
iso7816_generate_keypair (int slot, int extended_mode, int p1, int p2,
|
|
const char *data, size_t datalen,
|
|
int le,
|
|
unsigned char **result, size_t *resultlen)
|
|
{
|
|
return do_generate_keypair (slot, extended_mode, p1, p2,
|
|
data, datalen, le, result, resultlen);
|
|
}
|
|
|
|
|
|
gpg_error_t
|
|
iso7816_read_public_key (int slot, int extended_mode,
|
|
const char *data, size_t datalen,
|
|
int le,
|
|
unsigned char **result, size_t *resultlen)
|
|
{
|
|
return do_generate_keypair (slot, extended_mode, 0x81, 0,
|
|
data, datalen, le, result, resultlen);
|
|
}
|
|
|
|
|
|
|
|
gpg_error_t
|
|
iso7816_get_challenge (int slot, int length, unsigned char *buffer)
|
|
{
|
|
int sw;
|
|
unsigned char *result;
|
|
size_t resultlen, n;
|
|
|
|
if (!buffer || length < 1)
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
|
|
do
|
|
{
|
|
result = NULL;
|
|
n = length > 254? 254 : length;
|
|
sw = apdu_send_le (slot, 0,
|
|
0x00, CMD_GET_CHALLENGE, 0, 0, -1, NULL, n,
|
|
&result, &resultlen);
|
|
if (sw != SW_SUCCESS)
|
|
{
|
|
/* Make sure that pending buffers are released. */
|
|
xfree (result);
|
|
return map_sw (sw);
|
|
}
|
|
if (resultlen > n)
|
|
resultlen = n;
|
|
memcpy (buffer, result, resultlen);
|
|
buffer += resultlen;
|
|
length -= resultlen;
|
|
xfree (result);
|
|
}
|
|
while (length > 0);
|
|
|
|
return 0;
|
|
}
|
|
|
|
/* Perform a READ BINARY command requesting a maximum of NMAX bytes
|
|
* from OFFSET. With NMAX = 0 the entire file is read. The result is
|
|
* stored in a newly allocated buffer at the address passed by RESULT.
|
|
* Returns the length of this data at the address of RESULTLEN. If
|
|
* R_SW is not NULL the last status word is stored there. */
|
|
gpg_error_t
|
|
iso7816_read_binary_ext (int slot, int extended_mode,
|
|
size_t offset, size_t nmax,
|
|
unsigned char **result, size_t *resultlen,
|
|
int *r_sw)
|
|
{
|
|
int sw;
|
|
unsigned char *buffer;
|
|
size_t bufferlen;
|
|
int read_all = !nmax;
|
|
size_t n;
|
|
|
|
if (r_sw)
|
|
*r_sw = 0;
|
|
|
|
if (!result || !resultlen)
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
|
|
/* We can only encode 15 bits in p0,p1 to indicate an offset. Thus
|
|
we check for this limit. */
|
|
if (offset > 32767)
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
|
|
do
|
|
{
|
|
buffer = NULL;
|
|
bufferlen = 0;
|
|
n = read_all? 0 : nmax;
|
|
sw = apdu_send_le (slot, extended_mode, 0x00, CMD_READ_BINARY,
|
|
((offset>>8) & 0xff), (offset & 0xff) , -1, NULL,
|
|
n, &buffer, &bufferlen);
|
|
if ( SW_EXACT_LENGTH_P(sw) )
|
|
{
|
|
n = (sw & 0x00ff);
|
|
sw = apdu_send_le (slot, extended_mode, 0x00, CMD_READ_BINARY,
|
|
((offset>>8) & 0xff), (offset & 0xff) , -1, NULL,
|
|
n, &buffer, &bufferlen);
|
|
}
|
|
if (r_sw)
|
|
*r_sw = sw;
|
|
|
|
if (*result && (sw == SW_BAD_P0_P1 || sw == SW_INCORRECT_P0_P1))
|
|
{
|
|
/* Bad Parameter means that the offset is outside of the
|
|
EF. When reading all data we take this as an indication
|
|
for EOF. */
|
|
break;
|
|
}
|
|
|
|
if (sw != SW_SUCCESS && sw != SW_EOF_REACHED)
|
|
{
|
|
/* Make sure that pending buffers are released. */
|
|
xfree (buffer);
|
|
xfree (*result);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
return map_sw (sw);
|
|
}
|
|
if (*result) /* Need to extend the buffer. */
|
|
{
|
|
unsigned char *p = xtryrealloc (*result, *resultlen + bufferlen);
|
|
if (!p)
|
|
{
|
|
gpg_error_t err = gpg_error_from_syserror ();
|
|
xfree (buffer);
|
|
xfree (*result);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
return err;
|
|
}
|
|
*result = p;
|
|
memcpy (*result + *resultlen, buffer, bufferlen);
|
|
*resultlen += bufferlen;
|
|
xfree (buffer);
|
|
buffer = NULL;
|
|
}
|
|
else /* Transfer the buffer into our result. */
|
|
{
|
|
*result = buffer;
|
|
*resultlen = bufferlen;
|
|
}
|
|
offset += bufferlen;
|
|
if (offset > 32767)
|
|
break; /* We simply truncate the result for too large
|
|
files. */
|
|
if (nmax > bufferlen)
|
|
nmax -= bufferlen;
|
|
else
|
|
nmax = 0;
|
|
}
|
|
while ((read_all && sw != SW_EOF_REACHED) || (!read_all && nmax));
|
|
|
|
return 0;
|
|
}
|
|
|
|
|
|
gpg_error_t
|
|
iso7816_read_binary (int slot, size_t offset, size_t nmax,
|
|
unsigned char **result, size_t *resultlen)
|
|
{
|
|
return iso7816_read_binary_ext (slot, 0, offset, nmax,
|
|
result, resultlen, NULL);
|
|
}
|
|
|
|
|
|
/* Perform a READ RECORD command. RECNO gives the record number to
|
|
read with 0 indicating the current record. RECCOUNT must be 1 (not
|
|
all cards support reading of more than one record). SHORT_EF
|
|
should be 0 to read the current EF or contain a short EF. The
|
|
result is stored in a newly allocated buffer at the address passed
|
|
by RESULT. Returns the length of this data at the address of
|
|
RESULTLEN. If R_SW is not NULL the last status word is stored
|
|
there. */
|
|
gpg_error_t
|
|
iso7816_read_record_ext (int slot, int recno, int reccount, int short_ef,
|
|
unsigned char **result, size_t *resultlen,
|
|
int *r_sw)
|
|
{
|
|
int sw;
|
|
unsigned char *buffer;
|
|
size_t bufferlen;
|
|
|
|
if (r_sw)
|
|
*r_sw = 0;
|
|
|
|
if (!result || !resultlen)
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
|
|
/* We can only encode 15 bits in p0,p1 to indicate an offset. Thus
|
|
we check for this limit. */
|
|
if (recno < 0 || recno > 255 || reccount != 1
|
|
|| short_ef < 0 || short_ef > 254 )
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
|
|
buffer = NULL;
|
|
bufferlen = 0;
|
|
sw = apdu_send_le (slot, 0, 0x00, CMD_READ_RECORD,
|
|
recno,
|
|
short_ef? short_ef : 0x04,
|
|
-1, NULL,
|
|
0, &buffer, &bufferlen);
|
|
if (r_sw)
|
|
*r_sw = sw;
|
|
|
|
if (sw != SW_SUCCESS && sw != SW_EOF_REACHED)
|
|
{
|
|
/* Make sure that pending buffers are released. */
|
|
xfree (buffer);
|
|
xfree (*result);
|
|
*result = NULL;
|
|
*resultlen = 0;
|
|
return map_sw (sw);
|
|
}
|
|
*result = buffer;
|
|
*resultlen = bufferlen;
|
|
|
|
return 0;
|
|
}
|
|
|
|
|
|
gpg_error_t
|
|
iso7816_read_record (int slot, int recno, int reccount, int short_ef,
|
|
unsigned char **result, size_t *resultlen)
|
|
{
|
|
return iso7816_read_record_ext (slot, recno, reccount, short_ef,
|
|
result, resultlen, NULL);
|
|
}
|
|
|
|
|
|
/* Perform an UPDATE BINARY command on card in SLOT. Write DATA of
|
|
* length DATALEN to a transparent file at OFFSET. */
|
|
gpg_error_t
|
|
iso7816_update_binary (int slot, int extended_mode, size_t offset,
|
|
const void *data, size_t datalen)
|
|
{
|
|
int sw;
|
|
|
|
/* We can only encode 15 bits in p0,p1 to indicate an offset. Thus
|
|
* we check for this limit. */
|
|
if (offset > 32767)
|
|
return gpg_error (GPG_ERR_INV_VALUE);
|
|
|
|
sw = apdu_send_simple (slot, extended_mode, 0x00, CMD_UPDATE_BINARY,
|
|
((offset>>8) & 0xff), (offset & 0xff),
|
|
datalen, (const char*)data);
|
|
return map_sw (sw);
|
|
}
|