1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429
|
/* ****************************************************************************
* eID Middleware Project.
* Copyright (C) 2008-2009 FedICT.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License version
* 3.0 as published by the Free Software Foundation.
*
* This software 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, see
* http://www.gnu.org/licenses/.
**************************************************************************** */
/**
* The CardConnect() function returns a pointer to a CCard object
* (that should free()-ed when no longer used) that can be used
* to communicate to a specific card.
*
* - First the plugins in a specific directory are loaded and
* tried out, so see if they support that specific card.
* For the BE eID, this directory is %windir%\System32\beidcardplugins\
* on Linux/Mac it is %PREFIX%/lib/beidcardplugins.
* - If no plugin for the card can be found, 'harcoded' plugins
* can be tried (e.g. BeidCard and SISCard for the BE eID middleware).
*
* Plugin names and their meaning
* - Cardplugins should start with "cardplugin" on Windows and
* "libcardplugin" on Linux/Mac.
* - If the name starts with "cardpluginFull" or "libcardpluginFull",
* the plugin exports both the GetCardInstance() and ConnectGetCardInstance()
* functions. Otherwise, only the GetCardInstance() function should
* be exported.
* - If the name of the plugin contains twice the string "__", then
* the string between them is taken to be the start of the PCSC
* reader name, and will only be used for that reader.
* E.g. A plugin called "cardpluginFull_SIS__ACS ACR38U__.dll" will
* only be used if the reader name starts with "ACS ACR38", and should
* export the GetCardInstance() and ConnectGetCardInstance() functions.
*
* Function exported by the card plugins:
* - GetCardInstance(): an SCardConnect() has been done and an SCARDHANDLE
* is provided in this function. This function should check if the card
* is supported, and if so, a pointer to a CCard object is returned, or
* NULL otherwise.
* - FullConnect(): a normal SCardConnect() couldn't be done, so this function
* is called with the reader name, and the function can try to connect
* in a reader-and/or card specific way. If this succeeds then this function
* continues as in the GetCardInstance() function.
*/
#include "CardFactory.h"
#include "UnknownCard.h"
#include "../common/Log.h"
#include "../common/Util.h"
#include "../common/prefix.h"
#ifdef CAL_BEID
#include "BeidCard.h"
#include "SISCard.h"
#include "SISPluginHandler.h"
#endif
#include <vector>
#include <string>
typedef class eIDMW::CCard * (*GETCARDINSTANCE)(unsigned long,char const*,unsigned long,class eIDMW::CContext *,class eIDMW::CPinpad *);
typedef class eIDMW::CCard * (*CONNECTGETCARDINSTANCE)(unsigned long,char const*,class eIDMW::CContext *,class eIDMW::CPinpad *);
namespace eIDMW
{
static bool m_bPluginNamesOK = false;
static void GetPluginNames();
static void AddPluginName(const char *csPluginName, const std::string & csPath);
typedef struct {
std::string csPath; // path of the card plugin
std::string csReader; // first part of the reader name, or ""
bool bFull; // true if both GetCardInstance() and ConnectGetCardInstance() are supported
} tPluginInfo;
static std::vector <tPluginInfo> m_Plugins;
static CCard *GetCardInstance(const char *csReader, unsigned long hCard,
CContext *poContext, CPinpad *poPinpad,
const std::string &csPluginPath, CDynamicLib &oCardPluginLib);
static CCard *ConnectGetCardInstance(const char *csReader,
CContext *poContext, CPinpad *poPinpad,
const std::string &csPluginPath, CDynamicLib &oCardPluginLib);
CCard * CardConnect(const std::string &csReader,
CContext *poContext, CPinpad *poPinpad, CDynamicLib &oCardPluginLib)
{
CCard *poCard = NULL;
long lErrCode = EIDMW_ERR_CHECK; // should never be returned
const char *strReader = NULL;
if (poContext->m_ulConnectionDelay != 0)
CThread::SleepMillisecs(poContext->m_ulConnectionDelay);
// Try if we can connect to the card via a normal SCardConnect()
unsigned long hCard = 0;
try
{
hCard = poContext->m_oPCSC.Connect(csReader);
if (hCard == 0)
goto done;
}
catch(CMWException &e)
{
if (e.GetError() == (long)EIDMW_ERR_NO_CARD)
goto done;
if (e.GetError() != (long)EIDMW_ERR_CANT_CONNECT && e.GetError() != (long)EIDMW_ERR_CARD_COMM)
throw;
lErrCode = e.GetError();
hCard = 0;
}
// So a card is present, get the names of the available plugin libs
if (!m_bPluginNamesOK)
GetPluginNames();
strReader = csReader.c_str();
if (hCard != 0)
{
// 1. A card is present and we could connect to it via a normal SCardConnect()
for (size_t i = 0; poCard == NULL && i < m_Plugins.size(); i++)
{
tPluginInfo &plugin = m_Plugins.at(i);
if (plugin.csReader.size() != 0 && !StartsWith(strReader, plugin.csReader.c_str()))
continue;
poCard = GetCardInstance(strReader, hCard, poContext, poPinpad,
plugin.csPath, oCardPluginLib);
}
#ifdef CAL_BEID
if (poCard == NULL)
poCard = BeidCardGetInstance(PLUGIN_VERSION, strReader, hCard, poContext, poPinpad);
if (poCard == NULL)
poCard = SISPluginReadData(strReader, hCard, poContext, poPinpad, oCardPluginLib);
/* SIS support no longer in the CardLayer�, only via the plugins */
#if SIS_IN_CAL
if (poCard == NULL && StartsWith(csReader.c_str(), "ACS ACR38"))
{
#ifdef __APPLE__
poContext->m_oPCSC.Disconnect(hCard, DISCONNECT_RESET_CARD);
poCard = SISCardConnectGetInstance(PLUGIN_VERSION, strReader, poContext, poPinpad);
#else
poCard = SISCardGetInstance(PLUGIN_VERSION, strReader, hCard, poContext, poPinpad);
#endif
}
#ifdef CAL_EMULATION
// Emulated reader doesn't start with "ACS ACR38"
if (poCard == NULL)
poCard = SISCardGetInstance(PLUGIN_VERSION, strReader, hCard, poContext, poPinpad);
#endif
#endif // SIS_IN_CAL
#endif // CAL_BEID
#ifndef __APPLE__
// If no other CCard subclass could be found
if (poCard == NULL)
poCard = new CUnknownCard(hCard, poContext, poPinpad, CByteArray());
#else
// On Mac OS X, SCardConnect() always works when reading a SIS card on an ACR38U,
// but not the following SCardTransmit() to read out the data. So we set hCard
// to 0 which will cause SISCardConnectGetInstance() below to first switch to
// the correct mode to read out the SIS card.
hCard = 0;
#endif
}
if (hCard == 0)
{
// 2. A card is present, but connecting to it is reader-specific (e.g. synchron. cards)
strReader = csReader.c_str();
for (size_t i = 0; poCard == NULL && i < m_Plugins.size(); i++)
{
tPluginInfo &plugin = m_Plugins.at(i);
if (!plugin.bFull || (plugin.csReader.size() != 0 && !StartsWith(strReader, plugin.csReader.c_str())))
continue;
poCard = ConnectGetCardInstance(strReader, poContext, poPinpad,
plugin.csPath, oCardPluginLib);
}
#ifdef CAL_BEID
if (poCard == NULL)
poCard = SISPluginReadData(strReader, hCard, poContext, poPinpad, oCardPluginLib);
if (poCard == NULL)
poCard = new CUnknownCard(hCard, poContext, poPinpad, CByteArray());
/* SIS support no longer in the CardLayer�, only via the plugins */
#if SIS_IN_CAL
if (poCard == NULL && StartsWith(csReader.c_str(), "ACS ACR38"))
poCard = SISCardConnectGetInstance(PLUGIN_VERSION, strReader, poContext, poPinpad);
#endif // SIS_IN_CAL
#endif // CAL_BEID
// If the card is still not recognized here, then it may as well
// be an badly inserted card, so we'll throw the exception that we
// caught in the beginnin of this function
if (poCard == NULL)
throw CMWEXCEPTION(lErrCode);
}
done:
return poCard;
}
////////////////////////////////////////////////////////////////////////////////////////
#ifdef WIN32
// Use Dependency Walker (depends.exe) to get these strings
#define csGetCardInstanceName "?GetCardInstance@@YAPAVCCard@eIDMW@@KPBDKPAVCContext@2@PAVCPinpad@2@@Z"
#define csConnectGetCardInstanceName "?ConnectGetCardInstance@@YAPAVCCard@eIDMW@@KPBDPAVCContext@2@PAVCPinpad@2@@Z"
#else
// Use nm <dll> to get these strings
#define csGetCardInstanceName "_Z15GetCardInstancemPKcmPN5eIDMW8CContextEPNS1_7CPinpadE"
#define csConnectGetCardInstanceName "_Z22ConnectGetCardInstancemPKcPN5eIDMW8CContextEPNS1_7CPinpadE"
#endif
static CCard *GetCardInstance(const char *csReader, unsigned long hCard,
CContext *poContext, CPinpad *poPinpad,
const std::string &csPluginPath, CDynamicLib &oCardPluginLib)
{
CCard * poCard = NULL;
unsigned long ulErr = oCardPluginLib.Open(csPluginPath);
if (ulErr != EIDMW_OK)
{
MWLOG(LEV_ERROR, MOD_CAL, L"Couldn't load card plugin \"%ls\", err = 0x%0x",
utilStringWiden(csPluginPath).c_str(), ulErr);
}
else
{
GETCARDINSTANCE pGetCardInstance =
(GETCARDINSTANCE) oCardPluginLib.GetAddress(csGetCardInstanceName);
if (pGetCardInstance == NULL)
{
MWLOG(LEV_ERROR, MOD_CAL, L"Function \"GetCardInstance\" not found in \"%ls\"",
utilStringWiden(csPluginPath).c_str());
}
else
{
poCard = pGetCardInstance(PLUGIN_VERSION, csReader, hCard, poContext, poPinpad);
if (poCard)
{
MWLOG(LEV_DEBUG, MOD_CAL, L" CardFactory: using plugin \"%ls\"",
utilStringWiden(csPluginPath).c_str());
}
}
}
return poCard;
}
static CCard *ConnectGetCardInstance(const char *csReader,
CContext *poContext, CPinpad *poPinpad,
const std::string &csPluginPath, CDynamicLib &oCardPluginLib)
{
CCard * poCard = NULL;
try
{
unsigned long ulErr = oCardPluginLib.Open(csPluginPath);
if (ulErr != EIDMW_OK)
{
MWLOG(LEV_ERROR, MOD_CAL, L"Couldn't load reader specific plugin \"%ls\", err = 0x%0x",
utilStringWiden(csPluginPath).c_str(), ulErr);
}
else
{
CONNECTGETCARDINSTANCE pConnectGetCardInstance =
(CONNECTGETCARDINSTANCE) oCardPluginLib.GetAddress(csConnectGetCardInstanceName);
if (pConnectGetCardInstance == NULL)
{
MWLOG(LEV_ERROR, MOD_CAL, L"Function \"ConnectGetCardInstance\" not found in \"%ls\"",
utilStringWiden(csPluginPath).c_str());
}
else
poCard = pConnectGetCardInstance(PLUGIN_VERSION, csReader, poContext, poPinpad);
if (poCard)
{
MWLOG(LEV_DEBUG, MOD_CAL, L" CardFactory: connected via plugin \"%ls\"",
utilStringWiden(csPluginPath).c_str());
} }
}
catch(CMWException &e)
{
MWLOG(LEV_ERROR, MOD_CAL, L"Exception in ConnectGetCardInstance(): err = 0x%0x\n", e.GetError());
}
catch (...)
{
MWLOG(LEV_ERROR, MOD_CAL, L"Unknown error in ConnectGetCardInstance()");
}
return poCard;
}
////////////////////////////////////////////////////////////////////////////////////////
#ifdef CAL_BEID
#define EIDMW_PLUGINS_DIR "beidcardplugins"
#endif
// The function below lists the files in a directory, for which
// no standard platform-independent API seems to exist...
#ifdef WIN32
#include <io.h>
#include <Windows.h>
static void GetPluginNames()
{
char csSystemDir[_MAX_PATH];
GetSystemDirectoryA(csSystemDir, sizeof(csSystemDir) - 50);
// E.g. "C:\WINDOWS\System32\beidcardplugins\"
std::string csPluginsDir = csSystemDir + std::string("\\") +
EIDMW_PLUGINS_DIR + std::string("\\");
std::string strSearchFor = csPluginsDir + std::string("*.dll");
const char *csSearchFor = strSearchFor.c_str();
struct _finddata_t c_file;
intptr_t hFile = _findfirst(csSearchFor, &c_file);
if (hFile != -1)
{
int iFindRes;
do
{
// On Windows, card plugins are linked to the CAL.
// So emulation plugins need to be used with the emulation CAL,
// and 'normal' plugins need to be used with the 'normal' CAL.
#ifdef CAL_EMULATION
if (strstr(c_file.name, "Emulation") != NULL)
AddPluginName(c_file.name, csPluginsDir + c_file.name);
#else
if (strstr(c_file.name, "Emulation") == NULL)
AddPluginName(c_file.name, csPluginsDir + c_file.name);
#endif
iFindRes = _findnext(hFile, &c_file);
}
while (iFindRes == 0);
_findclose(hFile);
}
m_bPluginNamesOK = true;
}
#else
#include <dirent.h>
static void GetPluginNames()
{
std::string csPluginsDir = STRINGIFY(EIDMW_PREFIX) + std::string("/lib/") +
EIDMW_PLUGINS_DIR + std::string("/");
const char *csSearchFor = csPluginsDir.c_str();
DIR *pDir = opendir(csSearchFor);
// If pDir is NULL then the dir doesn't exist
if(pDir != NULL)
{
struct dirent *pFile = readdir(pDir);
for ( ;pFile != NULL; pFile = readdir(pDir))
{
// On Mac, card plugins are linked to the CAL.
// So emulation plugins need to be used with the emulation CAL,
// and 'normal' plugins need to be used with the 'normal' CAL.
#if defined CAL_EMULATION && defined __APPLE__
if (strstr(pFile->d_name, "Emulation") != NULL)
AddPluginName(pFile->d_name, csPluginsDir + pFile->d_name);
#else
if (strstr(pFile->d_name, "Emulation") == NULL)
AddPluginName(pFile->d_name, csPluginsDir + pFile->d_name);
#endif
}
closedir(pDir);
}
m_bPluginNamesOK = true;
}
#endif
static void AddPluginName(const char *csPluginName, const std::string & csPath)
{
if (StartsWith(csPluginName, "cardplugin") || StartsWith(csPluginName, "libcardplugin"))
{
tPluginInfo plugin;
plugin.csPath = csPath;
plugin.bFull = StartsWith(csPluginName, "cardpluginFull") ||
StartsWith(csPluginName, "libcardpluginFull");
const char *ptr1 = strstr(csPluginName, "__");
const char *ptr2 = (ptr1 == NULL ? NULL : strstr(ptr1 + 2, "__"));
if (ptr2 != NULL && ptr2 - ptr1 < 200)
{
ptr1 += 2;
char csReaderName[200];
memcpy(csReaderName, ptr1, ptr2 - ptr1);
csReaderName[ptr2 - ptr1] = '\0';
plugin.csReader = csReaderName;
}
m_Plugins.push_back(plugin);
}
}
}
|