Home

Smartnonus

1. 6 3 13 CasGetAttrib 72 6 3 14 CasGetCardTypeProviderName 73 6 3 15 CasGetProviderld 75 6 3 16 CasGetStatusChange 76 6 3 17 CasIntroduceCardType 77 6 3 18 CasIntroduceReader 78 6 3 19 CasIntroduceReaderGroup 79 6 3 20 CasListCards 80 6 3 21 CasListInterfaces 81 6 3 22 CasListReaderGroups 82 6 3 23 CasListReaders 83 6 3 24 CasLocateCards 84 6 3 25 CasReconnect 85 6 3 26 CasReleaseContext 87 6 3 27 CasRemoveReaderFromGroup 88 6 3 28 CasSetAttrib 89 6 3 29 CasStatus 90 6 3 30 CasTransmit 92 6 3 31 CasUIDIgSelectCard 95 6 4 C digos de Erros do Cart o Inteligente AP NDICE A Estrutura de Dados TLV ou BER TLV B Suporte T cnico B 1 Identifica o do Hardware B 2 Identifica o do Firmware 96 98 98 99 100 101 B 3 Identifica o do Software C Demonstra o API Smartnonus C 1 Aplica o CardReader C 1 1 Aba Informa es 102 104 104 104 C 1 2 Aba Execu o 104 C 1 3 Aba Avan ado 104 C 2 C digo Fonte 105 1 Caracteristicas T cnicas A leitora Smartnonus atende aos requisitos el tricos mec nicos protocolos de transmiss o e interoperabilidade definidos pelos padr es e ISO IEC 7816 e PC SC vers o 1 0 e EMV 4 0 Level 1 ESPECIFICA ES M
2. A resist ncia entre NC C6 e qualquer outro contato maior ou igual a 10M Mega ohms para uma tens o aplicada de 5Vcc 2 3 3 CLK C3 SCO_CLK As caracter sticas do Clock geradas pelo pino CLK s o descritas na tabela abaixo S mbolo Condi es Minimo M ximo Unidade VOH 0 lt IOH lt 50uA Vcc min Vcc 0 5 Vcc V VOL 50uA lt IOL lt 0 Vcc min 0 0 4 V tRetF CIN Icc 30pF max 8 do Per odo do Clock Perturba o do Sinal Low 0 25 0 4 V High Vcc 0 5 Vcc 0 25 2 3 4 Reset C2 SCO_RST O sinal de Reset gerado pelo leitor apresenta as caracteristicas el tricas descritas na tabela abaixo Simbolo Condi es Minimo M ximo Unidade VOH 0 lt IOH lt 50uA Vcc min Vcc 0 5 Vcc V VOL 50uA lt IOL lt 0 Vcc min 0 0 4 V tRet CIN Icc 30pF max 0 8 us Perturba o do Sinal Low 0 25 0 4 High Vcc 0 5 Vcc 0 25 2 3 5 Vcc C1 SCO VCC O pino Vcc fornece uma tens o de 5VDC Entrega uma sa da est vel de corrente de 55ma O pino Vcc est protegido contra transientes e surtos de tens o originados pela opera o interna do circuito do leitor ou de origem externa O Vcc capaz de fornecer mais do que 55ma se requisitado em opera o 3 Sinais Eletr nicos e Protocolos A conex o ativa o e desativa o dos sinais el tricos dos contatos da leitora s o realizados de acordo com o padr o ISO IEC
3. Arquitetura PC SC 20 4 1 Caracteristicas Operacionais O M dulo de Interface da Leitora Smartnonus de acordo com a especifica o PC SC apresenta um conjunto uniforme de servi os ao Provedor de Servi os do Cart o Suporta no m nimo uma conex o l gica ativa entre uma aplica o e a leitora Esta funcionalidade n o impede o gerenciamento de sess es conforme definido no padr o ISO IEC 7816 como os mecanismos de canais channel mechanism definidos na ISO 7816 4 ou a funcionalidade de endere os por n s node addressing associado ao protocolo T 1 Entretanto a implementa o destas caracter sticas relacionadas ao gerenciamento de sess es responsabilidade do Cart o e Provedor de Servi os associado O M dulo de Interface da Leitora Smartnonus suporta m ltiplas leitoras e apresenta uma conex o l gica independente para cada leitora para requisi es de um Provedor de Servi os de um Cart o Tamb m possibilita determinar a associa o entre uma leitora espec fica e sua respectiva conex o l gica 4 2 Enumera o das funcionalidades operacionais da Leitora Atrav s do M dulo de Interface a leitora Smartnonus prov uma interface ou servi o que permite enumera o das suas funcionalidades mandat rias e opcionais Estas funcionalidades podem ser consultadas a qualquer instante A informa o retornada utilizando uma estrutura TLV tag length value vide ap ndice A Abaixo est o alistadas as informa
4. a voc controle direto sobre a leitora Voc pode selecion la a qualquer momento ap s uma sele o bem sucedida para CasConnect e antes de uma sele o bem sucedida para CasDisconnect O efeito no status da leitora depende do c digo de controle LONG CasControl IN SCARDHANDLE hCard IN DWORD dwControlCode IN LPCVOID IpInBuffer IN DWORD nlnBufferSize OUT LPVOID IpOutBuffer IN DWORD nOutBufferSize OUT LPDWORD IpBytesReturned Par metros hCard Este o valor de refer ncia retornado do CasConnect dwControlCode Fornece o c digo de controle para a opera o Este valor identifica a opera o espec fica a ser realizada IpInBuffer Fornece um apontador para um buffer que cont m os dados necess rios para realizar a opera o Este par metro pode ser NULL se o par metro dwControlCode especificar uma opera o que n o exija dados de entrada ninBufferSize Especifica o tamanho em bytes do buffer apontado pelo IpInBuffer IpOutBuffer Aponta para um buffer que recebe os dados de sa da da opera o Este par metro pode ser NULL se o par metro dwControlCode especificar uma opera o que n o produza dados de sa da nOutBufferSize Especifica o tamanho em bytes do buffer apontado pelo IpOutBuffer IpBytesReturned Aponta para um DWORD que recebe o tamanho em bytes dos dados armazenados no buffer apontado pelo IpOutBuffer Valores de Retorno v lido SCARD S SUCCESS AR Um c digo de erro aparecer par
5. v lido SCARD S SUCCESS Re Um c digo de erro aparecer para uma lista de c digos de erro Inv lido peat consultar C digos de Erro Observa es CasListinterfaces uma fun o de consulta base de dados 81 6 3 22 CasListReaderGroups A fun o CasListReaderGroups fornece uma lista de grupos de leitoras que foram apresentados previamente para o sistema LONG CasListReaderGroups IN SCARDCONTEXT hContext OUT LPTSTR mszGroups IN OUT LPDWORD pcchGroups Par metros hContext Fornece o identificador que identifica o contexto do gerente de recursos para a consulta O contexto do gerente de recursos pode ser ajustado por uma sele o pr via para CasEstablishContext ou ajusta NULL se a consulta n o direcionada para um contexto espec fico mszGroups Recebe uma multi sequ ncia que lista os grupos de leitoras definidos para o sistema e dispon veis para o usu rio atual no terminal atual Se este valor for NULL CasListReaderGroups ignora o comprimento do buffer fornecido em pcchGroups escreve o comprimento do buffer que seria retornado se este par metro n o tivesse sido NULL para pcchGroups e retorna um c digo v lido pcchGroups Fornece o comprimento do buffer mszGroups em caracteres e recebe o comprimento real da estrutura multi sequ ncia incluindo todos os caracteres nulos direita Se o comprimento de buffer for especificado como SCARD AUTOALLOCATE ent o o szGroups convertido de um apo
6. IN LPCTSTR mszCards IN OUT LPSCARD_READERSTATE rgReaderStates IN DWORD cReaders Par metros hContext Fornece o identificador do contexto do gerente de recursos O contexto do gerente de recursos ajustado por uma sele o pr via para CasEstablishContext mszCards Fornece uma multi sequ ncia que cont m os nomes dos cart es a serem buscados rgReaderStates Fornece uma matriz de estruturas SCARD_READERSTATE que especifica as leitoras a serem buscadas e recebe o resultado cReaders Fornece o numero de elementos na matriz rgReaderStates Valores de Retorno Valido SCARD S SUCCESS ae Um c digo de erro aparecer para uma lista de c digos de erro Invalido ae consultar C digos de Erro Observa es Este servi o especialmente til quando usado em conjunto com CasGetStatusChange Se nenhum cart o correspondente encontrado por meio de CasLocateCards o aplicativo de sele o poder utilizar CasGetStatusChange para aguardar por mudan as na disponibilidade do cart o CasLocateCards uma fun o de rastreabilidade do cart o inteligente 84 6 3 25 CasReconnect A fun o CasReconnect restabelece uma conex o existente entre o aplicativo de sele o e um cart o inteligente Esta fun o muda um identificador do cart o de acesso direto para acesso geral ou reconhece e limpa uma condi o de erro que est impedindo outros acessos ao cart o LONG CasReconnect IN SCARDHANDLE hCard IN DW
7. Max clock 3571 Default data rate 9600 Max data rate 115200 Max IFSD 0xFC Gerenciamento de energia Power management support 0x00 Caracter sticas mec nicas Mechanical characteristics supported 0x00 PC SC Parte 3 Tabela 3 2 Estado do cart o inteligente Presen a do cart o inteligente ICC presence 0x02 Estado da interface com o cart o inteligente ICC interface status 0xFF Cadeia de caracteres ATR 3B B2 11 00 10 80 00 08 Tipo de cart o baseado na ATR ICC Type 1 PC SC Parte 3 Tabela 3 4 Protocolos e par metros dispon veis Protocolo atual Current protocol type 0x01 Clock atual Current clock 3571 E Clack canvarcinn factor 277 Informa es Execu o Avan ado 104 C 2 C digo Fonte O c digo fonte est aberto e dispon vel para uso de desenvolvedores sem custos adicionais Pode ser adaptado copiado e distribu do para uso com as leitoras Smartnonus Pode ser obtido por download gratuito em www nonus com br smartnonus Requisitos M nimos de Ambiente Recomendados Ambiente de Desenvolvimento Delphi 2010 XE www embarcadero com Microsoft Windows 7 Processador 1GHz ou superior Mem ria M nimo de 2GB Espa o em Disco 250MB Vers o do Driver 3 1 7 0 API Smartnonus winscard dll dispon vel para download em www nonus com br smartnonus Manual da API Smartnonus vide sess o 6 deste manual Refer ncia API PC SC Smartnonus O c digo fonte pode ser adap
8. digos de erro Invalido ee consultar C digos de Erro Observa es Ap s a conclus o bem sucedida desta fun o o valor no szProvider pode ser utilizado com terceiro par metro em uma sele o para CryptAcquireContext 73 Exemplo de Codigo CASCONTEXT hContext NULL LPTSTR szProvider NULL LPTSTR szCardName _T WindowsCard DWORD chProvider SCARD_AUTO_ALLOCATE LONG IReturn SCARD_S_SUCCESS Estabele a um contexto de recursos de cart o inteligente IReturn CasEstablishContext SCARD SCOPE USER NULL NULL amp hContext IF SCARD S SUCCESS IReturn Recupere o nome do fornecedor IReturn CasGetCardTypeProviderName hContext szCardName SCARD PROVIDER CSP LPSTR amp szProvider amp chProvider IF SCARD S SUCCESS IReturn BOOL fSts TRUE HCRYPTPROV hProv NULL Adquira um contexto de opera o criptogr fica fSts CryptAcquireContext amp hProv NULL szProvider PROV RSA FULL 0 Realize opera es criptogr ficas com cart o inteligente Libere mem ria alocada por CasGetCardTypeProviderName IReturn CasFreeMemory hContext szProvider 74 6 3 15 CasGetProviderld A fun o CasGetProviderld retorna o identificador GUID do fornecedor do servi o prim rio para o cart o dado O selecionador fornece o nome de um cart o inteligente previamente introduzido para o sistema e recebe o identificador registrado do fornecedor GUID do servi o pr
9. es que ser o retornadas pela leitora Smartnonus Em adicional veja o ap ndice C Demonstra o API Smartnonus na sess o C 1 3 software demonstra o Nonus que permite executar este servi o Classe ce Elemento de TAG TEM Dado Codinado Informa es Dado M ximo Fornecedor Nome do 0x0100 32 bytes CASTLES Fornecedor Especifica o do Fornecedor para 0x0101 32 bytes EZ100PU a Leitora IFD ee baal DWORD codificado como Especifica o do Fornecedor para OXMMmmbbbb onde z p 0x0102 4 bytes MM 00 a vers o da Leitora IFD mm 00 bbbb 0000 N mero de S rie da Leitora IFD 0x0103 32 bytes Comunica o 0x00200000 DWORD codificado como OxDDDDCCCC onde DDDD tipo do canal de dados CCCC n mero do canal Os seguintes c digos s o definidos para DDDD 0x01 Porta Serial CCCC o n mero da porta 0x02 Porta Paralela CCCC o n mero da porta 0x04 Porta do Teclado PS 2 CCCC igual a zero 0x08 Canal SCSI CCCC o ID SCSI 0x10 IDE CCCC o n mero do dispositivo 0x20 USB CCCC o n mero do dispositivo OxFy Defini o do Fornecedor para y no intervalo de O a 15 CCCC definido pelo fornecedor ID do Canal 0x0110 4 bytes 21 Classe de Elemento de TAG TEN Dado Codificado Informa es Dado M ximo Protocolo Veja parte 2 da especifica o PC SC 0x00000003 DWORD codificado como OxORRRPPPP
10. esperado de volta bP3 n o enviado 92 cbSendLength Fornece o comprimento em bytes do par metro pbSendBuffer T 0 Nota para T 0 no caso especial em que nenhum dado enviado para o cart o e nenhum dado esperado de volta este comprimento deve refletir que o membro bP3 n o est sendo enviado o comprimento deve ser sizeof CmdBytes sizeof BYTE pioRecvPci Aponta para a estrutura de cabe alho do protocolo para a instru o seguido por um buffer para receber qualquer informa o de controle de protocolo PCI retornado espec fico do protocolo em uso Este par metro pode ser NULL se n o houver nenhum PCI retornado desej vel pbRecvBuffer Aponta para qualquer dado retornado do cart o T 0 Nota para T 0 os dados s o imediatamente seguidos pelos bytes de status SW1 e SW2 Se nenhum dado for retornado do cart o ent o este buffer conter apenas os bytes de status SW1 e SW2 pcbRecvLength Fornece o comprimento do par metro pbRecvBuffer em bytes e recebe o numero real de bytes recebidos do cart o inteligente T 0 Nota para T 0 o buffer de recebimento deve ter o comprimento de pelo menos dois bytes a fim de receber os bytes de status SW1 e SW2 Valores de Retorno v lido SCARD S SUCCESS EN Um c digo de erro aparecer para uma lista de c digos de erro Inv lido ne consultar C digos de Erro Observa es CasTransmit uma fun o de acesso do cart o inteligente e da leitora O
11. m deve ser fornecido ou dwShareMode e dwPreferredProtocols devem ser ajustados pvUserData Um apontador inv lido para dados do usu rio Este apontador passado de volta para o selecionador nas rotinas de Conex o Verifica o e Desconex o dwShareMode Se IpfnConnect n o for NULL os membros dwShareMode e dwPreferredProtocols ser o ignorados Se IpfnConnect for NULL e dwShareMode for diferente de zero uma sele o interna ser feita para CasConnect usando dwShareMode e dwPreferredProtocols como par metros dwPreferredProtocols Usado para conex o interna conforme descrito em dwShareMode 58 6 3 Refer ncia da API 6 3 1 CasAddReaderToGroup A fun o CasAddReaderToGroup adiciona uma leitora ao grupo de leitoras LONG CasAddReaderToGroup IN SCARDCONTEXT hContext IN LPCTSTR szReaderName IN LPCTSTR szGroupName Par metros hContext Fornece o identificador do contexto do gerente de recursos O contexto do gerente de recursos ajustado por uma sele o pr via pelo comando CasEstablishContext szReaderName Fornece o nome adequado da leitora que voc est adicionando szGroupName Fornece o nome adequado do grupo para o qual voc est adicionando a leitora Valores de Retorno V lido SCARD S SUCCESS Ee Um c digo de erro aparecer para uma lista de c digos de erro consultar Inv lido Em C digos de Erro Observa es CasAddReaderToGroup cria automaticamente o grupo de leitoras e
12. o A nica ocasi o em que o SCL pode iniciar um bloco para estabelecer um valor para o par metro IFSD maior do que o default de 32 bytes Neste caso o SCL realiza esta opera o em seguida da negocia o do protocolo T 1 e antes da transmiss o do primeiro bloco do Provedor de Servi o do cart o 28 O SCL Smartnonus prov suporte para fun es encadeadas conforme descrito na ISO 7816 3 o que permite a transmiss o de informa es maiores do que o par metro IFSC IFSD O SCL tamb m prov suporte para sess es l gicas usando o mecanismo de Node Address associado ao protocolo T 1 4 6 Gerenciamento de Energia no Cart o A leitora Smartnonus n o possui fun es de Gerenciamento de Energia 4 7 Caracter sticas Mec nicas O mecanismo implementado pela leitora Smartnonus um mecanismo de inser o manual A leitora Smartnonus n o possui mecanismos de trava do cart o n o permite engolir ejetar ou confiscar o cart o O cart o permanece todo o tempo acess vel ao operador 4 8 Dispositivos Adicionais de Seguran a A leitora Smartnonus n o implementa nem suporta expans o para dispositivos adicionais de seguran a tais como Teclado num rico Pin Pad Teclado alfanum rico Dispositivo biom trico Tela ou Display 4 9 Caracter sticas especificas do Fabricante A leitora Smartnonus n o implementa caracter sticas funcionalidades ou extens es propriet rias do fabricante 29 4 10 Inte
13. o INS C digo da Instru o P1 e P2 Par metros Ap s o cabe alho existe um corpo opcional LC Dados enviados como complemento do comando para o cart o executar uma instru o especifica conforme definido no cabe alho DADOS Dados enviados para o cart o Estes dados podem ser estruturas TLV Vide Ap ndice A suportada pela leitora Smartnonus LE Especifica o n mero de dados esperados pela aplica o na resposta do cart o Estrutura de uma resposta APDU Dados resposta SW1 SW2 Figura 3 6 3b Estrutura de uma resposta APDU O campo DADOS ou RESPOSTA opcional Os bytes SW1 e SW2 s o bytes de status de resposta e do cart o 18 Abaixo os 4 diferentes casos possiveis de comando APDU Possiveis casos de comando APDV Caso 1 CLA INS P1 P2 Caso 2 CLA INS P1 P2 LE Caso 2 CLA INS P1 P2 LC Dados Caso 4 CLA INS P1 P2 LC Dados LE Figura 3 6 3c Possiveis casos de comando APDU T 0 ou T 1 Abaixo os 2 casos possiveis de resposta APDU Possiveis casos da resposta APDV Caso 1 SW1 SW2 Caso 2 Resposta SW1 sw2 Figura 3 6 3d Poss veis casos da resposta APDU T 0 ou T 1 A leitora Smartnonus compat vel com as demais normas de comunica o com os cart es conforme definido na ISO 7816 4 O conceito de Sess o Para que o cart o mantenha dados de sess o ou dados din micos uma aplica o precisa es
14. 0 Para T 0 o firmware lidar com a camada TPDU de T 0 o que significa que o firmware enviar o cabe alho T 0 de 5 bytes e executar a a o de acordo com o byte de reconhecimento ACK e bytes de status SW1 SW2 O tratamento do comando GET_RESPONSE n o realizado pelo firmware da leitora Do mesmo modo para T 1 o protocolo T 1 deve ser tratado pelo driver da aplica o host o firmware da leitora respons vel apenas por enviar ou receber dados do cart o inteligente 3 6 1 Protocolo T 0 No protocolo T 0 a leitora sempre inicia a transmiss o dos dados O comando inicial enviado pela leitora ao cart o consiste em um cabe alho de 5 caracteres Se o comando recebido corretamente o cart o envia um byte de reconhecimento ACK Os dados podem ser transmitidos apenas em uma dire o de cada vez a dire o da transmiss o dos dados esta impl cita na defini o do comando portanto tanto a leitora quanto o cart o conhecem a sequ ncia antecipadamente Cabe alho da Instru o para T 0 CLA a classe do comando ou instru o o valor OxFF reservado para identificar uma sequ ncia PPS INS o c digo da instru o por exemplo read memory P1 par metro 1 da instru o por exemplo endere o de mem ria P2 par metro 2 da instru o P3 N mero de bytes do campo do bloco de dados da instru o 15 A figura 3 6 1 abaixo exemplifica o funcionamento do protoloco T 0 no caso mais ext
15. Baixo de tens o de sa da tR Tempo de subida entre 10 e 90 da amplitude do sinal tF Tempo de queda entre 90 e 10 da amplitude do sinal LIH N vel Alto de corrente de entrada LIL N vel Baixo de corrente de entrada Icc Corrente de Alimenta o IOH N vel Alto de corrente de sa da IOL N vel Baixo de corrente de sa da CIN Capacit ncia de entrada 2 3 1 1 0 C7 SCO 10 Este contato usado como sa da output modo de transmiss o para transmitir dados para o cart o ou como entrada input modo de recep o para receber dados do cart o O contato n o setado em n vel l gico alto a menos que o pino de VCC esteja alimentado e est vel 2 3 1 1 Modo de Transmiss o Quando em modo de transmiss o o terminal enviar dados ao cart o de acordo com as caracter sticas mostradas na tabela abaixo S mbolo Condi es M nimo M ximo Unidade VOH 0 lt IOH lt 20uA Vcc min 0 8 x Vcc Vcc V VOL 0 5mA lt IOL lt 0 Vcc min 0 0 4 V tR e tF CIN Icc 30 pF max 0 8 us Low 0 25 0 4 V Perturba o do Sinal High 0 8 x Vcc Vcc 0 25 V 2 3 1 2 Modo de Recep o Quando em modo de recep o o terminal interpreta os sinais do cart o de acordo com as caracter sticas abaixo Simbolo M nimo M ximo Unidade VIH 0 6 x Vcc Vcc V VIL 0 0 5 V tR and tF 1 2 us 2 3 2 VPP C6 NC C6 VPP esta eletricamente isolado
16. EDC 1 byte 1 byte 1 byte 0 254 bytes URC e e Figura 3 6 2 estrutura do bloco no protocolo T 1 O byte PCB no pr logo define 3 tipos poss veis de blocos Information Block I Block Receive Ready Block R Block Supervisor Block S Block Information Block I Block Estrutura utilizada para transmitir comandos da aplica o entre o cart o e a leitora Pode ainda atuar como um byte de reconhecimento ACK para o modo n o encadeado Receive Ready Block R Block O Receive Ready Block usado como byte de reconhecimento ACK NAK quando o protocolo esta enviando dados como uma sequ ncia de blocos encadeados Supervisor Block S Block utilizado para estabelecer par metros de controle e efetuar ressincroniza o como resultado de alguma condi o de erro O byte LEN ainda no pr logo define o n mero de bytes se houver algum no Campo de Informa o do bloco permitida a faixa de valores de 0x00 a OxFE tamanho m ximo do campo de 254 bytes O Campo de Informa o Information Field utilizado para transportar comandos ou dados da aplica o O Campo de Ep logo cont m o bloco de detec o de erros que pode ser tanto um LRC ou um CRC O LRC utiliza 1 byte enquanto o CRC utiliza 2 bytes O c digo de detec o de erro definido por caracteres de interface espec ficos Conforme discutido anteriormente vide 3 4 ATR os caracteres de interface s o providos pelo ATR O protocolo T 1 utiliza 3
17. Leitoras de Cart es Inteligentes Poder visualizar a leitora Smartnonus descrita como EZUSB PC SC Smart Card Reader Arquivo A o Exibir Ajuda e 9 B m e E NS 4 g m36801 p Adaptadores de rede My Adaptadores de v deo b 3 Baterias JE Computador a4 Controladores de som v deo e jogos gt gy Controladores IDE ATA ATAPI bs Controladores USB barramento serial universal gt 23 Dispositivos de imagem 4 Dispositivos de Interface Humana gt JE Dispositivos de sistema gt Jungo 3 Leitores de cart es inteligentes _ 3 EZUSB PC SC Smart Card Reader gt ME Monitores b A Mouse e outros dispositivos apontadores b 4B Processadores gt Radios Bluetooth Teclados ta Unidades de disco gt gi Unidades de DVD CD ROM 35 5 2 Microsoft Windows Vista Requisitos Minimos de Ambiente Recomendados Microsoft Windows Vista Service Pack 1 Processador 1GHz ou superior Mem ria Minimo de 512MB Espa o em Disco 20MB Vers o do Driver 3 1 7 0 Mantenha a leitora Smartnonus desconectada durante a instala o dos drivers para o Microsoft Windows Vista Voc precisar de direitos administrativos para prosseguir com a instala o dos drivers para a leitora Smartnonus Os drivers mais atuais est o dispon veis para download na p gina da leitora Smartnonus na Internet em www nonus com br smartnonus Selecione o arquivo para o Microsoft Windows Vista setup vista exe Q
18. O selecionador fornece o nome de um cart o inteligente previamente apresentado para o subsistema e recebe a lista de interfaces suportadas pelo cart o LONG CasListinterfaces IN SCARDCONTEXT hContext IN LPCTSTR szCard OUT LPGUID pguidinterfaces IN OUT LPDWORD pcguidInterfaces Par metros hContext Fornece o identificador do contexto do gerente de recursos para a consulta O contexto do gerente de recursos pode ser ajustado por uma sele o pr via para CasEstablishContext ou ajusta NULL se a consulta n o direcionada para um contexto espec fico szCard Fornece o nome do cart o inteligente j apresentado para o subsistema do cart o inteligente pguidInterfaces Fornece uma matriz de identificadores de interface GUIDs que indicam as interfaces suportadas pelo cart o inteligente Se este valor for NULL CasListInterfaces ignora o comprimento da matriz fornecido em pcguidinterfaces retornando o tamanho da matriz que seria retornado se este par metro n o tivesse sido NULL para pcguidinterfaces e retorna um c digo v lido pcguidinterfaces Fornece o tamanho da matriz pguidInterfaces e recebe o tamanho real da matriz retornada Se o tamanho da matriz for especificado como SCARD AUTOALLOCATE ent o o pcguidinterfaces convertido de um apontador para um apontador GUID e recebe o endere o do bloco de mem ria contendo a matriz Este bloco de mem ria deve ser desalojado selecionando CasFreeMemory Valores de Retorno
19. O valor deste membro n o dever ser NULL hSCardContext Contexto utilizado para comunica o com o gerente de recursos do cart o inteligente Selecione CasEstablishContext para ajustar o contexto do gerente de recursos e CasReleaseContext para liber lo O valor deste membro n o dever ser NULL hwndOwner Identifica a janela que possui a caixa de di logo Este membro poder ser qualquer identificador de janela v lido ou pode ser NULL para o padr o de desktop dwFlags Um conjunto de bit flags marcadores em forma de bit que voc pode utilizar para inicializar a caixa de di logo Quando a caixa de di logo retornar ela ajusta estes marcadores para indicar a entrada do usu rio Este membro poder ser um dos marcadores a seguir SC DLG MINIMAL UI Mostra o di logo apenas se o cart o a ser procurado pelo aplicativo de sele o n o foi localizado e estiver dispon vel para uso em uma leitora Isto permite que o cart o seja encontrado conectado atrav s do mecanismo interno de di logo ou das fun es de chamada do usu rio e retornado ao aplicativo de sele o SC DLG NO UI For a para que a Interface de Usu rio IU do Select Card n o seja exibida independente do resultado da pesquisa SC DLG NO UI For a para que a Interface de Usu rio IU do Select Card seja exibida independente do resultado da pesquisa IpstrTitle Aponta para uma sequ ncia a ser colocada na barra de t tulo da caixa de di logo Se este membro
20. a informa o do cart o CasUIDIgSelectCard retorna SCARD E NO MEMORY e o tamanho necess rio do buffer em nMaxCard dwActiveProtocol Retorna o protocolo em uso quando o di logo faz uma conex o com um cart o hCardHandle Identifica o do cart o conectado seja atrav s de uma conex o de di logo interno ou de uma chamada IpfnConnect 56 6 2 4 OPENCARD_SEARCH_CRITERIA A estrutura OPENCARD SEARCH CRITERIA utilizada pela fun o CasUIDIgSelectCard a fim de reconhecer cart es que tenham os requisitos necess rios estabelecidos pelo selecionador No entanto voc pode selecionar CasUIDIgSelectCard sem utilizar esta estrutura typedef struct DWORD dwStructSize LPTSTR IpstrGroupNames DWORD nMaxGroupNames LPCGUID rgguidinterfaces DWORD cguidinterfaces LPTSTR lpstrCardNames DWORD nMaxCardNames LPOCNCHKPROC IpfnCheck LPOCNCONNPROC IpfnConnect LPOCNDSCPROC IpfnDisconnect LPVOID pvUserData DWORD dwShareMode DWORD dwPreferredProtocols OPENCARD_SEARCH_CRITERIA POPENCARD_SEARCH_CRITERIA LPOPENCARD_SEARCH_CRITERIA Membros dwsStructSize Especifica o comprimento em bytes da estrutura N o dever ser NULL IpstrGroupNames Aponta para um buffer que contenha sequ ncias de nomes de grupos terminados em NULL A ltima sequ ncia no buffer deve ser terminada por dois caracteres NULL Cada sequ ncia o nome de um grupo de cart o que deve ser inclu do na busca Se lpstrGroupNames for NULL o grupo p
21. caracteres para estabelecer seus par metros antes de iniciar a comunica o 17 Estes 3 bytes s o para i gt 2 TAi IFSC IIFSC Information Field Size for the Card padr o 32 TBi bits 4 1 CWI padr o 13 bits 8 5 BWI padr o 4 TCi bit 1 1 C digo de Erro CRC bit 1 0 C digo de Erro LRC padr o Os caracteres CWI e BWI est o relacionados a temporiza o entre caracteres e blocos A temporiza o entre caracteres permite a detec o de erros no tamanho de um bloco transmitido enquanto a temporiza o entre blocos permite a detec o de um cart o sem resposta ou que ficou inoperante 3 6 3 APDU O APDU Aplication Protocol Data Unit um protocolo de comando entre o cart o e a aplica o de acordo com a norma ISO 7816 4 A implementa o na leitora Nonus est em conformidade com a norma ISO 7816 4 Mensagens APDU compreendem 2 estruturas uma utilizada pela aplica o para enviar comandos para o cart o e outra usada pelo cart o para enviar respostas de volta a aplica o A primeira conhecida como APDU de comando C APDU e a ultima como APDU de resposta R APDU Para todo APDU de comando existe uma APDU de resposta correspondente Estrutura de um comando APDU Cabe alho Corpo opcional CLA INS P4 P2 LC Dados LE Figura 3 6 3a Estrutura de um comando APDU No cabe alho do APDU encontramos CLA Classe da Instru
22. cart o presente e engolido para Leitoras IFD que suportam o recurso engolir o cart o 4 cart o confiscado Estado da 0x0301 1 byte BOOLEAN O contato inativo Interface do 1 contato ativo Cart o ICC Sequ ncia ATR 0x0303 32 bytes Cont m a Sequ ncia ATR conforme retornada pelo Cart o ICC Tipo do Cart o 0x0304 1 byte ISO IEC 7816 ou desconhecido ICC baseado O Tipo de Cart o desconhecido na sequ ncia 1 7816 Ass ncrono ATR 2 7816 S ncrono Outros valores Reservados para Uso Futuro RFU O sistema de componentes da leitora Smartnonus respons vel por determinar quando ocorrem erros irrecuper veis de comunica o e notificar o Provedor de Servi os do cart o logicamente conectado O sistema de componentes da leitora pode distinguir entre 2 tipos de erros de comunica o Cart o inoperante n o respondendo Erro irrecuper vel de comunica o Esta informa o tornada dispon vel ao Provedor de Servi os do cart o logicamente conectado Existem 2 partes de tratamento de erros no canal USB e no protocolo do cart o inteligente Para o canal I O USB basicamente o tratamento de erros segue o padr o USB Al m do mais se os dados s o para o cart o inteligente existe um time out O time out diferente para os protocolos T 0 e T 1 O valor do time out para T 0 e T 1 depende do padr o ISO 7816 Se os dados n o s o para o cart o inteligente existe um time out fix
23. enviado No m ximo s o realizadas 3 tentativas Ap s isto o cart o desativado e o provedor de servi os do cart o informado de que um erro irrecuper vel ocorreu Todos os outros erros s o de responsabilidade do cart o ou do Provedor de Servi os do Cart o Abaixo segue o procedimento implementado pelo SCL Smartnonus de acordo com a especifica o PC SC 1 Se n o h resposta do cart o para um bloco enviado pelo SCL dentro do tempo definido para BWT Block Waiting Time o SCL segue de acordo com o cen rio 33 ou 35 definido na norma ISO 7816 3 anexo A para tentar recuperar a comunica o Se este recurso falhar o SCL desativa o cart o e informa o Provedor de Servi os do cart o que um erro irrecuper vel ocorreu 2 Se um bloco inv lido recebido como resposta a um R Block o remetente deve retransmitir um R Block 3 Se um S Block response n o for recebido em resposta a um S Block request o remetente deve retransmitir um S Block request 4 Se um bloco inv lido recebido como resposta a um S Block response o SCL transmite um R Block com bit 5 n mero sequencial do pr ximo I Block esperado 5 Se o SCL detectar uma condi o de underrun ou overrun aguarda o maior CWT ou BWT antes de transportar o ultimo bloco 6 Quando um cart o envia um S Block IFS request e recebe uma resposta inv lida retransmite o bloco uma nica vez para obter um S Block IFS response e em seguida permanece no modo de recep
24. for NULL o sistema utiliza o t tulo padr o Selecionar Cart o IpstrSearchDesc Aponta para uma sequ ncia a ser exibida para o usu rio como uma solicita o para inserir o cart o inteligente Se este membro for NULL o sistema utiliza o t tulo padr o Favor inserir um cart o inteligente hicon Identificador para um cone 32 x 32 pixels Voc pode especificar um cone espec fico para um fornecedor para ser exibido no di logo Se este valor for NULL um cone gen rico gerado pela leitora do cart o inteligente exibido 55 pOpenCardSearchCriteria Apontador para a estrutura OPENCARD SEARCH CRITERIA a ser utilizada ou NULL se uma n o for utilizada IpfnConnect Apontador para a rotina de conex o do cart o do selecionador Se o selecionador precisa realizar um processamento adicional para se conectar ao cart o este apontador de fun o ajustado para a fun o de conex o do usu rio Se a fun o de conex o for bem sucedida o cart o deixado conectado e inicializado e o identificador do cart o retornado O prot tipo para a rotina de conex o dada a seguir Connect hSCardContext o contexto do cart o passado no bloco do par metro szReader o nome da leitora mszCards uma sequ ncia que cont m os nomes de cart o poss veis na leitora pvUserData apontador para dados do usu rio passados no bloco do par metro pvUserData Um apontador inv lido para dados do usu r
25. grupo CasintroduceReaderGroup uma fun o de gerenciamento da base de dados Para remover um grupo de leitoras utilize CasForgetReaderGroup 79 6 3 20 CasListCards A fun o CasListCards busca a base de dados do cart o inteligente e fornece uma lista de cart es designados apresentados previamente ao sistema pelo usu rio O selecionador especifica uma sequ ncia ATR um conjunto de identificadores de interface GUIDs ou ambos Se tanto uma sequ ncia ATR quanto uma matriz de identificador forem fornecidos os cart es retornados corresponder o sequ ncia ATR fornecida e suportar o as interfaces especificadas LONG CasListCards IN SCARDCONTEXT hContext IN LPCBYTE pbAtr IN LPCGUID rgguidinterfaces IN DWORD cguidInterfaceCount OUT LPTSTR mszCards IN OUT LPDWORD pcchCards Par metros hContext Fornece o identificador do contexto do gerente de recursos para a consulta O contexto do gerente de recursos pode ser ajustado por uma sele o pr via por CasEstablishContext ou ajusta NULL se a consulta n o direcionada para um contexto espec fico pbAtr Fornece o endere o de uma sequ ncia ATR para comparar com cart es conhecidos ou NULL se n o for realizada nenhuma correspond ncia de ATR rgguidinterfaces Fornece uma matriz de identificadores GUIDs ou NULL se nenhuma correspond ncia de interface for realizada Quando uma matriz fornecida um nome de cart o ser retornado apenas se todos os id
26. o controlar diretamente Nenhum outro aplicativo ter acesso concedido a ele SCARD SHARE SHARED SCARD SHARE EXCLUSIVE SCARD SHARE DIRECT dwPreferredProtocols Fornece uma m scara de bits de protocolos aceit veis para a conex o Os valores poss veis que podem ser combinados com as opera es OR s o Valor Significado SCARD PROTOCOL TO T 0 um protocolo aceit vel SCARD PROTOCOL T1 T 1 um protocolo aceit vel Este par metro s poder ser zero se dwShareMode ajustado para SCARD SHARE DIRECT Neste caso n o 0 haver nenhum driver at que uma diretiva de controle IOCTL SMARTCARD SET PROTOCOL seja enviada com CasControl phCard Recebe um identificador que identifica a conex o ao cart o inteligente na leitora designada 62 pdwActiveProtocol Recebe o marcador que indica o protocolo ativo estabelecido Poss veis valores Valor Significado SCARD PROTOCOL TO T 0 o protocolo ativo SCARD PROTOCOL T1 T 1 o protocolo ativo SCARD SHARE DIRECT foi especificado de forma que nenhuma negocia o de protocolo tenha ocorrido poss vel que n o haja cart o na leitora SCARD PROTICOL UNDEFINED Valores de Retorno V lido SCARD S SUCCESS Inv lido Um c digo de erro aparecer para uma lista de c digos de erro consultar C digos de Erro Observa es CasConnect uma fun o de acesso do cart o inteligente e da leitora 63 6 3 5 CasControl A fun o CasControl d
27. o nome apropriado do grupo do qual a leitora deve ser removida Valores de Retorno v lido SCARD S SUCCESS e Um c digo de erro aparecer para uma lista de c digos de erro Inv lido sets consultar C digos de Erro Observa es Quando a ltima leitora for removida de um grupo o grupo automaticamente esquecido CasRemoveReaderFromGroup uma fun o de gerenciamento da base de dados Para adicionar uma leitora ao grupo de leitoras utilize CasAddReaderToGroup 88 6 3 28 CasSetAttrib A fun o CasSetAttrib estabelece o atributo da leitora dado para o manipulador dado Ela n o afeta o status da leitora do driver da leitora ou do cart o inteligente Nem todos os atributos s o suportados por todas as leitoras nem podem eles ser ajustados a todo o momento pois muitos dos atributos est o sob controle direto do protocolo de transporte LONG CasSetAttrib IN SCARDHANDLE hCard IN dwaAttrld IN LPCBYTE pbAttr IN DWORD cbAttrLen Par metros hCard Fornece o valor de refer ncia retornado do CasConnect dwAttrid Fornece o identificador para estabelecer o atributo PbAttr Aponta para um buffer que fornece o atributo cujo ID fornecido em dwaAttrld cbAttrLen Fornece o comprimento em bytes do valor do atributo no buffer pbAttr Valores de Retorno v lido SCARD S SUCCESS EN Um c digo de erro aparecer para uma lista de c digos de erro Inv lido ae consultar C digos de Erro Obs
28. pvReserved1 Reservado para uso futuro e deve ser NULL Reservado para permitir que um aplicativo de gerenciamento privilegiado adequado aja em nome de outro usuario pvReserved2 Reservado para uso futuro e deve ser NULL Reservado para permitir que um aplicativo de gerenciamento privilegiado adequado aja em nome de outro terminal phContext Recebe um identificador do contexto do gerente de recursos estabelecido Este identificador pode agora ser fornecido para outras fun es que tentem trabalhar dentro deste contexto Valores de Retorno v lido SCARD_S_SUCCESS A Um c digo de erro aparecer para uma lista de c digos de erro consultar Inv lido iam C digos de Erro Observa es O identificador de contexto retornado pelo CasEstablishContext pode ser utilizado por consulta base de dados e fun es de gerenciamento Para liberar um contexto estabelecido do gerente de recursos utilize CasReleaseContext 67 6 3 9 CasForgetCardType A fun o CasForgetCardType remove o cart o inteligente introduzido do subsistema do cart o inteligente LONG CasForgetCardType IN SCARDCONTEXT hContext IN LPCTSTR szCardName Par metros hContext Fornece o identificador do contexto do gerente de recursos O contexto do gerente de recursos ajustado por uma sele o pr via para CasEstablishContext szCardName Fornece o nome apropriado do cart o a ser removido da base de dados do cart o inteligente Valores de Reto
29. 4 bytes 1 dados numa determinada posi o indica suporte para o protocolo associado suportados 0x0001 indica suporte para o protocolo 2 wire 0x0002 indica suporte para o protocolo 3 wire 0x0004 indica suporte para o protocolo IC Todos os outros valores est o fora desta especifica o e devem ser tratados pelos drives do 22 Classe de Elemento de TAG TEN Dado Codificado Informa es Dado M ximo fornecedor Gerenciamento de Energia 0 Gerenciamento de Energia 0x0131 4 bytes Se 0 o dispositivo n o suporta power down suportado enquanto o cart o esta inserido Se diferente de zero a leitora tem suporte Caracter sticas de Garantia de Seguran a 0x00000000 DWORD que o resultado de uma opera o bitwise OR executada nos seguintes valores 0x00000000 Nenhum dispositivo Dispositivos de 0x00000001 Reservado para uso Futuro RFU autentica o do 0x00000002 Teclado Num rico Pin Pad usu rio para O 0x910 sujas 0x00000004 Teclado cart o 0x00000008 Scanner de impress o digital 0x00000010 Scanner de retina 0x00000020 Scanner de imagem 0x00000040 Scanner de padr o de voz 0x00000080 Dispositivo de display Ox0000dd00 dd um dispositivo definido pelo fornecedor 0x00000000 DWORD que o resultado de uma opera o bitwise OR executado nos seguintes valores 0x00000000 Nenhum dispositivo 0x00000001 Reservado para uso Futuro RFU Dienaenivede 0x00000002 Teclad
30. 7816 3 Isto inclui os procedimentos de Cold e Warm Reset O di logo entre a leitora e o cart o conduzido atrav s das seguintes opera es consecutivas a Conex o e Ativa o dos contatos pela leitora b Reset do Cart o c ATR Answer to Reset pelo cart o d Transa o troca de informa es entre o cart o e a leitora e Desativa o dos contatos pela leitora 3 1 Conex o e Ativa o dos Contatos O circuito el trico da leitora n o ativado at os contatos estarem apropriadamente conectados na interface isto evita poss veis danos ao cart o A ativa o dos contatos pela interface da leitora consiste das seguintes opera es consecutivas a RST Reset em n vel l gico baixo b Vcc ativo c I O em modo de recep o d CLK Clock ativado e estabilizado 3 2 Reset do Cart o 3 2 1 Cold Reset O procedimento de ativa o por Cold Reset consiste das seguintes opera es consecutivas Esta representado na figura 3a e as indica es de tempo ta tb e tc est o descritas de acordo com a norma ISO IEC 7816 3 a Reset em n vel l gico baixo e I O em modo de recep o de dados b Vcc estabilizado c Uma vez que Vcc esta estabilizado aplicado um Clock est vel em CLK num dado tempo ta ta lt 200 f d O Reset RST mantido em n vel l gico baixo por um per odo definido por ta tb Sendo tb lt 400 ciclos de clock tb lt 400 f e O ATR Answer to Reset monitorad
31. CARD AUTOALLOCATE simplificando o uso das outras fun es do gerente de recursos Para Selecione Liberar mem ria retornada atrav s do uso do SCARD_AUTOALLOCATE CasFreeMemory 6 1 6 Fun es de Rastreabilidade do Cart o Inteligente Estas fun es permitem que voc rastreie cart es em leitoras Estas rotinas normalmente utilizam a estrutura SCARD READERSTATE dentro de uma matriz Para Selecione Procurar um cart o cuja sequ ncia de ATR atributos corresponda a um nome de s i CasLocateCards cart o fornecido Bloquear a execu o at que a disponibilidade atual de cart es mude CasGetStatusChange Concluir a es pendentes CasCancel 50 6 1 7 Fun es de Acesso do Cart o Inteligente e da Leitora Estas fun es se conectam e comunicam com um cart o inteligente espec fico Opera es de entrada sa da do cart o utilizam um buffer para envio e recebimento de dados e uma estrutura que cont m informa es para controle de protocolos A estrutura de informa es para controle de protocolo se inicia sempre com uma estrutura SCARD IO REQUEST Para Selecione Conectar um cart o CasConnect Restabelecer uma conex o CasReconnect Concluir uma conex o CasDisconnect Iniciar uma transa o bloqueando o acesso de outros aplicativos ao cart o CasBeginTransaction Terminar uma transa o permitindo o acesso de outros aplicativos ao cart o CasEndTransaction Fornecer o status atual
32. Caso o script n o possa ser executado por favor utilize chmod 777 install para alterar o script para um arquivo execut vel Lembre se que voc precisar de privil gios de root 5 4 3 Reinicie o sistema 5 4 4 Ap s reiniciar insira um cart o Se o led da leitora ascender na cor vermelha a instala o da leitora foi bem sucedida Outras observa es a A vers o recomendada do Kernel 2 4 ou maior b Se voc tiver instalado uma vers o anterior do driver da Smartnonus v 1 3 4 ou menor por favor desinstale primeiro antes de executar uma nova instala o c O driver requer que PCSCLITE tenha sido compilado com libusb Se PCSCLITE foi compilado com libhal o driver n o ir funcionar 45 5 5 Mac OSX Requisitos Minimos de Ambiente Recomendados MacMini CoreDuo Mac OSx 10 5 x ou superior Mem ria Minimo de 1GB Espa o em Disco 200MB Vers o do Driver 1 4 1 Os drivers mais atuais est o dispon veis na p gina da leitora Smartnonus na Internet em www nonus com br smartnonus Selecione o arquivo para o MAC OSX macosx zip Recomendamos tamb m a instala o do Token Admin dispon vel em http www certisign com br downloads SafeSign3 0 MAC10 5 Leopard zip 5 5 1 Depois da transfer ncia dos arquivos acima clique no Finder 5 5 2 Clique no menu da parte superior da tela e escolha In cio Voltar Pasta Superior tT E Computador REC Mesa RD Rede 36K EB iDisk gt Aplicativos C
33. Fornece o valor de refer ncia obtido de uma sele o anterior para o CasConnect Este valor tamb m seria utilizado em uma sele o anterior para CasBeginTransaction dwDisposition Indica o que fazer com o cart o na leitora conectada no fechamento Poss veis valores Valor Significado SCARD LEAVE CARD N o fa a nada em particular SCARD RESET CARD Reinicialize o cart o SCARD UNPOWER CARD Energize o cart o SCARD EJECT CARD Ejete o cart o Valores de Retorno v lido SCARD_S_SUCCESS E Um c digo de erro aparecer para uma lista de c digos de erro Inv lido os consultar C digos de Erro Observa es CasEndTransaction uma fun o de acesso do cart o inteligente e da leitora 66 6 3 8 CasEstablishContext A fun o CasEstablishContext estabelece o contexto do gerente de recursos o escopo dentro do qual as opera es da base de dados s o realizadas LONG CasEstablishContext IN DWORD dwScope IN LPCVOID pvReserved1 IN LPCVOID pvReserved2 OUT LPSCARDCONTEXT phContext Par metros dwScope Fornece o escopo do contexto do gerente de recursos Possiveis valores Valor Significado As opera es da base de dados s o realizadas dentro do dom nio do usu rio As opera es da base de dados s o realizadas dentro do dom nio do usu rio O SCARD SCOPE SYSTEM aplicativo de sele o deve ter permiss es de acesso apropriados para qualquer a o da base de dados SCARD SCOPE USER
34. H energia sendo fornecida para o cart o mas o driver da leitora n o conhece o modo do cart o O cart o foi reinicializado e est aguardando a negocia o PTS O cart o foi reinicializado e foram estabelecidos protocolos espec ficos de comunica o Recebe o protocolo atual se houver O valor retornado s faz sentido se o valor retornado de pdwState for SCARD SPECIFICMODE Valor SCARD PROTOCOL RAW SCARD PROTOCOL TO SCARD PROTOCOL T1 Os poss veis valores retornados s o os seguintes Significado O protocolo de transfer ncia RAW est em uso O protocolo ISO 7816 3 T 0 est em uso O protocolo ISO 7816 3 T 1 est em uso 90 pbAtr Aponta para um buffer de 32 bytes que recebe a sequ ncia ATR do cart o inserido atualmente se dispon vel pcbAtrLen Aponta para um DWORD para receber o numero de bytes na sequ ncia ATR 32 bytes no m ximo Valores de Retorno v lido SCARD S SUCCESS E Um c digo de erro aparecer para uma lista de c digos de erro Inv lido os consultar C digos de Erro Observa es CasStatus uma fun o de acesso do cart o inteligente e da leitora 91 6 3 30 CasTransmit A fun o CasTransmit envia uma solicita o de servi o para o cart o inteligente e espera receber dados de volta do cart o LONG CasTransmit IN SCARDHANDLE hCard IN LPCSCARD_IO_REQUEST pioSendPci IN LPCBYTE pbSendBuffer IN DWORD cbSendLength IN OUT LPSCARD IO REQUEST p
35. HA gt Utilit rios O EU Pastas Recentes gt Ir para Pasta TEG Conectar ao Servidor K 5 5 3 Clique na pasta de Transfer ncias Obs Em alguns MACs existe um atalho para transfer ncias ao lado do icone do lixo gt Sites gt Transfer ncias vpd properties 5 5 4 Na pasta Transfer ncias voc encontrar os arquivos conforme figura abaixo Inicie com a instala o do SafeSign execute o arquivo SafeSign e confirme a instala o at o final 46 gt EZUSB 141 MACX Universal F EZUSB 141 MACX Universal zip SafeSign 3 0 pkg F SafeSign3 0_MAC10 5_Leopard zip 5 5 5 Em seguida execute o mesmo procedimento abra a pasta EZUSB 141 MACX Universal e execute o arquivo de driver ezusb driver setup mpkg Inst Padr o em Macintosh HD u pinho O a i ral EL Introdu o Isso ocupar 20 MB de espa o em seu computador Clique em Instalar para realizar uma instala o padr o deste software no disco Macintosh HD Y Instala o O Sumario Alterar Localiza o da Instala o Manual T cnico Smartnonus 47 Introdu o O Sele o de O Tipo de ing i o instala o gt A instala o foi realizada corretamente O software foi instalado Clique em Reiniciar para finalizar a instala o do software 4 5 5 6 Reinicie o MAC Em seguida conecte a leitora Smartnonus Clique no Menu IR em seguida em Aplicativos enco
36. J Computador b a Controladores de som video e jogos gt gj Controladores IDE ATA ATAPI gt Controladores USB barramento serial universal gt 23 Dispositivos de imagem A Dispositivos de Interface Humana gt 9 Dispositivos de sistema P Jungo 3 Leitores de cart es inteligentes 43 EZUSB PC SC Smart Card Reader gt 4 Monitores gt Pl Mouse e outros dispositivos apontadores gt f Outros dispositivos gt JB Processadores gt R dios Bluetooth gt ED Teclados gt ta Unidades de disco b f Unidades de DVD CD ROM Figura B 3 1 Gerenciador de Dispositivos f Localize e clique no grupo Leitores de cart es inteligentes clique em EZUSB PC SC Smart Card Reader com o bot o direito do Mouse e aponte e clique em Propriedades g Clique na aba driver Nesta aba esta identificada a vers o corrente do driver conforme a figura abaixo A vers o corrente do software driver at a impress o deste manual para o Windows 7 conforme abaixo 3 1 7 0 102 28 09 2009 3 1 7 0 Microsoft Windows Hardware Compatibility Publisher Exibir detalhes dos arquivos de driver Atualizar o driver deste dispositivo Se o dispositivo falhar ap s a atualiza o do driver reverter para o driver instalado anteriormente Desabilitar o dispositivo selecionado Desinstalar o driver Avan ado figura B 3 2 Aba Driver de Propriedades da leitora Manual T cnico Smartnonus 103 C Demonst
37. ORD dwShareMode IN DWORD dwPreferredProtocols IN DWORD dwlnitialization OUT LPDWORD pdwaActiveProtocol Par metros hCard Fornece o valor de refer ncia obtido de uma sele o anterior para o CasConnect dwShareMode Fornece um marcador que indica se outros aplicativos podem formar conex es com este cart o Poss veis valores Valor Significado Este aplicativo compartilhar o cart o com outros aplicativos Este aplicativo n o compartilhar o cart o com outros aplicativos SCARD SHARE SHARED SCARD SHARE EXCLUSIVE dwPreferredProtocols Fornece uma m scara de bits de protocolos aceit veis para esta conex o Os valores poss veis que podem ser combinados com a opera o OR s o Valor Significado SCARD PROTOCOL TO T 0 um protocolo aceit vel SCARD PROTOCOL T1 T 1 um protocolo aceit vel dwlnitialization Indica que tipo de inicializa o deve ser realizado no cart o Poss veis valores Valor Significado SCARD LEAVE CARD N o fa a nada em particular na reconex o SCARD RESET CARD Reinicialize o cart o Warm Reset Desconecte o cart o e reinicialize o Cold SCARD UNPOWER CARD E z Reset pdwActiveProtocol Recebe o marcador que indica o protocolo ativo estabelecido Poss veis valores Valor Significado SCARD_PROTOCOL_TO T 0 o protocolo ativo SCARD PROTOCOL T1 T 1 o protocolo ativo 85 Valores de Retorno Se a fun o for O valor de retorno ser v lido SCARD S SUCCES
38. S inv lido Um c digo de erro aparecer para uma lista de c digos de erro consultar C digos de Erro Observa es CasReconnect uma fun o de acesso do cart o inteligente e da leitora 86 6 3 26 CasReleaseContext A fun o CasReleaseContext fecha um contexto do gerente de recursos estabelecido liberando qualquer recurso alocado sob aquele contexto incluindo objetos SCARDHANDLE e mem ria alocada utilizando o designador de comprimento SCARD AUTOALLOCATE LONG CasReleaseContext IN SCARDCONTEXT hContext Par metros hContext Fornece o identificador do contexto do gerente de recursos O contexto do gerente de recursos ajustado por uma sele o pr via para CasEstablishContext Valores de Retorno v lido SCARD S SUCCESS oi Um c digo de erro aparecer para uma lista de c digos de erro Inv lido Ea consultar C digos de Erro 87 6 3 27 CasRemoveReaderFromGroup A fun o CasRemoveReaderFromGroup remove uma leitora de um grupo de leitoras existente Esta fun o n o afeta a leitora ou grupo de leitoras LONG CasRemoveReaderFromGroup IN SCARDCONTEXT hContext IN LPCTSTR szReaderName IN LPCTSTR szGroupName Par metros hContext Fornece o identificador do contexto do gerente de recursos O contexto do gerente de recursos ajustado por uma sele o pr via para CasEstablishContext szReaderName Fornece o nome apropriado da leitora a ser removida szGroupName Fornece
39. Smartnonus MANUAL TECNICO NONUS 2011 Rev IT DCM 108v0 indice 1 Caracteristicas T cnicas 2 Caracteristicas Fisicas e El tricas 2 1 Inser o do Cart o 2 2 Descri o dos Contatos El tricos 2 3 Propriedades El tricas dos Contatos 2 3 1 1 0 C7 SCO 10 2 3 2 VPP C6 NC C6 2 3 3 CLK C3 SCO_CLK 2 3 4 Reset C2 SCO_RST 2 3 5 Vec C1 SCO_VCC 3 Sinais Eletr nicos e Protocolos 3 1 Conex o e Ativa o dos Contatos 3 2 Reset do Cart o 3 2 1 Cold Reset vw O O W WAANNN DBD DD WN 3 2 2 Warm Reset m jo 3 3 Desativa o dos Contatos 3 4 ATR 3 5 PPS Protocol and Parameter Selection 3 6 Protocolos de Transmiss o T 0 T 1 e APDU 3 6 1 Protocolo T O PEP e e Aa re O e he U u 3 6 2 Protocolo T 1 pa N 3 6 3 APDU pa oo 4 Interoperabilidade com Computadores Pessoais 4 1 Caracter sticas Operacionais 4 2 Enumera o das funcionalidades operacionais da Leitora 4 3 Eventos do Cart o 4 4 Gerenciamento da Interface do Cart o Inteligente 4 5 Suporte de Protocolo 4 5 1 Negocia o do Protocolo N N N N N a A e e O N N o 4 5 2 PC SC Suporte ao protocolo T 0 N oo 4 5 3 PC SC Suporte ao protocolo T 1 N oo 4 6 Gerenciamento de Energia no Cart o 4 7 Caracter sticas Mec nicas 4 8 Dispositivos Adicionais de Seguran a 4 9 Caracter sticas especificas do Fa
40. TOPPED SCARD E SHARING VIOLATION SCARD E SYSTEM CANCELLED SCARD E TIMEOUT SCARD E UNKNOWN CARD SCARD E UNKNOWN READER SCARD F COMM ERROR SCARD F INTERNAL ERROR SCARD F UNKNOWN ERROR SCARD F WAITED TOO LONG SCARD S SUCCESS SCARD W REMOVED CARD SCARD W RESET CARD Esta se o descreve os c digos de erro prim rio retornados pelas fun es do cart o inteligente Defini o A a o foi cancelada por uma solicita o CasCancel O sistema n o pode descartar a m dia da maneira solicitada O cart o inteligente n o possui os requisitos m nimos para suporte O driver da leitora n o produziu um nome de leitora exclusivo O buffer de dados para dados retornados muito pequeno para os dados retornados Uma sequ ncia ATR obtida do registro n o uma sequ ncia ATR v lida O identificador fornecido inv lido Um ou mais dos par metros fornecidos n o pode ser interpretado adequadamente Informa es de inicializa o de registro inexistente ou inv lido Um ou mais dos valores de par metros fornecidos n o pode ser interpretado adequadamente A leitora ou o cart o n o est pronta o para aceitar comandos Houve uma tentativa de terminar uma transa o n o existente N o h mem ria suficiente dispon vel para completar este comando O gerente de recursos do cart o inteligente n o est funcionando A opera o exige um cart o inteligente mas n o h nenhum cart o inteligente no disp
41. Wizard installs E2USB Smart Card Reader Setup For Windows Vista 32 bit This may take several minutes Status InstallShield 5 2 4 O programa de instala o copiar os arquivos do driver da leitora Smartnonus No final do processo de instala o voc receber um aviso neste instante conecte a leitora Smartnonus numa porta USB livre de seu computador e clique no bot o OK Conecte seu dispositivo a este computador a qualquer momento depois que a instala o tiver sido conclu da Quando conectar o leitor na porta USB os drivers de instala o agora ser o encontrados pelo Sistema Operacional Instala o de Software de Driver x EZUSB PC SC Smart Card Reader Instalado O software para este dispositivo foi instalado com xito EZUSB PC SC Smart Card Reader Pronto para uso Manual T cnico Smartnonus 38 5 2 5 Por fim clique em Finish ou Concluir pal EzUSB Smart Card Reader Setup For Windows Vista 32 bit InstallShield Wizard InstallShield Wizard Completed The InstallShield Wizard has successfully installed EZUSB Smart Card Reader Setup For Windows Vista 32 bit Click Finish to exit the wizard s 39 5 2 6 Poder ainda fazer uma verifica o adicional de instala o bem sucedida Aponte e clique no Menu Iniciar clique em Configura es e em seguida clique em Painel de Controle Localize o cone Sistema aponte e clique em Gerenciador de Dispositivos Com o G
42. X ou 0x9X v rias condi es de erro podem ser reportadas pelo cart o A ISO 7816 3 define 5 condi es de erro Valor de SW1 Descri o Ox6E O cart o n o suporta a classe de instru o 0x6D Byte de instru o INS inv lido Ox6B Refer ncia Incorreta 0x67 Cumprimento incorreto Ox6F Sem diagn stico em particular 16 3 6 2 Protocolo T 1 A leitora Smartnonus suporta o protocolo T 1 de acordo com a norma ISO 7816 3 O protocolo T 1 um protocolo ass ncrono half duplex orientado a blocos O protocolo T 1 esta localizado na camada 2 do modelo OSI Data Link Layer O protocolo T 1 permite controle de fluxo encadeamento de blocos ressincroniza o e comunica es de tamanho ilimitado Possui um sistema de detec o e corre o de erros mais sofisticado do que T 0 Embora tenha vantagens em rela o ao protocolo T 0 o seu uso deve ser ponderado pois ele exige um desenvolvimento mais complexo de software e em alguns casos exigir maior consumo de mem ria ROM e mem ria RAM aumentando os custos do cart o inteligente A estrutura do bloco de comando no protocolo T 1 composta por Campo de Pr logo Prologue Field Campo de Informa o Information Field APDU Dados Campo de Epilogo Epilogue Field Campo de pr logo oes Campo de epilogo Byte de o Endere o C digo de do n controle Tamanho Opcional Aptaceas de erro protocolo LEN INF NAD PCB UN
43. a leitora informa o protocolo desejado 14 PPSO b8 b7 b6 b5 b4 b3 b2 b1 X PRSS PRSZ FPS1 k Protocolo J T Figura 3 5b Conte do do byte PPSO PPS1 Par metros F e D PPS1 codifica os par metros F e D do mesmo modo que o byte TA do ATR Se preciso a leitora indica a sele o de valores para F e D Se PPS1 n o for enviado os valores F 1 e D 1 s o assumidos PPS2 C digo N PPS2 indica nos bytes b2 e b1 o suporte ao par metro N Guardtime Se PPS2 for enviado e n o ecoado na resposta a leitora dever rejeitar ou enviar um reset ao cart o O uso de PPS3 n o esta definido esta reservado para uso futuro RFU PCK o caractere de valida o ou checagem Se o cart o receber e aceitar a requisi o PPS como correta dever ecoar o comando enviado como confirma o Ap s uma troca bem sucedida de requisi o e confirma o PPS a transmiss o utilizar o protocolo e par metros negociados Caso o cart o receba uma requisi o PPS inv lida n o enviar confirma o Se a leitora n o receber confirma o dever rejeitar o cart o ou enviar um Reset 3 6 Protocolos de Transmiss o T 0 T 1 e APDU Atualmente a leitora Smartnonus suporta os protocolos T 0 e T 1 definidos na norma ISO 7816 3 T 0 Transmiss o half duplex assincrona caracteres T 1 Transmiss o half duples ass ncrona blocos O firmware da leitora n o realiza a convers o do protocolo T 0 para T 1 ou T 1 para T
44. a para o identificador dado Ela n o afeta o status da leitora do driver ou do cart o LONG CasGetAttrib IN SCARDHANDLE hCard IN DWORD dwScope OUT LPBYTE pbAttr IN OUT LPDWORD pcbAttrLen Par metros hCard Fornece o valor de refer ncia retornado do CasConnect dwAttrib Fornece o identificador para estabelecer o atributo PbAttr Aponta para um buffer que fornece o atributo cujo ID fornecido em dwaAttrld Se este valor for NULL CasGetAttrib ignora o comprimento do buffer fornecido em pcbAttrLength escreve o comprimento do buffer que seria retornado se este par metro n o tivesse sido NULL para pcbAttrLength e retorna um c digo v lido pcbAttrLen Fornece o comprimento do buffer pbAttr em bytes e recebe o comprimento real do atributo recebido Valores de Retorno v lido SCARD S SUCCESS a Um c digo de erro aparecer para uma lista de c digos de erro Inv lido ae consultar C digos de Erro Observa es CasGetAttrib fun es de acesso direto do cart o 72 6 3 14 CasGetCardTypeProviderName A fun o CasGetCardTypeProviderName retorna o nome do m dulo biblioteca de liga o din mica contendo o fornecedor para um nome de cart o dado e tipo de fornecedor LONG CasGetCardTypeProviderName IN SCARDCONTEXT hContext IN LPCTSTR szCardName IN DWORD dwProviderld OUT LPTSTR szProvider IN OUT LPDWORD pcchProvider Par metros hContext Fornece o identificador que identifica o contex
45. a uma lista de c digos de erro Inv lido ee consultar C digos de Erro Observa es CasControl uma fun o de acesso Direto do cart o 64 6 3 6 CasDisconnect A fun o CasDisconnect conclui uma conex o previamente aberta entre a aplicativo de sele o e um cart o inteligente na leitora alvo LONG CasDisconnect IN SCARDHANDLE hCard IN DWORD dwDisposition Par metros hCard Fornece o valor de refer ncia obtido de uma sele o anterior para o CasConnect dwDisposition Indica o que fazer com o cart o na leitora conectada no fechamento Poss veis valores Valor Significado SCARD LEAVE CARD N o fa a nada em particular SCARD RESET CARD Reinicialize o cart o SCARD UNPOWER CARD Energize o cart o SCARD EJECT CARD Ejete o cart o Valores de Retorno v lido SCARD S SUCCESS a Um c digo de erro aparecer para uma lista de c digos de erro Inv lido a consultar C digos de Erro Observa es Se um aplicativo que selecionou CasConnect previamente existir sem selecionar CasDisconnect o cart o reinicializado automaticamente CasDisconnect uma fun o de acesso do cart o inteligente e da leitora 65 6 3 7 CasEndTransaction A fun o CasEndTransaction completa uma transa o previamente declarada permitindo que outros aplicativo retomem as intera es com o cart o LONG CasEndTransaction IN SCARDHANDLE hCard IN DWORD dwDisposition Par metros hCard
46. ado Para o protocolo do cart o inteligente existem 2 partes T 0 e T 1 Para T 0 o mecanismo de tratamento de erros baseado na checagem de paridade Para T 1 existem 3 mecanismos para tratamento de erros O primeiro o BWT time out O segundo a perda de sincroniza o O terceiro ocorre quando o cart o envia um Bloco R para a leitora indicando um erro de transmiss o paridade incorreta ou erro de EDC ocorre 25 4 5 Suporte de Protocolo De acordo com a defini o de camadas da ISO 7816 o Sistema de Componentes da Leitora Smartnonus implementa as camadas f sica e de enlace de dados ISO 7816 3 e 10 A figura abaixo mostra o fluxo de informa es entre o Provedor de Servi os do Cart o e o Sistema de Componentes da Leitora Smartnonus O Sistema de Componentes da Leitora encapsula ou esconde do N vel de Aplica o todos os detalhes do protocolo e apresenta uma interface padr o baseada na estrutura de comandos e respostas da norma ISO 7816 4 ISO 7816 4 Provedor de servi os do cart o N vel de aplica o ICC service provider Mapeamento de APDU s e Respostas Negocia o R APDU Informa o de protocolo ISO 7816 3 e 10 Sistema de componentes da leitora Camada ou enlace de dados IFD Subsystem ISO 7816 3 e 10 Camada f sica Figura 4 5a 4 5 1 Negocia o do Protocolo A leitora Smartnonus suporta os protocolos T 0 e T 1 Vide 3 6 Suporta a freq
47. adr o ScardSDefaultReaders buscado nMaxGroupNames N mero maximo de bytes vers o ANSI ou caracteres vers o UNICODE na sequ ncia lpstrGroupNames rgguidinterfaces Reservado para uso futuro Uma matriz de GUIDs que identificam as interfaces necess rias Ajuste este membro para NULL para esta libera o cguidInterfaces Reservado para uso futuro O n mero de interfaces na matriz rgguidinterfaces Ajuste este membro para NULL para esta libera o lpstrCardNames Aponta para um buffer que contenha sequ ncias de nomes de grupos terminados em NULL A ltima sequ ncia no buffer deve ser terminada por dois caracteres NULL Cada sequ ncia o nome de um cart o que deve ser localizado nMaxCardNames N mero maximo de bytes vers o ANSI ou caracteres vers o UNICODE na sequ ncia lpstrCardNames IpfnCheck Aponta para a rotina de verifica o do cart o do selecionador Se nenhuma verifica o especial de cart o for necess ria este apontador NULL Se o cart o for rejeitado pela rotina de verifica o retornado FALSE e o cart o ser desconectado Se o cart o for rejeitado pela rotina de verifica o retornado TRUE O prot tipo para a rotina de verifica o Boolean Check SCardContext o contexto do cart o passado no bloco do par metro hCard identificador do cart o pvUserData apontador para dados do usu rio passados no bloco do par metro 57 IpfnConnect Aponta para a roti
48. aixo c I O em n vel l gico baixo d Vcc inativo 10 3 4 ATR Os dados entre o leitor e o cart o s o trocados por uma nica linha bidirecional half duplex A comunica o com o cart o sempre iniciada pela leitora O que significa que o cart o nunca envia dados sem um estimulo externo Em seguida da ativa o el trica o cart o executa um Reset e envia um ATR Answer to Reset a leitora O ATR independente de protocolo de transmiss o e permite a leitora avaliar o ATR que cont m par metros relacionados ao cart o e a transmiss o de dados Cart o 1 Reset Leitora Inteligente 1 Smartnonus I l l I ATR E a l l Figura 3 4a Ap s o Reset o cart o envia uma resposta ATR Uma opera o de reset resulta em uma resposta ATR do cart o definida pela norma ISO IEC 7816 Byte inicial Byte de formata o Bytes hist ricos di a a opcionais l q i I 7 dl i TO a TA TB i TC T NM TK TCK MoET h aa neu dae Bytes de interface ene Byte checksum Figura 3 4b Conteudo do ATR Segue abaixo uma breve descri o dos bytes que comp e o ATR para mais informa es consulte a norma ISO IEC 7816 3 TS Byte Inicial O byte TS permite sincroniza o do frame serial e determina se o cart o trabalha com conven o direta 3B ou inversa 3F TO Byte de formata o O byte TO determina quantos bytes de interface e quantos bytes de hist rico est o prese
49. ara Linux est dispon vel na p gina da leitora Smartnonus na Internet em www nonus com br smartnonus Selecione o download do arquivo de driver para Linux Voc precisar de privil gios de root para instalar o driver da leitora Smartnonus Ap s o download descompacte o arquivo Linux x86 tar Ap s descompactado este o conte do do arquivo de driver vers o 1 4 9 Pasta driver ezusb v1 4 9 check env Script para verifica o do ambiente de instala o install Script de instala o driver install Sub Programa de instala o drivers ezusb so Driver da leitora drivers Info plist Arquivo de configura o do PCSCLITE USB Pasta mifdtest Cont m um programa de teste PC SC simplificado para identificar se o driver esta instalado e ativo Para efetuar a instala o complete os seguintes passos 5 4 1 Execute o script de verifica o do ambiente de instala o check env Se o terminal exibir a mensagem PC SC Daemon Not Ready por favor v para o site http www linuxnet com middle html para fazer o download e instalar o pacote pcsclite Se o terminal exibir a mensagem Error USB Device File System Not Mounted por favor monte o sistema de arquivo USB de acordo com a instru o Observa o Caso o script n o possa ser executado por favor utilize chmod 777 check env para alterar o script para um arquivo execut vel 5 4 2 Execute o script de instala o install Observa o
50. aryProvider IN LPGUID rgguidInterfaces IN DWORD dwinterfaceCount IN LPCBYTE pbAtr IN LPCBYTE pbAtrMask IN DWORD cbAtrLen Parametros hContext Fornece o identificador do contexto do gerente de recursos O contexto do gerente de recursos ajustado por uma sele o pr via para CasEstablishContext szCardName Fornece o nome pelo qual o usu rio pode reconhecer o cart o pguidPrimaryProvider Aponta para o identificador GUID para o fornecedor do servi o prim rio para o cart o inteligente rgguidInterfaces Fornece uma matriz de identificadores GUIDs que identificam as interfaces suportadas pelo cart o inteligente dwinterfaceCount Fornece o n mero de identificadores na matriz rgguidInterfaces pbAtr Fornece uma sequ ncia de ATR que pode ser utilizada para fins de correspond ncia ao consultar a base de dados do cart o inteligente vide CasListCards O comprimento da sequ ncia determinado por an lise normal de ATR pbAtrMask Fornece uma mascara de bits opcional para ser utilizada ao compara os ATRs dos cart es inteligentes para o ATR fornecido em pbAtr Se este valor n o NULL ele deve apontar para uma sequ ncia de bytes com o mesmo comprimento da sequ ncia de ATR fornecida em pbAtr Quando uma dada sequ ncia de ATR A comparada com o ATR fornecido em pbAtr ela corresponde se e apenas se A amp M pbAtr onde M a m scara fornecida e amp representa o AND l gico bit a bit cbAtrLen Fornece o
51. atureza do problema importante que esteja pr ximo ao computador onde a leitora esta instalada e que tenha direitos administrativos sobre o computador para instala o de drivers e ou diagn sticos Para diagn stico de suporte t cnico o n mero de s rie suficiente para que a Nonus identifique as vers es de Hardware e Firmware do equipamento As informa es sobre o software ou vers o de driver instalados poder o ser obtidas no computador onde a leitora esta instalada Abaixo estamos indicando como cada uma destas informa es pode ser obtida individualmente 99 B 1 Identifica o do Hardware Para obter a vers o de hardware da leitora Smartnonus ser preciso abrir o equipamento N o realize esta opera o a menos que solicitada pelo t cnico do suporte Nonus Lembramos que a abertura n o autorizada do equipamento pode acarretar em perda de garantia A vers o de hardware pode ser identificada de 2 maneiras 1 Atrav s de etiqueta adesiva para as placas sem serigrafia 2 Serigrafia no centro da placa de circuito impresso figura B 1 A vers o corrente do hardware at a impress o deste manual REV 4 Figura B 1 Identifica o da vers o de hardware da leitora Smartnonus 100 B 2 Identifica o do Firmware A vers o de firmware da leitora Smartnonus pode ser obtida atrav s do programa de Demonstra o da API Smartnonus Este programa esta dispon vel no site da Nonus em www nonus com br smar
52. bricante 4 10 Interface de Comunica o USB 5 Manuais de Instala o 5 1 Microsoft Windows 7 32 e 64 bits 5 2 Microsoft Windows Vista 5 3 Microsoft Windows XP 5 4 Linux mB B Ww WwW Ww WN N N N aa re a O Oo oOo o 5 5 Mac OSX 6 Refer ncia API PC SC Smartnonus 6 1 Vis o Geral da API 6 1 1 Fun es de Consulta Base de Dados do Cart o Inteligente 46 49 49 49 6 1 2 Fun es de Gerenciamento da Base de Dados do Cart o Inteligente 6 1 3 Fun es de Acesso Direto do Cart o 49 50 6 1 4 Fun es do Contexto do Gerente de Recursos 50 6 1 5 Fun o de Suporte do Gerente de Recursos 50 6 1 6 Fun es de Rastreabilidade do Cart o Inteligente 50 6 1 7 Fun es de Acesso do Cart o Inteligente e da Leitora 51 6 2 Estrutura do Cart o Inteligente 6 2 1 SCARD IO REQUEST 52 52 6 2 2 SCARD READERSTATE 53 6 2 3 OPENCARDNAME EX 55 6 2 4 OPENCARD SEARCH CRITERIA 57 6 3 Refer ncia da API 6 3 1 CasAddReaderToGroup 59 59 6 3 2 CasBeginTransaction 60 6 3 3 CasCancel 61 6 3 4 CasConnect 62 6 3 5 CasControl 64 6 3 6 CasDisconnect 65 6 3 7 CasEndTransaction 66 6 3 8 CasEstablishContext 67 6 3 9 CasForgetCardType 68 6 3 10 CasForgetReader 69 6 3 11 CasForgetReaderGroup 70 6 3 12 CasFreeMemory 71
53. bserva es do protocolo T 0 Para o protocolo T 0 os dados recebidos de volta s o os c digos de status SW1 e SW2 possivelmente precedidos de dados de resposta Os par grafos a seguir fornecem informa es nos buffers de envio e recebimento usados para transferir dados e emitir um comando Envio de Dados para o Cart o Para enviar n bytes de dados para o cart o onde n gt 0 os buffers de envio e recebimento devem ser formatados como a seguir Os primeiros quatro bytes do buffer pbSendBuffer cont m os valores de CLA INS P1 e P2 para a opera o T 0 O quinto byte deve ser ajustado para n o tamanho em bytes dos dados a serem transferidos para o cart o Os pr ximos n bytes dever o conter os dados a serem enviados para o cart o O par metro cbSendLength dever ser ajustado para o tamanho da informa o de cabe alho T 0 CLA INS P1 e P2 mais um byte contendo o comprimento dos dados a serem transferidos n mais o tamanho dos dados a serem enviados Neste exemplo este n 5 O pbRecvBuffer receber os c digos de status SW1 e SW2 da opera o O pcbRecvLength deve ser pelo menos 2 e ser ajustado para 2 depois do retorno 93 Obten o de Dados do Cart o Para receber n gt 0 bytes de dados do cart o os buffers de envio e recebimento devem ser formatados como a seguir Os primeiros quatro bytes do buffer pbSendBuffer cont m os valores de CLA INS P1 e P2 para a opera o T 0 O quinto byte deve ser ajustad
54. comprimento do ATR e a M scara de ATR opcional Se este valor for zero ent o o comprimento do ATR determinado por an lise normal de ATR Este valor n o pode ser zero ser um valor de pbAtrMask fornecido Valores de Retorno v lido SCARD S SUCCESS A Um c digo de erro aparecer para uma lista de c digos de erro Inv lido ae consultar C digos de Erro Observa es CasIntroduceCardType uma fun o de gerenciamento da base de dados Para remover um cart o inteligente utilize CasForgetCardType 77 6 3 18 CasIntroduceReader A fun o CasIntroduceReader apresenta um novo nome para uma leitora de cart o inteligente existente Nota leitoras de cart es inteligentes s o automaticamente apresentados ao sistema um programa de configura o de leitora de cart o inteligente tamb m pode apresentar uma leitora de cart o inteligente para o sistema LONG CaslntroduceReader IN SCARDCONTEXT hContext IN LPCTSTR szReaderName IN LPCTSTR szDeviceName Par metros hContext Fornece o identificador do contexto do gerente de recursos O contexto do gerente de recursos ajustado por uma sele o pr via para CasEstablishContext szReaderName Fornece o nome apropriado a ser atribu do para a leitora szDeviceName Fornece o nome do sistema da leitora do cart o inteligente Valores de Retorno V lido SCARD S SUCCESS PR Um c digo de erro aparecer para uma lista de c digos de erro Inv lido a consul
55. confiscar os cart es O cart o permanece acess vel ao usu rio para remo o a qualquer momento 4 4 Gerenciamento da Interface do Cart o Inteligente O sistema de componentes da leitora capaz de gerenciar a interface el trica do cart o de acordo com a parte 2 da especifica o PC SC Isto inclui Provis o de todos os sinais el tricos l gicos para os contatos do cart o Sequ ncia de ativa o e desativa o Reset Cold and Warm Reset Recupera o e Interpreta o correta do ATR O sistema de componentes da leitora pode notificar o Gerenciador de Recursos do cart o se um ATR inv lido foi transmitido Quando um ATR v lido transmitido e interpretado corretamente o sistema de componentes da leitora pode negociar os par metros de comunica o compat veis entre a leitora e o cart o O m dulo da interface prov uma interface ou servi o que torna dispon vel determinar o estado de um cart o a qualquer momento 24 A informa o retornada utiliza uma estrutura TLV tag length value vide ap ndice A Em adicional veja o ap ndice C Demonstra o API Smartnonus na sess o C 1 3 software demonstra o Nonus que permite executar este servi o Informa o TAG Tamanho Respostas retornadas como inteiros M ximo Presen a do 0x0300 1 byte 0 n o presente Cart o ICC 1 cart o presente mas n o engolido aplic vel apenas se a Leitora IFD suporta o recurso engolir o cart o 2
56. ctly msiexec exe mspaint exe svchost exe HUCE TROP ARGO REN ORR ORR N oR SCM exe Refresh E Recommend Apply X Cancel SCardSvr exe 43 5 3 7 Para conferir a instala o bem sucedida aponte e clique no menu Iniciar e em seguida clique em Painel de Controle selecione e clique no cone Sistema Na aba Hardware clique no bot o Gerenciador de Dispositivos Com o Gerenciador de Dispositivos aberto clique para expandir o grupo Leitoras de Cart es Inteligentes e poder visualizar a leitora Smartnonus descrita como EZUSB PC SC Smart Card Reader Gerenciador de dispositivos Arquivo A o Exibir Ajuda e ESB BEA lt Ra EB Adaptadores de rede l Adaptadores de video Baterias l Computador Controladores de som v deo e jogo Controladores IDE ATA ATAPI Es Controladores USB barramento serial universal Oy Dispositivos de interface humana J 1 Dispositivos de sistema E Jungo NE Leitoras de cart es inteligentes a PC SC Smart Card Reader 2 Monitores Mouse e outros dispositivos apontadores 2 Outros dispositivos Controlador de udio de multim dia Modem PCI PCMCIA adapters 88 Processadores Teclados Se Unidades de disco 5 4 Linux Requisitos Minimos de Ambiente Recomendados Kernel 2 4 ou superior Processador 1GHz ou superior Mem ria Minimo de 512MB Espa o em Disco 20MB Vers o do Driver 1 4 9 O arquivo de driver mais atual p
57. da leitora CasStatus Solicitar servi o e receber dados de volta de um cart o utilizando T 0 T 1 e CasTi it protocolos RAW asTransmi 51 6 2 Estrutura do Cart o Inteligente 6 2 1 SCARD IO REQUEST A estrutura SCARD IO REQUEST inicia uma estrutura de informa es para controle de protocolo Ent o qualquer informa o espec fica de protocolo imediatamente segue esta estrutura O comprimento inteiro da estrutura deve estar alinhado com o tamanho de palavras da arquitetura de hardware subjacente Por exemplo em Win32 o comprimento de qualquer informa o de PCI deve ser m ltiplo de 4 bytes para que ele se alinhe com uma vizinhan a de 32 bits typedef struct DWORD dwProtocol DWORD cbPciLength SCARD IO REQUEST Membros dwProtocol Identifica o protocolo em uso cbPciLength Fornece o comprimento em bytes da estrutura SCARD IO REQUEST mais qualquer informa o espec fica de PCI seguinte 52 6 2 2 SCARD_READERSTATE A estrutura SCARD_READERSTATE utilizada pelas fun es para rastrear cart es inteligentes em leitoras typedef struct LPCTSTR szReader LPVOID pvUserData DWORD _dwCurrentState DWORD dwEventState DWORD cbAtr BYTE rgbAtr 36 SCARD_READERSTATE PSCARD_READERSTATE LPSCARD_READERSTATE Membros szReader Aponta o nome da leitora que est sendo monitorada pvUserData N o utilizado pelo subsistema do cart o inteligente Utilizado pelo aplicativo dwCurrentSta
58. de resposta de processamento do cart o o SCL precisa apenas processar um byte de ACK A leitora ir ent o enviar os dados restantes associados ao ltimo cabe alho de comando ou reter dados do cart o Neste caso o sistema n o ir retornar um byte de ACK para o Provedor de Servi os do Cart o Conforme a norma PC SC a leitora Smartnonus n o interpreta ou processa outros bytes de resposta do cart o visto que estes s o geralmente espec ficos da aplica o e devem ser retornados para o Provedor de Servi os do Cart o 4 5 3 PC SC Suporte ao protocolo T 1 De acordo com a especifica o PC SC a partir da perspectiva do Provedor de Servi os do Cart o o SCL Sistema de Componentes da Leitora Smartnonus deve aceitar APDU s construir os blocos T 1 necess rios para transmitir estes APDU s e retornar assincronamente as respostas do cart o O SCL registra a cada transmiss o quem tem o direito de transmitir Por exemplo se o cart o tem o direito de transmitir o SCL retorna um erro caso o Provedor de Servi os do Cart o tente iniciar uma transmiss o em bloco O SCL respons vel por detectar os seguintes erros Erro de transmiss o paridade incorreta ou erro de EDC indicados pelo nibble menos significativo do PCB ou do R Block enviado pelo cart o BWT Block Waiting Time time out Perda de sincroniza o Quando um erro detectado interpretado pelo SCL que ent o retransmite automaticamente o ltimo bloco
59. download na p gina da leitora Smartnonus na Internet em www nonus com br smartnonus Selecione o download do arquivo de driver para o Windows XP Quando o seu navegador concluir o download poder executar diretamente o programa de instala o ou salvar o arquivo numa pasta local como por exemplo sua pasta Meus Documentos 5 3 1 Execute o arquivo de instala o a partir de uma pasta local ou da p gina da leitora Smartnonus 5 3 2 Na op o Choose Setup Language Escolha a Linguagem de Configura o escolha Portugu s Brasileiro se estiver dispon vel ou Ingl s Estados Unidos Choose Setup Language 41 5 3 3 No formul rio seguinte aponte e clique no bot o Next Pr ximo ig EzUSB Smart Card Reader Setup For Windows 2000 XP 2003 Installs X Welcome to the Installshield Wizard for EZUSB Smart Card Reader Setup For Windows 2000 XP 2003 The InstallShield R Wizard will install EZUSB Smart Card Reader Setup For Windows 2000 XP 2003 on your computer To continue click Next WARNING This program is protected by copyright law and international treaties 5 3 4 No formul rio seguinte confirme a instala o clicando no bot o Install Instalar i EzUSB Smart Card Reader Setup For Windows 2000 XP 2003 Installs X Ready to Install the Program The wizard is ready to begin installation Click Install to begin the installation IF you want to review or change any of your in
60. e SCARD W UNSUPPORTED CARD E AG 7 configura o da sequ ncia ATR 97 APENDICE A Estrutura de Dados TLV ou BER TLV O formato BER Basic Encoding Rules para ASN 1 definido pela ISO IEC 8825 Estruturas de dados criadas de acordo com estas regras ou formato s o chamadas de estruturas de dados TLV ou BER TLV A ISO 7816 4 define o uso de estruturas de dados TLV para troca de dados entre a leitora e o cart o A leitora Smartnonus suporta a estrutura de dados TLV ou BER TLV de acordo com ISO 7816 4 Na estrutura TLV T tag etiqueta define o tipo do objeto o tipo de dados presente na estrutura L length o cumprimento ou n mero de bytes contidos na estrutura e por fim V value s o os dados ou valores contidos na estrutura T L V tag length valve 1 2bytes 1 3bytes N bytes Figura Al Estrutura de dados TLV Existe ainda uma varia o da BER TLV identificada como Simple TLv Na estrutura Simple TLV utilizado 1 byte no campo T tag e 1 3 bytes no campo L length permitindo um valor de O a 64k bytes no campo V value 98 B Suporte T cnico A Nonus oferece suporte t cnico para as leitoras Smartnonus atrav s de telefone ou e mail Tel 11 2344 0404 Op o 4 Suporte e Assist ncia T cnica e mail suporte nonus com br Antes de entrar em contato com a Nonus tenha em m os o n mero de s rie do equipamento se poss vel c pia da nota fiscal de compra Dependendo da n
61. e 3 6 TB C digos Pel Quando aplic vel P e definem voltagem e corrente referentes ao pino de programa o VPP n o utilizado TC C digo N Guardtime extra solicitado pelo cart o Antes de receber o pr ximo caractere o cart o solicita um delay atraso de pelo menos 12 N etu elementar time unit desde o inicio do caractere anterior 12 TD Bytes de Interface Adicionais Protocolo O primeiro nibble do byte TD semelhante ao byte TO a cada passagem informa se haver o bytes de interface adicionais TA2 TB2 TC2 TD2 TA3 TB3 e assim por diante Isto til quando o cart o possui mais de um protocolo ou op es dispon veis O segundo nibble do byte TD informa o primeiro protocolo dispon vel T 0 T 1 TD T TA TB TC TD X X X X Bytes de interface adicionais 4 bits protocolo opcionais T Figura 3 4d Conteudo do byte TD T1 T2 TK Bytes de hist rico Estes bytes podem conter informa es gerais sobre os servi os ou caracter sticas do cart o por exemplo Fabricante modelo de chip e S O Dados Propriet rios do emissor Dados adicionais ex Saldo TCK Byte de Valida o ou Checksum A presen a do byte de checagem TCK depender do protocolo selecionado 13 3 5 PPS Protocol and Parameter Selection Uma vez que um cart o pode especificar mais de um protocolo e par metros dispon veis preciso definir qual protocolo e que par metros a leitora dever utilizar O
62. ema CasForgetReader Remover um grupo de leitoras do sistema CasForgetReaderGroup Introduzir um novo cart o ao sistema CasIntroduceCardType Introduzir uma nova leitora ao sistema CasIntroduceReader Introduzir um novo grupo de leitoras ao sistema CasintroduceReaderGroup Remover uma leitora de um grupo de leitoras CasRemoveReaderFromGroup 49 6 1 3 Fun es de Acesso Direto do Cart o O subsistema do cart o inteligente permite que voc se comunique com cart es que podem n o estar em conformidade com as especifica es da ISO 7816 Para fazer isto estas fun es permitem que voc controle os atributos das comunica es entre o aplicativo e o cart o dando a voc a possibilidade de manipula o direta de baixo n vel da leitora Para Selecione Fornecer controle direto da leitora CasControl Obter atributos da leitora CasGetAttrib Estabelecer atributos da leitora CasSetAttrib 6 1 4 Fun es do Contexto do Gerente de Recursos Estas fun es estabelecem e liberam o contexto do gerente de recursos que utilizado pela consulta base de dados e s fun es de gerenciamento da base de dados Para Selecione Estabelecer um contexto para acessar a base de dados do cart o inteligente CasEstablishContext Fechar um contexto estabelecido CasReleaseContext 6 1 5 Fun o de Suporte do Gerente de Recursos Esta fun o libera a mem ria alocada atrav s do uso do designador de comprimento S
63. enso com envio de dados para processamento e dados gerados pelo cart o para este caso faz se necess rio o uso do comando GET RESPONSE Se um comando for conclu do e o cart o gerar apenas um c digo de retorno sem um bloco de dados a por o de get response na figura abaixo n o ocorre Cart o Inteligente Comando recebido sem erro Comando processado e dados dispon veis CLA INS P1 P2 P3 ACK Requisita bloco de dados do comando l l Bloco de dados I l Dados dispon veis l l SW1 SW2 l i SW2 indica n mero ou bytes dispon veis Get response CLA INS P1 P2 P3 I i DADOS INS SW1 SW2 Leitora Cabe alho Comando 5 bytes N mero de bytes indicado em P3 P3 indica quantidade ou dados a serem enviados Sequ ncia comando resposta completado Figura 3 6 1 Caso mais extenso de instru o no protocolo T 0 Normalmente o valor do caractere ACK um eco do valor do byte de instru o INS Visto que o protocolo T O orientado a caracteres bytes se for detectado um erro a retransmiss o do caractere incorreto deve ser feita imediatamente A detec o de erros no protocolo T O baseada exclusivamente no bit de paridade anexado a cada byte Existem 2 bytes de status SW1 e SW2 Estes bytes s o enviados pelo cart o leitora na conclus o do comando e indicam o estado corrente do cart o A resposta normal SW1 SW2 0x90 0x00 Quando SW1 0x6
64. entificadores especificados forem suportados pelo cart o cguidinterfaceCount Fornece o numero de entradas na matriz rgguidInterfaces Se rgguidInterfaces for NULL ent o este valor ser ignorado mszCards Recebe uma multi sequ ncia que lista os cart es inteligentes encontrados Se este valor for NULL CasListCards ignora o comprimento do buffer fornecido em pcchCards retornando o comprimento do buffer que seria retornado se este par metro n o tivesse sido NULL para pcchCards e retorna um c digo v lido pcchCards Fornece o comprimento do buffer mszCards em caracteres e recebe o comprimento real da estrutura multi sequ ncia incluindo todos os caracteres nulos a direita Se o comprimento de buffer for especificado como SCARD_AUTOALLOCATE ent o o szCards convertido de um apontador para um apontador em sequ ncia e recebe o endere o do bloco de mem ria contendo a multi sequ ncia Este bloco de mem ria deve ser desalojado selecionando CasFreeMemory Valores de Retorno v lido SCARD S SUCCESS ee Um c digo de erro aparecer para uma lista de c digos de erro Inv lido bake consultar C digos de Erro Observa es Para retornar todos os cart es inteligentes apresentados ao subsistema ajuste pbAtr e rgguidInterfaces para NULL CasListCards uma fun o de consulta base de dados 80 6 3 21 CasListInterfaces A fun o CasListInterfaces fornece uma lista de interfaces fornecidas por um dado cart o
65. erenciador de Dispositivos aberto clique para expandir o grupo Leitoras de Cart es Inteligentes Poder visualizar a leitora Smartnonus descrita como EZUSB PC SC Smart Card Reader Arquivo A o Exibir Ajuda es niBm m RY Adaptadores de rede My Adaptadores de v deo MM Baterias A Biometric J amp E Computador gt Controladores de armazenamento a Controladores de som video e jogos cg Controladores IDE ATA ATAPI Controladores USB barramento serial universal Ba Dispositivos de Interface Humana 4 amp Dispositivos de sistema IEEE 1394 Bus host controllers pes a Jungo Leitores de cart es inteligentes lt lt EZUSB PC SC Smart Card Reader HE Modems JM Monitores be A Mouse e outros dispositivos apontadores 1 Portas COM e LPT AD Processadores ED Teclados g Unidades de disco Unidades de DVD CD ROM B B B B B E E E 0 woe fp N y ONSON E E E F 40 5 3 Microsoft Windows XP Requisitos Minimos de Ambiente Recomendados Microsoft Windows XP Service Pack 3 Processador 1GHz ou superior Mem ria Minimo de 512MB Espa o em Disco 20MB Vers o do Driver 3 1 6 0 Mantenha a leitora Smartnonus desconectada durante a instala o dos drivers para o Microsoft Windows XP Voc precisar de direitos administrativos para prosseguir com a instala o dos drives para a leitora Smartnonus Os drivers mais atuais est o dispon veis para
66. erva es CasSetAttrib uma fun o de acesso direto do cart o 89 6 3 29 CasStatus A fun o CasStatus fornece o status atual de um cart o inteligente em uma leitora Voc pode selecion la a qualquer momento ap s uma sele o bem sucedida para CasConnect e antes de uma sele o bem sucedida para CasDisconnect Ela n o afeta o status da leitora ou do driver da leitora LONG CasStatus IN SCARDHANDLE hCard OUT LPTSTR szReaderName IN OUT LPDWORD pcchReaderLen OUT LPDWORD pdwsState OUT LPDWORD pdwProtocol OUT LPBYTE pbAtr OUT LPDWORD pcbAtrLen Par metros hCard Este o valor de refer ncia retornado do CasConnect szReaderName Recebe uma lista de nomes adequados multi sequ ncia pelo qual a leitora conectada atualmente conhecida pcchReaderLen Na entrada fornece o comprimento do buffer szReaderName Na sa da recebe o comprimento real em caracteres da lista de nomes das leitoras incluindo o caractere NULL direita pdwsState Recebe o status atual do cart o inteligente na leitora Ap s a valida o ela recebe um dos indicadores de status a seguir Valor SCARD ABSENT SCARD PRESENT SCARD SWALLOWED SCARD POWERED SCARD NEGOTIABLE SCARD SPECIFIC pdwProtocol Significado N o h cart o na leitora H um cart o na leitora mas ele n o foi colocado na posi o de uso H um cart o na leitora em posi o de uso O cart o n o est energizado
67. gado Cart o est conectado A luz vermelha piscante indica que o cart o esta sendo lido escrito 2 2 Descri o dos Contatos El tricos As propriedades el tricas e mec nicas da interface do leitor Smartnonus s o compat veis com a norma ISO IEC 7816 2 Os contatos da interface s o compat veis e est o dispostos de acordo com norma ISO IEC 7816 3 O leitor suporta cart es ISO 7816 classe A e classe B C1 SCO VCC VCC Alimenta o C5 SCO_GND GND Ground C2 SCO_RST RST Sinal de Reset C6 NC C6 VPP ISO 7816 N o utilizado C3 SCO_CLK CLK Sinal de Clock C7 SCO 10 IO Entrada Sa da Dados C4 SCO C4 C4 RFU ISO 7816 C8 SCO C8 C8 RFU ISO 7816 RFU Reserved for Future Use Reservado para uso futuro de acordo com ISO IEC 7816 Os contatos C4 SCO C4 e C8 NC C6 e SCO C8 n o s o utilizados e est o isolados eletricamente 2 3 Propriedades El tricas dos Contatos As propriedades el tricas s o compat veis com a se o 4 da Norma ISO IEC 7816 3 1997 A leitora Smartnonus n o implementa nenhuma propriedade el trica adicional ou n o compat vel aos requisitos definidos na se o 4 do padr o ISO IEC 7816 3 Abrevia es VIH N vel Alto de tens o de entrada VIL N vel Baixo de tens o de entrada Vcc Tens o de Alimenta o VPP Pino de Programa o Voltagem de Programa o VOH N vel Alto de tens o de sa da VOL N vel
68. ield Wizard instala o EZUSB Smart Card Reader Setup For Windows 7 Server 2008 R2 32 bit Isso pode levar alguns minutos Status a InstallShield i rre e 5 1 4 O programa de instala o copiar os arquivos do driver da leitora Smartnonus No final do processo de instala o voc receber um aviso neste instante conecte a leitora Smartnonus numa porta USB livre de seu computador e clique no bot o OK Conecte seu dispositivo a este computador a qualquer momento depois que a instala o tiver sido conduida EZUSB PC SC Smart Card Reader Instalado EZUSB PC SC Smart Card Reader of Pronto para uso s 33 5 1 5 Por fim clique em Concluir _ Smart Card Reader Setup For Windows 7 Server 2008 R2 32 bit O InstallShield Wizard instalou com sucesso o EZUSB Smart Card Reader Setup For Windows 7 Server 2008 R2 32 bit Clique em Concluir para sair do InstallShield Wizard Manual T cnico Smartnonus 34 5 1 6 Poder ainda fazer uma verifica o adicional de instala o bem sucedida Clique no menu Iniciar e na caixa Pesquisar programas e arquivos digite Gerenciador de Dispositivos Abra o programa localizado Ou se preferir aponte e clique no Menu Iniciar clique em Painel de Controle Em seguida clique em Sistemas e Seguran a Localize o cone Sistema e clique em Gerenciador de Dispositivos Com o Gerenciador de Dispositivos aberto clique para expandir o grupo
69. im rio se houver um LONG CasGetProviderld IN SCARDCANTEXT hContext IN LPCTSTR szCard OUT LPGUID pguidProviderld Par metros hContext Fornece o identificador do contexto do gerente de recursos para a consulta O contexto do gerente de recursos ajustado por uma sele o pr via para CasEstablishContext ou ajusta NULL se a consulta n o direcionada para um contexto espec fico szCard Fornece o nome do cart o definido para o sistema pguidProviderld Recebe o identificador GUID do fornecedor do servi o prim rio Seu fornecedor pode ser via COM e fornecer acesso a outros servi os no cart o Valores de Retorno v lido SCARD S SUCCESS AY Um c digo de erro aparecer para uma lista de c digos de erro Invalido ae consultar C digos de Erro Observa es CasGetProviderld uma fun o de consulta base de dados 75 6 3 16 CasGetStatusChange A fun o CasGetStatusChange bloqueia a execu o at que a disponibilidade atual de cart es em um conjunto espec fico de leitoras mude O selecionador fornece uma lista de leitoras que devem ser monitoradas por uma matriz SCARD READERSTATE e a quantidade m xima de tempo em milissegundos que se deve aguardar para que uma a o ocorra em uma das leitoras listadas Note que CasGetStatusChange utiliza o valor fornecido pelo usu rio nos membros dwCurrentState do par metro rgReaderStates como a defini o do status atual das leitoras A fun o
70. io Este apontador passado de volta para o selecionador na rotina de conex o dwShareMode Se IpfnConnect n o for NULL os membros dwShareMode e dwPreferredProtocols ser o ignorados Se IpfnConnect for NULL e dwShareMode for diferente de zero uma sele o interna ser feita para CasConnect usando dwShareMode e dwPreferredProtocols como os par metros dwShareMode e dwPreferredProtocols Se a conex o for bem sucedida hCardHandle ajustado para o identificador retornado pelo CasConnect Se IpfnConnect for NULL e dwShareMode for zero hCardHandle ajustado para NULL dwPreferredProtocols Usado para conex o interna conforme descrito em dwShareMode lpstrRdr Se o cart o for localizado o buffer IpstrRdr cont m o nome da leitora que cont m o cart o localizado O buffer deve ter o comprimento de 256 caracteres no m nimo nMaxRdr Especifica o tamanho em bytes vers o ANSI ou caracteres vers o UNICODE do buffer apontado por IpstrRdr Se o buffer for pequeno demais para conter a informa o da leitora CasUIDIgSelectCard retorna SCARD E NO MEMORY e o tamanho necess rio do buffer apontado por IpstrRdr IpstrCard Se o cart o for localizado o buffer IpstrRdr cont m o nome do cart o localizado O buffer deve ter o comprimento de 256 caracteres no m nimo nMaxCard Especifica o tamanho em bytes vers o ANSI ou caracteres vers o UNICODE do buffer apontado por IpstrRdr Se o buffer for pequeno demais para conter
71. ioRecvPci OUT LPBYTE pbRecvBuffer IN OUT LPDWORD pcbRecvLength Par metros hCard Fornece o valor de refer ncia retornado do CasConnect pioSendPci Aponta para a estrutura de cabecalho do protocolo para a instrucdo Este buffer esta no formato de uma estrutura SCARD IO REQUEST seguida da informa o de controle do protocolo PCI Para protocolos T 0 T 1 e RAW a estrutura PCI constante O subsistema do cart o inteligente fornece uma estrutura global de PCI T 0 T 1 ou RAW que voc pode consultar utilizando os s mbolos SCARD PCI TO SCARD PCI T1 e SCARD PCI RAW respectivamente pbSendBuffer Aponta para os dados reais a serem escritos para o cart o T 0 Nota para T 0 os par metros dos dados s o colocados no pbSendBuffer de acordo com a seguinte estrutura struct BYTE bCla A classe de instru o bins O c digo de instru o bP1 O par metro para a instru o bP2 O par metro para a instru o bP3 Tamanho da Transfer ncia de I O CmdBytes Membros bCla A classe de instru o T 0 bins Um c digo de instru o na classe de instru o T 0 bP1 bP2 C digos de refer ncia que completam o c digo de instru o bP3 O n mero de bytes de dados que devem ser transmitidos durante o comando de acordo com a ISO 7816 4 Se o 8 2 1 Os dados enviados ao cart o devem seguir imediatamente o buffer de envio No caso especial em que nenhum dado enviado para o cart o e nenhum dado
72. leitoras de um grupo automaticamente ela n o afeta a exist ncia de leitoras individuais na leitora Par metros hContext Fornece o identificador que identifica o contexto do gerente de recursos O contexto do gerente de recursos ajustado por uma sele o pr via para CasEstablishContext szGroupName Fornece o nome apropriado do grupo de leitoras a ser removido Grupos de leitoras definidos pelo sistema n o podem ser removidos da base de dados Valores de Retorno v lido SCARD S SUCCESS RR Um c digo de erro aparecer para uma lista de c digos de erro Inv lido aye consultar C digos de Erro Observa es CasForgetReaderGroup uma fun o de gerenciamento da base de dados 70 6 3 12 CasFreeMemory A fun o CasFreeMemory libera mem ria que foi retornada do gerente de recursos utilizando o designador de comprimento SCARD_AUTOALLOCATE LONG CasFreeMemory IN SCARDCONTEXT hContext IN LPVOID pyMem Par metros hContext Fornece o identificador do contexto do gerente de recursos retornado do CasEstablishContext ou NULL se a fun o de cria o for tamb m especificada como NULL para seu hContext pvMem Fornece o bloco de mem ria a ser liberado Valores de Retorno v lido SCARD S SUCCESS ae Um c digo de erro aparecer para uma lista de c digos de erro Inv lido eta consultar C digos de Erro 71 6 3 13 CasGetAttrib A fun o CasSetAttrib obt m os atributos de leitor
73. na de conex o do cart o do selecionador Se o selecionador precisa realizar um processamento adicional para se conectar ao cart o este apontador de fun o ajustado para a fun o de conex o do usu rio Se a fun o de conex o for bem sucedida o cart o deixado conectado e inicializado e o identificador do cart o retornado O prot tipo para a rotina de conex o Connect hSCardContext o contexto do cart o passado no bloco do par metro szReader o nome da leitora mszCards uma multi sequ ncia que cont m os nomes de cart o poss veis na leitora pvUserData apontador para dados do usu rio passados no bloco do par metro IpfnDisconnect Aponta para a rotina de desconex o do cart o do selecionador O prot tipo para a rotina de desconex o Disconnect hSCardContext o contexto do cart o passado no bloco do par metro hCard identificador do cart o pvUserData apontador para dados do usu rio passados no bloco do par metro Nota Quando voc utilizar IpfnConnect IpfnCheck e IpfnDisconnect todos os tr s procedimentos de chamada devem estar presentes A utiliza o destas chamadas permite posterior verifica o sobre se o aplicativo de sele o encontrou o cart o apropriado Esta a melhor maneira de garantir que o cart o apropriado foi selecionado No entanto ao utilizar um valor n o NULL para IpfnCheck ou IpfnConnect e IpfnDisconnect devem ser n o NULL e pvUserData tamb
74. ndendo a um dos cart es alvo SCARD STATE ATRMATCH Se este bit for ajustado SCARD STATE PRESENT tamb m ser ajustado Este bit apenas retorna na fun o CasLocateCards O cart o na leitora est alocado para uso exclusivo por outro aplicativo Se SCARD STATE EXCLUSIVE E este bit for ajustado SCARD STATE PRESENT tamb m ser ajustado O cart o na leitora est em uso exclusivo por um ou mais aplicativos mas SCARD STATE INUSE pode estar conectada em modo compartilhado Se este bit for ajustado SCARD STATE PRESENT tamb m ser ajustado SCARD STATE MUTE H um cart o que n o responde na leitora cbAtr O numero de bytes no ATR retornado rgbAtr O ATR do cart o inserido com bytes de alinhamento extras 54 6 2 3 OPENCARDNAME_EX A estrutura OPENCARDNAME_EX cont m a informa o que a fun o CasUIDIgSelectCard utiliza para inicializar uma caixa de di logo Select Card de um cart o inteligente typedef struct DWORD dwStructSize SCARDCONTEXT hSCardContext HWND hwndOwner DWORD dwFlags LPCTSTR IpstrTitle LPCTSTR IpstrSearchDesc HICON hicon POPENCARD SEARCH CRITERIA pOpenCardSearchCriteria LPOCNCONNPROC IpfnConnect LPVOID pvUserData DWORD dwShareMode DWORD dwPreferredProtocols LPTSTR lpstrRdr DWORD nMaxCard DWORD dwActiveProtocol SCARDHANDLE hCardHandle OPENCARDNAME_EX POPENCARDNAME EX LPOPENCARDNAME_EX Membros dwsStructSize Especifica o comprimento em bytes da estrutura
75. nload na p gina da leitora Smartnonus na Internet em www nonus com br smartnonus Selecione o arquivo de acordo com a sua vers o do Windows 7 entre 32 bits setup7 32 exe e 64 bits setup7 64 exe Quando o seu navegador concluir o download poder executar diretamente o programa de instala o ou salvar o arquivo numa pasta local como por exemplo sua pasta Documentos 5 1 1 Execute o arquivo de instala o a partir de uma pasta local ou da p gina da leitora Smartnonus Selecione o idioma de instala o escolha Portugu s Brasileiro Selecione o idioma para instala o a partir das op es a seguir Portugu s Brasileira X Cancelar 31 5 1 2 No formul rio seguinte aponte e clique no bot o Avan ar Bem vindo ao InstallShield Wizard do EzUSB Smart Card Reader Setup For Windows 7 Server 2008 R2 32 bit O InstallShield R Wizard ir instalar o EZUSB Smart Card Reader Setup For Windows 7 Server 2008 R2 32 bit em seu computador Para continuar dlique em Avan ar AVISO Este programa est protegido por lei de copyright e tratados internacionais Pronto para instalar o programa O assistente est pronto para iniciar a instala o Clique em Instalar para iniciar a instala o Se desejar rever ou alterar alguma configura o de sua instala o clique em Voltar Clique em Cancelar para sair do assistente Manual T cnico Smartnonus 32 Aguarde enquanto o InstallSh
76. ntador para um apontador em sequ ncia e recebe o endere o do bloco de mem ria contendo a multi sequ ncia Este bloco de mem ria deve ser desalojado selecionando CasFreeMemory Valores de Retorno a Um c digo de erro aparecer para uma lista de c digos de erro Inv lido at consultar C digos de Erro Observa es Um grupo retornado somente se conter pelo menos uma leitora Isto inclui o grupo ScardSDefaultReaders O grupo ScardSAllReaders n o pode ser retornado j que existe apenas implicitamente CasListReaderGroups uma fun o de consulta base de dados 82 6 3 23 CasListReaders A fun o CasListReaders fornece uma lista de leitoras dentro de um conjunto de grupos de leitoras designadas eliminando duplicatas O selecionador fornece um grupo de leitoras e recebe a lista de leitoras dentro dos grupos designados Nomes de grupos n o reconhecidos ser o ignorados LONG CasListReaders IN SCARDCONTEXT hContext IN LPCTSTR mszGroups OUT LPTSTR mszReaders IN OUT LPDWORD pcchReaders Par metros hContext Fornece o identificador que identifica o contexto do gerente de recursos para a consulta O contexto do gerente de recursos pode ser ajustado por uma sele o pr via para CasEstablishContext ou ajusta NULL se a consulta n o direcionada para um contexto espec fico mszGroups Fornece o nome dos grupos de leitoras definidos para o sistema como uma multi sequ ncia Utilize um valor NULL
77. ntes no ATR Os bits b8 a b5 determinam se os bytes TA TB TC e TD estar o presentes no ATR por exemplo se o bit b8 estiver setado significa que o byte TD estar presente 11 Os bits b4 a b1 indicam o numero de bytes hist ricos presentes no ATR Descri o x x x x Numero de Bytes Hist ricos 1 TA 1 presente 1 TB 1 presente 1 TC 1 presente 1 TD 1 presente TA Global Interface Bytes C digos F e D Os bits b8 a b5 bits mais significativos informam a taxa de divis o da frequ ncia do Clock F Os bits b4 a b1 bits menos significativos informam o fator de ajuste do baud rate D TA b8 b7 b6 b5 b4 b3 b2 b1 lt i gt Figura 3 4c Conte do do byte TA O Smartnonus suporta diferentes velocidades de baud rate na comunica o com o cart o ex 9600 bps 19200 bps 38400 bps 57600 bps 115200 bps Por m a sele o de baud rate n o esta limitada a rela o acima para a leitora Smartnonus aceitar o par metro as condi es a e b abaixo devem ser verdadeiras A velocidade pode atingir no m ximo 31 per odos de clock a F D deve ser inteiro ou divis vel Exemplo FI 1 e DI 8 F 372 e D 12 F D 31 baud rate suportado Exemplo FI 1 e DI 4 F 372 e D 8 F D 46 5 baud rate n o suportado b F D deve ser maior ou igual a 31 per odos de clock Estas velocidades e condi es s o verdadeiras para T 0 ou T 1 Vid
78. ntre e abra o programa TokenAdmin Neste programa voc poder verificar a leitora Smartnonus instalada e se inserir um cart o na coluna Token Status verificar a mensagem Present Token Status absent Manual T cnico Smartnonus 48 6 Refer ncia API PC SC Smartnonus 6 1 Vis o Geral da API A documenta o abaixo descreve as fun es presentes na API da leitora Smartnonus Nesta primeira parte est o agrupadas por funcionalidade em seguida apresentamos cada fun o individualmente A Nonus fornece tamb m uma demonstra o da API em funcionamento com o c digo fonte As fun es principais est o exemplificadas nesta demonstra o bem como os procedimentos de conex o e recupera o de dados da leitora A demonstra o da API Smartnonus pode ser obtida no site da Nonus em www nonus com br smartnonus para mais informa es consulte o Ap ndice C Demonstra o API Smartnonus v 1 0 6 1 1 Fun es de Consulta Base de Dados do Cart o Inteligente Estas fun es consultam a base de dados do cart o inteligente Elas podem fornecer uma lista de cart es inteligentes fornecidos por um usu rio espec fico as interfaces e os fornecedores de servi os prim rios de um cart o espec fico os grupos de leitoras definidas para o sistema e as leitoras a partir de um conjunto de grupos de leitoras Ao utilizar estas fun es voc pode consultar a base de dados completa do cart o inteligente ou red
79. o desconhecido Suporte de protocolo A leitora implementa a camada f sica incluindo a tratativa obrigat ria de erros de paridade do protocolo T 0 Gerenciamento do canal I O Em seguida s sequ ncias de Reset e ATR a leitora permite ao PC o controle da transmiss o A leitora ir transmitir ao cart o quando um bloco de dados for recebido do PC Em seguida a leitora retorna os bytes recebidos do cart o para o PC at todo o bloco de dados ser recebido 30 5 Manuais de Instala o Seguem abaixo os manuais de instala o dos drivers da leitora Smartnonus para diversos Sistemas Operacionais Os drivers mais atuais podem ser obtidos no endere o www nonus com br smartnonus Cada Sistema Operacional abaixo apresenta a vers o do driver dispon vel at a data de publica o desta vers o do manual bem como os requisitos de ambiente operacional necess rios para compatibilidade 5 1 Microsoft Windows 7 32 e 64 bits Requisitos M nimos de Ambiente Recomendados Microsoft Windows 7 Sistema Operacional de 32 ou 64 bits Processador 1GHz ou superior Mem ria M nimo de 512MB Espa o em Disco 20MB Vers o do Driver 3 1 7 0 Mantenha a leitora Smartnonus desconectada durante a instala o dos drivers para o Microsoft Windows 7 Voc precisar de direitos administrativos para prosseguir com a instala o dos drivers para a leitora Smartnonus Os drivers mais atuais est o dispon veis para dow
80. o Num rico Pin Pad E pee 0x00000004 Teclado identifica o do 0x0142 4 bytes 0x00000008 Scanner de impress o digital Usu rio 0x00000010 Scanner de retina 0x00000020 Scanner de imagem 0x00000040 Scanner de padr o de voz 0x00000080 Dispositivo de display 0x0000dd00 dd no intervalo de 0x01 to 0x40 selecionado pelo fornecedor para os dispositivos definidos pelo fornecedor 0x00008000 Utilizado para indicar que entrada encriptada suportada Caracter sticas Mec nicas 0x00000000 Caracter sticas Mec nicas 0x0150 4 bytes DWORD que o resultado de uma opera o suportadas bitwise OR executada nos seguintes valores 23 Classe de Elemento de TAG TEN wrea Informa es Dado M ximo 0x00000000 Nenhuma caracter stica especial 0x00000001 Mecanismo permite engolir cart o 0x00000002 Mecanismo permite ejetar o cart o 0x00000004 Mecanismo permite capturar o cart o Todos os outros valores s o Reservados para Uso Futuro RFU Devem ser Aus usados Caracteristicas valores definidas pelo N A no Fornecedor intervalo 0x0180 0x01FO 4 3 Eventos do Cart o A leitora Smartnonus capaz de identificar e notificar atrav s do m dulo de interface Inser o do cart o inteligente Remo o do cart o inteligente N o h outros eventos de cart o que podem ser detectados visto a leitora n o suportar mecanismos adicionais para reter engolir ou
81. o contexto do gerente de recursos O contexto do gerente de recursos ajustado por uma sele o pr via para CasEstablishContext Valores de Retorno v lido SCARD S SUCCESS dia Um c digo de erro aparecer para uma lista de c digos de erro consultar Inv lido ae C digos de Erro Observa es CasCancel uma fun o de rastreabilidade do cart o inteligente 61 6 3 4 CasConnect A fun o CasConnect estabelece uma conex o utilizando um contexto espec fico do gerente de recursos entre o aplicativo de sele o e o cart o inteligente contido por uma leitora espec fica Se n o houver cart o na leitora especificada um erro retornado LONG CasConnect IN SCARDCONTEXT hContext IN LPCTSTR szReader IN DWORD dwShareMode IN DWORD dwPreferredProtocols OUT LPSCARDHANDLE phCard OUT LPDWORD pwdaActiveProtocol Par metros hContext Fornece o identificador do contexto do gerente de recursos O contexto do gerente de recursos ajustado por uma sele o pr via para CasEstablishContext szReader Fornece o nome da leitora que cont m o cart o alvo dwShareMode Fornece um marcador que indica se outros aplicativos podem formar conex es com o cart o Poss veis valores Valor Significado Este aplicativo deseja compartilhar o cart o com outros aplicativos Este aplicativo n o deseja compartilhar o cart o com outros aplicativos Este aplicativo est alocando a leitora para seu uso privado e
82. o na linha de I O por um per odo tc definido por 400 e 40 000 ciclos de clock depois de tb 400 f lt tc lt 40 000 f Sendo f frequ ncia do clock 6 xx MHz A vec H Reto cu a IO Indefinido ATR ta tattb tbttc Figura 3a 3 2 2 Warm Reset O procedimento de ativa o por Warm Reset consiste das seguintes opera es consecutivas Esta representado na figura 3b e as indica es de tempo td te e tf est o descritas de acordo com a norma ISO IEC 7816 3 a Vcc ativo e estabilizado Reset em n vel l gico alto e Clock CLK ativo e estabilizado b RST dirigido para n vel l gico baixo a qualquer tempo T para iniciar um Warm Reset O Reset mantido em n vel l gico baixo por 400 ciclos de clock at um tempo td td T te 400 f lt te c O terminal leitora mant m I O em modo de recep o d O terminal dirige o RST para n vel l gico alto ap s 400 ciclos de clock td e O cart o responde com um ATR Answer to Reset dentro de 40 000 ciclos de clock tf lt 40 000 f Sendo f frequ ncia do clock 6 xx MHz A vec RST gt cK IO Indefinido ATR ta td t te td tf Figura 3b 3 3 Desativa o dos Contatos Quando a transa o troca de informa es terminada ou abortada cart o n o respondendo ou cart o removido os contatos s o desativados atrav s das seguintes opera es a RST em n vel l gico baixo b CLK em n vel l gico b
83. o para n o tamanho em bytes dos dados a serem transferidos para o cart o Se 256 bytes devem ser transferidos para o cart o ent o este byte deve ser ajustado para zero O par metro cbSendLength dever ser ajustado para 5 o tamanho da informa o do cabe alho de T 0 O pbRecvBuffer receber os dados retornados do cart o imediatamente seguidos pelos c digos de status SW1 e SW2 da opera o O pcbRecvLength deve ser pelo menos n 2 e ser ajustado para n 2 depois do retorno Emiss o de um Comando sem Troca de Dados Para emitir um comando para o cart o que n o envolve a troca de dados enviados ou recebidos os buffers de envio e recebimento devem ser formatados como a seguir O buffer pbSendBuffer dever conter os valores de CLA INS P1 e P2 para a opera o T 0 O valor de P3 n o enviado Isto para diferenciar o cabe alho do caso em que se espera que 256 bytes sejam retornados O par metro cbSendLength dever ser ajustado para 4 o tamanho da informa o do cabe alho de T 0 CLA INS P1 e P2 O pbRecvBuffer receber os c digos de status SW1 e SW2 da opera o O pcbRecvLength deve ser pelo menos 2 e ser ajustado para 2 depois do retorno 94 6 3 31 CasUIDIgSelectCard A fun o CasUIDIgSelectCard exibe o di logo select card do cart o inteligente LONG IN LPOPENCARDNAME_EX pDlgStruc Par metros pDlgStruc Aponta para a estrutura OPENCARDNAME_EX para o di logo select ca
84. odelo Smartnonus Dimens es Altura 15 55mm Largura 70mm Profundidade 51mm Peso Incluido Cabo 50 g 0 050 Kg Cumprimento Cabo 100 cm 10 Armazenamento Alimenta o Bus Powered USB 5V Consumo Aprox 60ma Temperatura de Opera o 0a 55 Temperatura de 0a 70 SMART CARD Comunica o USB 2 0 Full Speed 12Mbps Protocolos ISO 7816 T 0 e T 1 Tipos de Cart o Cart es tipo A 5V Cart es tipo B 3V e Cart es de Mem ria Durabilidade Mecanismo 100 000 inser es Detec o de Estado Detec o Inser o Remo o Detec o autom tica tipo Smart Card Prote es Curto Circuito Prote o T rmica Prote o ESD Interface Usu rio Led Bicolor Verde Vermelho Presen a Cart o Cart o Operacional PADR ES COMPATIBILIDADE ISO 7816 Card interface electrical characteristics compliant Parts 1 2 e 3 PC SC Interoperability Specification for ICC s and Personal Computer Systems Version 1 0 EMV MasterCard Visa EMV V4 0 Level 1 Compliant 2 Caracteristicas Fisicas e El tricas 2 1 Inser o do Cart o Com a leitora montada o cart o deve ser inserido com os contatos voltados para cima O cart o permanece todo o tempo acess vel ao operador Figura 2 1 Posi o correta de inser o do cart o Indica o dos Leds Verde Vermelho O leitor est li
85. odificado atrav s de PPS Rate N Corrente Guard N codificado como inteiro Time 0x0205 4 bytes Pode ser modificado atrav s de PPS Ww Corrente Work 0x0206 4 bytes x W codificado como Inteiro V lido apenas se Waiting Time protocolo corrente T 0 IFSC Corrente Tamanho do campo 0x0207 A bytes x IFSC codificado como inteiro V lido apenas se de informa o do protocolo corrente T 1 cart o IFSD Corrente Tamanho do campo 0x0208 A bytes IFSD codificado como inteiro V lido apenas se de informa o da protocolo corrente T 1 Leitora BWT Corrente l 0x0209 4 bytes x BWT codificado como inteiro V lido apenas se Block Waiting Time protocolo corrente T 1 CWT Corrente 42 alte Fi Character Waring 0x020A 4 bytes x CWT codificado como inteiro V lido apenas se protocolo corrente T 1 Time EBC codificado como Codifica o de EBC O LRC orrei 0x020B 4 bytes X 1 CRC V lido apenas se protocolo corrente T 1 27 4 5 2 PC SC Suporte ao protocolo T 0 De acordo com a especifica o PC SC a partir da perspectiva do Provedor de Servi os do Cart o o SCL Sistema de Componentes da Leitora Smartnonus aceita os casos curtos short cases de APDU conforme definido na ISO 7816 4 e retorna assincronamente as respostas do cart o O SCL da Smartnonus ainda respons vel por detectar e responder erros de camadas f sicas erros de paridade de bits conforme requerido pela norma ISO IEC 7816 Em termos
86. onde RRR Reservado para Uso Futuro RFU e deve ser 0x000 E PPPP codifica os tipos de protocolos suportados Tipos de ts asa E Um 1 dado numa determinada posi o de bit Protocolos a E 0x0120 4 bytes indica suporte para o protoloco ISO Assincronos suportados Exemplo 0x00000003 indica suporte para T 0 e T 1 Este o nico valor em conformidade que deve ser retornado pelos dispositivos neste momento Todos os outros valores T 2 T 14 T 15 e assim por diante est o fora desta especifica o e devem ser tratadas pelos drivers supridos pelo fornecedor 3571 CLK padr o 0x0121 4 bytes Padr o de CLK do cart o ICC em KHz codificados como valores inteiros Por exemplo 3 58 MHz codificado como o valor inteiro 3580 3571 CLK maximo 0x0122 bytes Frequ ncia de CLK m xima suportada pelo cart o codificada como valores inteiros Taxa de 2909 t iss o d 0x0123 4 byt ERA j ytes Taxa de transmiss o de dados padr o em bps dados padr o a E codificada como valores inteiros 9600 Taxa de t iss o d 0x0124 4 byt DO 3 HR Taxa de dados m xima suportada pelo canal I O do dados m xima a Cart o OxFC IESE maximo 0x0123 thytes DWORD indicando o IFSD m ximo suportado pela Leitora IFD Pelo menos 32 254 recomendado N A DWORD codificado como Ox4RRRPPPP onde RRR is Reservado para Uso Futuro RFU e deve ser Tipos de ta a p PPPP codifica os tipos de protocolos suportados Um Protocolos pa E EA A Sin era ROE 0x0126
87. ositivo no momento O buffer de recebimento do PCI muito pequeno Os protocolos solicitados s o incompat veis com o protocolo em uso com o cart o no momento A leitora especificada n o est dispon vel para uso no momento O driver da leitora n o cumpre os requisitos m nimos para suporte O gerente de recursos do cart o inteligente foi desligado O cart o inteligente n o pode ser acessado devido s conex es pendentes A a o foi cancelada pelo sistema provavelmente para se desconectar ou desligar O valor do tempo limite especificado pelo usu rio expirou O nome do cart o inteligente especificado n o foi reconhecido O nome da leitora especificada n o foi reconhecido Um erro de comunica o interna foi detectado Houve uma falha de consist ncia interna Um erro interno foi detectado mas a fonte desconhecida Um temporizador interno de consist ncia expirou Nenhum erro foi encontrado O cart o inteligente foi removido de forma que n o mais poss vel haver comunica o O cart o inteligente foi reinicializado ent o qualquer informa o de status compartilhada est inv lida 96 A for a foi cortada do cart o inteligente de forma que n o mais SCARD W UNPOWERED CARD Rania Ao poss vel estabelecer comunica o SCARD W UNRESPONSIVE CARD O cart o inteligente n o est respondendo a uma reinicializa o A leitora n o pode se comunicar com o cart o devido a conflitos d
88. para listar todas as leitoras no sistema isto o grupo SCardSAllReaders mszReaders Recebe uma multi sequ ncia que lista as leitoras de cart es dentro dos grupos de leitoras fornecidos Se este valor for NULL CasListReaders ignora o comprimento do buffer fornecido em pcchReaders escreve o comprimento do buffer que seria retornado se este par metro n o tivesse sido NULL para pcchReaders e retorna um c digo v lido pcchReaders Fornece o comprimento do buffer mszReaders em caracteres e recebe o comprimento real da estrutura multi sequ ncia incluindo todos os caracteres nulos direita Se o comprimento de buffer for especificado como SCARD AUTOALLOCATE ent o o szReaders convertido de um apontador para um apontador em sequ ncia e recebe o endere o do bloco de mem ria contendo a estrutura de multi sequ ncia Este bloco de mem ria deve ser desalojado selecionando CasFreeMemory Valores de Retorno v lido SCARD S SUCCESS a Um c digo de erro aparecer para uma lista de c digos de erro Inv lido ae consultar C digos de Erro Observa es CasListReaders uma fun o de consulta base de dados 83 6 3 24 CasLocateCards A fun o CasLocateCards busca as leitoras listadas no par metro rgReaderStates para um cart o com uma sequ ncia ATR que corresponde a um dos nomes de cart o especificados no mszCards retornando imediatamente com o resultado LONG CasLocateCards IN SCARDCONTEXT hContext
89. protocolo e par metros precisam estar definidos antes da primeira troca de dados O mecanismo do comando PPS antigamente chamado PTS permite que a leitora negocie o protocolo e par metros com o cart o A leitora Smartnonus suporta o processo de PPS de acordo com a norma ISO IEC 7816 3 O comando PPS precisa ser executado uma nica vez e imediatamente ap s o ATR ser recebido Transmiss es repetidas de comandos PPS s o proibidas pela norma ISO l Cart o Reset Leitora Inteligente Smartnonus i l ATR 1 FFF TTF C a l l 1 l A l Requisi o PPS l l i PPS l Resposta PPS 1 opcional l do a l i comando 1 i l 1 l nat I Primeiro par i resposta 1 Comando Respostas l A Figura 3 5a Caso preciso o comando PPS executado logo ap s o ATR antes do primeiro par comando resposta Segue uma breve descri o da estrutura do comando PPS PPSS Caractere Inicial PPSO Caractere de Formato PPS1 PPS2 PPS3 Caracteres de Par metros PCK Caractere de valida o ou checagem PPSS Caractere Inicial O caractere PPSS informa o cart o que que a leitora esta iniciando uma requisi o PPS O valor do caractere PPSS OxFF PPSO Caractere de formato PPSO um mapa de bits e indica nos bits b5 b6 e b7 a presen a dos caracteres de par metros PPS1 PPS2 e PPS3 O bit b8 reservado para uso futuro RFU No nibble menos significativo bits de 4 a 1
90. r ajustado SCARD STATE PRESENT assumido O aplicativo acredita que o cart o na leitora est em uso exclusivo por um SCARD STATE INUSE ou mais aplicativos mas pode estar conectada em modo compartilhado Se este bit for ajustado SCARD STATE PRESENT assumido SCARD STATE MUTE O aplicativo acredita que h um cart o que n o responde na leitora 53 dwEventState Recebe o status atual da leitora conforme conhecido pelo gerente de recursos do cart o inteligente Este campo pode assumir qualquer um dos valores a seguir em combina o como uma m scara de bits SCARD STATE IGNORE Esta leitora deve ser ignorada H uma diferen a entre o status reconhecido pelo aplicativo e o status SCARD STATE CHANGED conhecido pelo gerente de recursos Quando este bit ajustado o aplicativo pode assumir uma mudan a significativa de status ocorrida nesta leitora Esta leitora dada n o reconhecida por este gerente de recursos Se este bit SCARD STATE UNKNOWN for ajustado ent o SCARD STATE CHANGED e SCARD STATE IGNORE tamb m ser o ajustados O status real desta leitora n o est dispon vel Se este bit for ajustado ent o SCARD STATE UNAVAILABLE o aid z g todos os bits seguintes estar o sem c digo N o h cart o na leitora Se este bit for ajustado todos os bits seguintes SCARD_STATE_EMPTY x RE a estar o sem c digo SCARD STATE PRESENT H um cart o na leitora H um cart o na leitora com um ATR correspo
91. ra o API Smartnonus A Nonus fornece uma demonstra o de funcionamento da API da leitora Smartnonus Este programa tem duas finalidades permite testar a instala o da leitora Smartnonus e fornece para desenvolvedores de aplica es para cart es inteligentes um modelo de desenvolvimento inicial A API Smartnonus esta dispon vel em 2 formas C 1 Aplica o CardReader A aplica o na sua forma execut vel serve para aqueles que desejam testar a instala o da leitora Smartnonus em seu sistema bem como obter informa es sobre a vers o de firmware e dados PC SC da leitora Pode ser obtida por download gratuito em www nonus com br smartnonus Descompacte e execute o arquivo CardReader zip C 1 1 Aba Informa es Fornece dados sobre Vers o do Firmware estado da Leitora e ATR do Cart o C 1 2 Aba Execu o Fornece informa es em tempo real sobre o estado da leitora C 1 3 Aba Avan ado Fornece informa es sobre as invoca es via SP de Fornecedor da Leitora Comunica o Protocolos estado da interface com o cart o ATR e outros Vide sess es 4 2 4 4 e 4 5 1 deste manual Informa es sobre a leitora Smartnonus CASTLES EZ100PU 0 PC SC Parte 3 Tabela 3 1 Enumera o das funcionalidades Fornecedor da leitora Vendor name CASTLES Vendor IFD type EZ100PU Vendor IFD version 0x00 Comunica o Channel ID 0x200000 Protocolos Asynchronous protocol supported 0x13 Default clock 3571
92. rd Observa es A fun o CasUIDIgSelectCard fornece um m todo para conectar a um cart o inteligente espec fico Ao ser selecionada esta fun o realiza uma busca por cart es inteligentes adequados que correspondam ao membro OPENCARD SEARCH CRITERIA de pDlgStruc Dependendo do membro dwFlags do pDlgStruc esta fun o assume as seguintes a es Valor para dwFlag A o C DLG FORCE UI Se conecta ao cart o selecionado pelo usu rio do di logo select card do cart o inteligente SC DLG MINIMAL UI Seleciona o cart o inteligente se apenas um se enquadra ao crit rio ou retorna informa o sobre a sele o do usu rio se mais de um cart o inteligente se enquadra ao crit rio SC DIG NO UI Seleciona o primeiro cart o dispon vel Valores de Retorno v lido SCARD S SUCCESS ani Um c digo de erro aparecer para uma lista de c digos de erro Inv lido Rua consultar C digos de Erro 95 6 4 C digos de Erros do Cart o Inteligente Erro SCARD E CANCELLED SCARD E CANT DISPOSE SCARD E CARD UNSUPPORTED SCARD E DUPLICATE READER SCARD E INSUFFICIENT BUFFER SCARD E INVALID ATR SCARD E INVALID HANDLE SCARD E INVALID PARAMETER SCARD E INVALID TARGET SCARD E INVALID VALUE SCARD E NOT READY SCARD E NOT TRANSACTED SCARD E NO MEMORY SCARD E NO SERVICE SCARD E NO SMARTCARD SCARD E PCI TOO SMALL SCARD E PROTO MISMATCH SCARD E READER UNAVAILABLE SCARD E READER UNSUPPORTED SCARD E SERVICE S
93. retorna quando h uma mudan a de disponibilidade tendo preenchido nos membros dwEventState do par metro rgReaderStates apropriadamente LONG casGetStatusChange IN SCARDCONTEXT hContext IN DWORD dwTimeout IN OUT LPSCARD READERSTATE rgReaderStates IN DWORD cReaders Par metros hContext Fornece o identificador do contexto do gerente de recursos O contexto do gerente de recursos ajustado por uma sele o pr via para CasEstablishContext dwTimeout Fornece a quantidade m xima de tempo em milissegundos para aguardar uma a o Um valor zero implica em um valor de INFINITE dwTimeout nunca se esgotar rgReaderStates Fornece uma matriz de estruturas SCARD_READERSTATE que especifica quais as leitoras a serem observadas e recebe o resultado cReaders Fornece o numero de elementos na matriz rgReaderStates Valores de Retorno Se a fun o for O valor de retorno ser V lido SCARD S SUCCESS zit Um c digo de erro aparecer para uma lista de c digos de erro Inv lido ao consultar C digos de Erro Observa es CasGetStatusChange uma fun o de rastreabilidade do cart o inteligente 76 6 3 17 CasIntroduceCardType A fun o CasIntroduceCardType apresenta um cart o inteligente ao subsistema do cart o inteligente para um usu rio ativo adicionando o base de dados do cart o inteligente LONG CaslntroduceCardType IN SCARDCONTEXT hContext IN LPCTSTR szCardName IN LPGUID pguidPrim
94. rface de Comunica o USB A leitora Smartnonus utiliza o canal 1 0 USB Universal Serial Bus suportando comunica o de dados bidirecional Atrav s deste canal I O a leitora implementa as funcionalidades necess rias para suportar o componentes do m dulo de Interface IFD Handler Interface A leitora Smartnonus compat vel com as especifica es do padr o PC SC Parte 3 e 4 n o implementa o padr o USB CCID Na camada de fun o do protocolo USB Function Layer a leitora Smartnonus implementada como um dispositivo perif rico ICC Reader Device vide figura abaixo PC Hub Raiz V Hub Smartnonus ICC reader Figura 4 10a Abaixo est o alistadas as funcionalidades providas pela leitora Smartnonus como dispositivo ou perif rico USB Fun o Descri o Ativa o da leitora Ativa o autom tica quando a leitora conectada USB Hot Plugging Detec o da inser o do cart o Detec o da inser o ou remo o do cart o e gera o de evento para o PC Gerenciamento dos contatos do cart o Ativa o autom tica dos contatos do cart o durante a inser o desativa o da leitora durante a remo o do cart o Inicializa o do cart o A leitora executa um Cold Reset na inser o e ativa o de um cart o executa a leitura da sequ ncia ATR quando presente e envia o ATR ao PC Se o tempo de resposta do ATR excedido a leitora informa o tipo de cart o com
95. rmite aos cart es inteligentes serem integrados a qualquer aplica o desejada independente da linguagem de programa o desde que suportada largamente por linguagens tais como C C CH Java e outros A Nonus disponibiliza atrav s de seu site ou em m dia quando requisitado o M dulo de Interface na forma de device drivers implementando o M dulo da Interface e o Driver para o canal I O USB de forma que poss vel aos Provedores de Servi o se comunicarem com cart o por meio da Leitora Smartnonus Os drivers da Smartnonus prov m mecanismos de tratamento de erros existem 2 partes de tratamento de erros no canal USB e no protocolo do cart o inteligente Estas tratativas s o detalhadas nas se es a frente Os device drivers est o dispon veis para as principais vers es de sistemas operacionais para PC s entre eles diversas vers es do Windows Linux e tamb m para computadores MacOSx A figura abaixo ilustra a arquitetura PC SC a rea pontilhada em vermelho representa o sistema de componentes da leitora Aplica o Provedor de servi os do cart o ICC Resource Manager Gerente de recursos do cart o IFD Handler M dulo ou Interface OD x Dri IFD Subsystem ro Device Uriver Escopo dos requisitos Driver USB da leitora de conex o de leitoras em computadores ressoais Sistema de componentes da leitora Leitora Nonus Figura 4a
96. rno v lido SCARD S SUCCESS a Um c digo de erro aparecer para uma lista de c digos de erro Inv lido pbs consultar C digos de Erro Observa es CasForgetCardType uma fun o de gerenciamento da base de dados 68 6 3 10 CasForgetReader A fun o CasForgetReader remove uma leitora introduzida previamente do controle pelo subsistema do cart o inteligente Ela removida da base de dados do cart o inteligente incluindo de qualquer grupo de leitoras que pode ter sido adicionado a ela LONG CasForgetReader IN SCARDCONTEXT hContext IN LPCTSTR szReaderName Par metros hContext Fornece o identificador do contexto do gerente de recursos O contexto do gerente de recursos ajustado por uma sele o pr via para CasEstablishContext szReaderName Fornece o nome apropriado da leitora a ser removida da base de dados do cart o inteligente Valores de Retorno gro Um c digo de erro aparecer para uma lista de c digos de erro Inv lido ZA consultar C digos de Erro Observa es Se a leitora especificada o ltimo membro de um grupo de leitoras o grupo de leitoras tamb m removido automaticamente CasForgetReader uma fun o de gerenciamento da base de dados 69 6 3 11 CasForgetReaderGroup A fun o CasForgetReaderGroup remove do subsistema do cart o inteligente um grupo de leitoras de cart o inteligente introduzido previamente Embora esta fun o libere todas as
97. specificado se ele ainda n o existir CasAddReaderToGroup uma fun o de gerenciamento da base de dados 59 6 3 2 CasBeginTransaction A fun o CasBeginTransaction inicia uma transa o esperando pela conclus o de todas as outras transa es antes que ela comece Quando a transa o se iniciar o acesso de todos os outros aplicativos ao cart o inteligente ser bloqueado enquanto a transa o estiver em curso LONG CasBeginTransaction IN SCARDHANDLE hCard Ip Par metros hCard Fornece o valor de refer ncia obtido de uma sele o anterior para o CasConnect Valores de Retorno v lido SCARD S SUCCESS ai Um c digo de erro aparecer para uma lista de c digos de erro Inv lido ae consultar C digos de Erro Observa es CasBeginTransaction uma fun o de acesso do cart o inteligente e da leitora 60 6 3 3 CasCancel A fun o CasCancel conclui todas as a es pendentes dentro de um contexto espec fico do gerente de recursos As nicas solicita es que voc pode cancelar s o aquelas que exigem que se espere por uma a o externa do cart o inteligente ou do usu rio Quaisquer solicita es por a es pendentes terminar o com uma indica o de status de que a a o foi cancelada Isto especialmente til para for ar a conclus o de sele es pendentes de CasGetStatusChange LONG CasCancel IN SCARDCONTEXT hContext Ip Par metros hContext Fornece o identificador d
98. stallation settings click Back Click Cancel to exit the wizard InstallShield 42 5 3 5 O programa de instala o copiar os arquivos do driver da leitora Smartnonus No final do processo de instala o voc receber um aviso neste instante conecte a leitora Smartnonus numa porta USB livre de seu computador e clique no bot o OK Conecte seu Dispositivo Conecte seu dispositivo a este computador a qualquer momento depois que a instala o tiver sido conclu da 5 3 6 Caso o seu Windows XP esteja atualizado para a vers o SP3 Service Pack 3 o programa de instala o vai invocar o servi o de controle de cart o inteligente Smart Card Service Tool v1 0 Clique no bot o Apply em seguida feche a janela Smart Card Service Control Tool v1 0 Windows XP Professional Service Pack 3 build 2600 Display Name Staatus Type Process List Cart o inteligente START AUTO F svchost exe Service Name 3 MsMpEng exe SCardsvr j C MANUAL svchost exe svchost exe C SUSPEND svchost exe C DISABLE spoolsv exe svchost exe Auto Refresh 2000 C RESUME alg exe Information Explorer EXE igfxtray exe hkemd exe gt The program attempts to start the following service igfxpers exe SCardSvr msseces exe gt Service start successfully ctfmon exe gt StartType Auto wmiprvse exe gt Set start type successfully setup exe MSIEXEC EXE gt Smart Card service status works perfe
99. tado para outras linguagens de programa o mediante consulta ao suporte t cnico Nonus 105
100. tar C digos de Erro Observa es Todas as leitoras instaladas no sistema s o automaticamente introduzidas por seus nomes de sistema Normalmente CasIntroduceReader selecionado apenas para mudar o nome de uma leitora existente CasIntroduceReader uma fun o de gerenciamento da base de dados Para uma descri o de outras fun es de gerenciamento de base de dados consulte as Fun es de Gerenciamento da Base de Dados Para remover uma leitora utilize CasForgetReader 78 6 3 19 CasIntroduceReaderGroup A fun o CasIntroduceReaderGroup apresenta um grupo de leitoras para o subsistema do cart o inteligente No entanto o grupo de leitoras n o criado at que o grupo seja especificado ao adicionar uma leitora base de dados do cart o inteligente LONG CaslntroduceReaderGroup IN SCARDCONTEXT hContext IN LPCTSTR szGroupName Par metros hContext Fornece o identificador do contexto do gerente de recursos O contexto do gerente de recursos ajustado por uma sele o pr via para CasEstablishContext szGroupName Fornece o nome apropriado a ser atribu do para o novo grupo de leitoras Valores de Retorno gro Um c digo de erro aparecer para uma lista de c digos de erro Inv lido Za consultar C digos de Erro Observa es CasintroduceReaderGroup fornecido para compatibilidade de especifica o PC SC Grupos de leitoras n o ser o armazenados at que uma leitora seja adicionada ao
101. tar selecionada Depois de um Reset de um Power Down ou da sele o de uma nova aplica o o conte do da mem ria RAM descartado Todos os dados persistentes precisam ser explicitamente gravados em mem ria n o vol til EEPROM do cart o Canais seguros Secure Messaging A ISO 7816 define uma maneira de enviar e ou receber comandos APDU com Secure Messaging Altera se um bit do campo classe CLA da instru o e ao inv s do bloco de texto pleno o cart o passa a esperar e ou a devolver comandos com Secure Messaging 4 Interoperabilidade com Computadores Pessoais A leitora Smartnonus compat vel com a norma PC SC 1 0 de Dezembro de 1997 A norma PC SC Personal Computer Smart Card um esfor o para gerar uma especifica o internacional para conectar cart es em PC s As empresas Bull Hewlett Packard Microsoft Schlumberger Siemens Nixdorf Gemplus IBM Sun Verifone e Toshiba participaram da especifica o desta norma Conforme especificado para as Leitoras IFD Interface Device a Smartnonus adere a parte 3 Requirements for PC Connected Interface Devices e parte 4 Design Considerations and Reference Design Information da especifica o A especifica o PC SC independente de plataforma havendo implementa es para os sistemas mais populares tais como o Microsoft Windows e diferentes distribui es do Linux atendendo assim a grande maioria dos computadores pessoais A especifica o PC SC pe
102. te Fornece o status atual da leitora conforme visto pelo aplicativo Este campo pode assumir qualquer um dos valores a seguir em combina o como uma m scara de bits O aplicativo desconhece o status presente e gostaria de saber O uso deste SCARD STATE UNAWARE valor resulta em um retorno imediato dos servi os de monitoramento de transi o de status Isto representado por todos os bits sendo zerados O aplicativo n o est interessado nesta leitora e isto deve ser considerado SCARD STATE IGNORE durante as opera es de monitoramento Se este valor de bit for ajustado todos os outros bits ser o ignorados O aplicativo acredita que esta leitora n o est dispon vel para uso Se este SCARD STATE UNAVAILABLE s as a bit for ajustado entdo todos os bits seguintes serdo ignorados O aplicativo acredita que n o h cart o na leitora Se este bit for ajustado SCARD STATE EMPTY aa os todos os bits seguintes ser o ignorados SCARD STATE PRESENT O aplicativo acredita que h um cart o na leitora O aplicativo acredita que h um cart o na leitora com um ATR correspondendo a um dos cart es alvo Se este bit for ajustado SCARD STATE PRESENT assumido Este bit n o tem nenhum significado para o CasGetStatusChange al m de SCARD STATE PRESENT SCARD STATE ATRMATCH O aplicativo acredita que o cart o na leitora est alocado para uso exclusivo SCARD STATE EXCLUSIVE por outro aplicativo Se este bit fo
103. tnonus e pode ser baixado gratuitamente Al m de testar a instala o da leitora na sua tela principal permite ler a vers o do firmware da leitora A vers o corrente do firmware at a impress o deste manual conforme a figura abaixo CAS EMV101U 0097 INFORMA ES SOBRE O LEITOR CASTLES EZ100PU O Status SCARD STATE PRESENT SCARD STATE UNPOWERED Firmware CAS EMV101U 0097 INFORMA ES SOBRE O CART O CART O PRESENTE Status CART O V LIDO ATR 3B B2 11 00 10 80 00 08 CONFIGURA ES CASTLES EZ100PU 0 l M Detectar automaticamente os cart es inseridos Detectar agora Figura B 2 Identifica o da vers o de firmware da leitora Smartnonus 101 B 3 Identifica o do Software O software de demonstra o de API Nonus possui a identifica o da vers o na sua janela principal Na figura B 3 1 poss vel observar esta identifica o como Demonstra o API Smartnonus v 1 0 Para identificar a vers o do software ou driver instalado preciso acessar o Gerenciador de Dispositivos para isto a Aponte e clique no menu Iniciar b Em seguida aponte e clique em Painel de Controle c Aponte e clique na categoria Sistema e Seguran a d Em seguida aponte e clique em Sistema e Na aba esquerda clique agora em Gerenciador de Dispositivos Arquivo A o Exibir Ajuda e 9 7008 me PRs 4a m36801 b EP Adaptadores de rede gt RY Adaptadores de video gt AB Baterias b
104. to do gerente de recursos O contexto do gerente de recursos ajustado por uma sele o pr via para CasEstablisnContext Este valor pode ser NULL se a sele o para CasGetCardTypeProviderName n o for direcionado para um contexto espec fico szCardName Fornece o nome do tipo de cart o com o qual o nome do fornecedor associado dwProviderld Fornece o identificador para o fornecedor associado com este tipo de cart o O valor fornecido para dwProviderld poder ser um dos seguintes Valor A o A fun o recupera o nome do fornecedor SCARD PROVIDER PRIMARY prim rio do servi o de cart o inteligente como uma sequ ncia GUID SCARD PROVIDER CSP A fun o recupera o nome do fornecedor do servi o criptogr fico szProvider Vari vel de sequ ncia que conter o nome do fornecedor recuperado ap s a conclus o bem sucedida desta fun o pcchProvider Apontador para o valor DWORD Na entrada pcchProvider fornece o comprimento do buffer szProvider em caracteres Se este valor for SCARD AUTOALLOCATE ent o o szProvider convertido de um apontador para um apontador em sequ ncia e recebe o endere o do bloco de mem ria contendo a sequ ncia Este bloco de mem ria deve ser desalojada selecionando CasFreeMemory Na sa da este valor representa o n mero real de caracteres incluindo o caractere nulo na vari vel szProvider Valores de Retorno v lido SCARD S SUCCESS a Um c digo de erro aparecer para uma lista de c
105. u ncia padr o dentro do intervalo de 1 a 5 MHz A leitora aguarda at que uma aplica o estabele a uma conex o l gica antes de negociar os par metros do protocolo PPS As requisi es de conex o cont m indicadores do protocolo desejado bem como par metros que devem ser otimizados ou deixados no valor padr o O m dulo da interface da leitora Smartnonus prov uma interface ou servi o que permite ao Provedor de Servi os do Cart o enumerar as configura es de protocolo e os par metros dispon veis A informa o retornada codificada na tabela abaixo utiliza uma estrutura TLV tag length value vide ap ndice A Em adicional veja o ap ndice C Demonstra o API Smartnonus na sess o C 1 3 software demonstra o Nonus que permite executar este servi o Elemento de Dado TAG tis somente Coment rios M ximo Leitura Tino de Protocolo DWORD codificado da mesma maneira que os ak 0x0201 4 bytes X Tipos de Protocolos Dispon veis ilegal especificar mais do que um protocolo neste valor Frequ ncia de CLK corrente do Cart o em KHz CLK Corrente 0x0202 4 bytes X codificada como valores inteiros Exemplo 3 58 MHz codificado como o inteiro 3580 F Corrente Fator de F codificado como inteiro Convers o do Clock 0x0293 4 bytes x Pode ser modificado atrav s de PPS D Corrente Fator de x TER x D codificado como inteiro onversao dio BN 0x0204 bytes x Pode ser m
106. uando o seu navegador concluir o download poder executar diretamente o programa de instala o ou salvar o arquivo numa pasta local como por exemplo sua pasta Documentos 5 2 1 Execute o arquivo de instala o a partir de uma pasta local ou da p gina da leitora Smartnonus Selecione o idioma de instala o escolha Portugu s Brasileiro se estiver dispon vel ou Ingl s Estados Unidos Ey Select the language for this installation from the choices below Ingl s Estados Unidos v 36 5 2 2 No formul rio seguinte aponte e clique no bot o Next Pr ximo 5 EzUSB Smart Card Reader Setup For Windows Vista 32 bit InstallShield Wizard Welcome to the InstallShield Wizard for EZUSB Smart Card Reader Setup For Windows Vista 32 bit The InstallShield R Wizard will install EZUSB Smart Card Reader Setup For Windows Vista 32 bit on your computer To continue dick Next WARNING This program is protected by copyright law and international treaties Ready to Install the Program The wizard is ready to begin installation Click Install to begin the installation If you want to review or change any of your installation settings click Back Click Cancel to exit the wizard InstallShield 37 fal EzUSB Smart Card Reader Setup For V Installing EZUSB Smart Card Reader Setup For Windows 32 bit The program features you selected are being installed Please wait while the InstallShield
107. uzir a busca definindo o contexto do gerente de recursos O contexto do gerente de recursos definido selecionando CasEstablishContext antes de selecionar uma fun o de consulta Nota Sem contexto espec fico algumas informa es podem ainda ser inacess veis devido s restri es de seguran a Para Selecione Recuperar o identificador GUID do fornecedor do servi o prim rio para o cart o CasGetProviderld dado Recuperar uma lista de cart es introduzida previamente no sistema por um usu rio a CasListCards espec fico Recuperar os identificadores GUID das interfaces fornecidas para um cart o dado CasListInterfaces Recuperar uma lista de grupos de leitoras que foi introduzida previamente no CasListReaderGroups sistema Recuperar a lista de leitoras dentro de um conjunto de grupos de leitoras designadas CasListReaders 6 1 2 Fun es de Gerenciamento da Base de Dados do Cart o Inteligente Estas fun es gerenciam a base de dados do cart o inteligente atualizando a base de dados utilizando um contexto do gerente de recursos especificado Nota A seguran a da base de dados mantida estabelecendo restri es de acesso base de dados ao inv s de adicionar mecanismos de seguran a ao subsistema do cart o inteligente Para Selecione Adicionar uma leitora ao grupo de leitoras CasAddReaderToGroup Remover um cart o inteligente do sistema CasForgetCardType Remover uma leitora do sist

Smartnonus

Contents

Download Pdf Manuals

Related Search

Related Contents