Servizio ISEE Invio comandi alla carta

Transcript

1 Servizio ISEE Invio comandi alla carta Versione /12/2012 RTI Funzione Nome Redazione Approvazione Capo progetto RTI (Aruba) Esperto di dominio (Actalis) Capo progetto CMS (Engineering) Esperto architetture (Engineering) Capo progetto RTI Umberto Ferrara, Riccardo Casiraghi Massimo Agostiniani Fabio Bennati Umberto Ferrara Regione Toscana Funzione Nome Verifica Approvazione Nome file: CSE-ServizioISEE-InvioComandiAllaCarta-v1.1.doc Pag. 1 di 12

2 Indice AGGIORNAMENTI DELLE VERSIONI GENERALITÀ Scopo Riferimenti Definizioni e abbreviazioni Allegati Organizzazione del File System Popolamento/aggiornamento dati servizio ISEE Connessione alla carta e selezione DF servizio aggiuntivo ISEE External authenticate Generazione sequenza randomica di bytes Firma sequenza randomica di bytes External authenticate Scrittura dei file elementari presenti nel servizio Scrittura contenuto EF_ISEE_INFO_APPL Scrittura contenuto EF_ISEE_HASH Scrittura contenuto EF_ISEE_SIGNATURE Lettura dati servizio ISEE Connessione alla carta e selezione DF servizio aggiuntivo ISEE Lettura dei file elementari presenti nel servizio Lettura contenuto EF_ISEE_INFO_APPL Lettura contenuto EF_ISEE_HASH Lettura contenuto EF_ISEE_SIGNATURE Pag. 2 di 12

3 AGGIORNAMENTI DELLE VERSIONI Versione Data Motivo Modifiche /12/2012 Emissione /12/12 Correzione 3,1 aggornato FID Pag. 3 di 12

4 1 GENERALITÀ Il presente documento si riferisce al progetto di gestione del servizio aggiuntivo ISEE. 1.1 Scopo Obiettivo di questo documento è descrivere le modalità di interfacciamento con le TS-CNS per le operazioni di lettura e scrittura delle informazioni relative al servizio ISEE. 1.2 Riferimenti Definizioni e abbreviazioni RT CSE TS-CNS Regione Toscana Carta Sanitaria Elettronica Tessera Sanitaria Carta Nazionale dei Servizi 1.4 Allegati N.A. 2 ORGANIZZAZIONE DEL FILE SYSTEM Di seguito l organizzazione del file system per la gestione del servizio aggiuntivo ISEE: DF2 Dati_personali_aggiuntivi EF_Memoria_residua EF_Servizi_Istallati EF_INST_FILE DF EF BSO BSO_InstPubKey BSO_Kia BSO_Kic DF_ISEE EF_INFO _APPL EF_HASH EF_SIGNATURE BSO_AdminISEE_pubKey Pag. 4 di 12

5 Servizio ISEE File/Object Name Parent Description FID/ID (hex) Type Algorithm Net Size DF_ISEE DF2 Servizio aggiuntivo ISEE 1F21DF EF_ISEE_INFO_APPL Info applicative servizio ISEE 0001EF_T (**) 400 EF_ISEE_HASH Hash sha1 del contenuto di EF_ISEE_INFO_APPL 0002EF_T (***) 20 EF_ISEE_SIGNATURE Firma RSA raw con chiave di lunghezza 1024 del contenuto di EF_ISEE_INFO_APPL 0003EF_T (****) 128 File/Object Name Update Append Activate/D eactivate Access Conditions: DF DF_ISEE nev nev nev BSO_InstP nev Nev ubkey EF_ISEE_INFO_APPL alw EF_ISEE_HASH alw EF_ISEE_SIGNATURE alw Access Conditions: EF Delete Admin Create Read Update Append Activate/Deac tivate BSO_ISEE_A dminpubkey BSO_ISEE_A dminpubkey BSO_ISEE_A dminpubkey Delete Admin nev nev nev nev nev nev nev nev nev nev nev nev 3 POPOLAMENTO/AGGIORNAMENTO DATI SERVIZIO ISEE In questo capitolo è riportato un possibile elenco di apdu che consente la scrittura dei dati applicativi previsti per il servizio aggiuntivo ISEE. 3.1 Connessione alla carta e selezione DF servizio aggiuntivo ISEE Per poter inviare comandi alla carta è necessario stabilire una connessione come mostrato nel seguente esempio: exec: card#connect#card Reader name: ACS ACR38U 0 Establish Context():... Card inserted into ACS ACR38U 0 Card ATR is 24: 3BDF FE7D006B150C E F8 Output : 3B DF FE 7D 00 6B 15 0C E F8 Status : OK La selezione del folder DF_ISEE avviene tramite l invio di una apdu SELECT avente come argomento l identificatore del folder DF_ISEE (1F 21). Command : 00 A Input Data [Le] : F 21 In caso di corretta selezione (vedi esempio) la carta restituisce lo SW In caso di invio del comando ad una carta che non contiene il servizio ISEE la carta restituisce lo SW 6A External authenticate Per poter aggiornare (o scrivere per la prima volta) i dati del servizio ISEE è necessario soddisfare la condizione di accesso Update associata agli Elementary Files (EFs) EF_ISEE_INFO_APPL, EF_ISEE_HASH. Pag. 5 di 12

6 EF_ISEE_SIGNATURE. Il Base Security Object BSO_ISEE_AdminPublicKey la cui verifica consente la scrittura dei summenzionati EFs è di tipo RSA Public Key. Per poterlo verificare l applicazione deve effettuare i seguenti passi: - chiedere alla carta la generazione di una sequenza randomica di bytes, - firmare/cifrare la sequenza randomica di bytes ritornata con la chiave amministrativa privata corrispondente al BSO_ISEE_AdminPublicKey (la chiave amministrativa privata è in possesso del gestore del servizio ISEE) - chiedere alla carta la validazione della sequenza di bytes firmata/cifrata tramite apdu external_authenticate. Se la validazione ha esito positivo (apdu external authenticate eseguita con successo) è possibile procedere con l aggiornamento del contenuto dei tre EFs Generazione sequenza randomica di bytes Il seguente esempio mostra l invio della richiesta di generazione di una sequenza randomica di lunghezza 8 bytes. // Get Challenge Command : Output Data : 76 BE E F4 7D Firma sequenza randomica di bytes La sequenza randomica di bytes ritornata dalla carta (76 BE E F4 7D nell esempio) deve essere frmata/cifrata, in modalità PKCS1 padding, con la chiave amministrativa privata del gestore del servizio ISEE. La modalità operativa di apposizione della firma dipende dal tipo di supporto per la conservazione della chiave amministrativa privata (file system, smart card, HSM) e/o dalla particolare libreria crittografica utilizzata. Essendo la lunghezza della chiave amministrativa del servisio ISEE pari a 1024 bit (128 bytes) la firma/cifratura della sequenza randomica avrà lunghezza 128 bytes, come mostrato nel seguente esempio: exec: mngrsaprivkey#encrypt#pkcs12#../data/adminisee.p12 # p12.2 # G # N Output Status : 1C 19 8A 1D 90 EA B2 28 BD 0F DB C7 B B8 AC F3 57 C0 57 E1 BC AA 71 A3 E2 E8 29 0D CB EB B0 E4 5D D5 1E F9 35 5A 77 C2 42 A E7 FC 1D 06 A A6 37 A3 A8 FF A0 6F 3E 6E 50 2F FA 2A CB 4F 37 B F3 C0 2E A0 3D 56 D8 6A AB B3 5A 2E 8D 78 C6 39 F3 5D 35 1E 43 AB A D0 8A B0 9B 85 C1 1A B 45 E9 76 FB A8 83 3E B8 68 AE C : OK External authenticate La sequenza firmata/cifrata di 128 bytes viene passata alla carta tramite l apdu external authenticate Command : Pag. 6 di 12

7 Input Data [Le] : 1C 19 8A 1D 90 EA B2 28 BD 0F DB C7 B B8 AC F3 57 C0 57 E1 BC AA 71 A3 E2 E8 29 0D CB EB B0 E4 5D D5 1E F9 35 5A 77 C2 42 A E7 FC 1D 06 A A6 37 A3 A8 FF A0 6F 3E 6E 50 2F FA 2A CB 4F 37 B F3 C0 2E A0 3D 56 D8 6A AB B3 5A 2E 8D 78 C6 39 F3 5D 35 1E 43 AB A D0 8A B0 9B 85 C1 1A B 45 E9 76 FB A8 83 3E B8 68 AE C In caso di corretta verifica (vedi esempio) la carta restituisce lo SW In caso di fallimento verifica (dovuta ad esempio all utilizzo di una chiave privata non corrispondente alla chiave pubblica, alla firma/cifratura di una sequenza di bytes non corrispondente alla sequenza di bytes randomica restituita) la carta restituisce i seguenti SW: SW Verifica corretta 63 C2 Verifica fallita: rimangono altri due possibili tentativi 63 C1 Verifica fallita: rimane un solo possibile tentativo prima del blocco di BSO_ISEE_AdminPublicKey 63 C0 Verifica fallita: BSO_ISEE_AdminPublicKey bloccato; non sono possibili ulteriori tentativi BSO_ISEE_AdminPublicKey è bloccato. La verifica fallisce anche in caso di passaggio dati corretti 3.3 Scrittura dei file elementari presenti nel servizio La scrittura del contenuto dei tre files elementari presenti avviene tramite l invio di apdu UPDATE_BINARY previa selezione del file elementare tramite apdu SELECT Scrittura contenuto EF_ISEE_INFO_APPL L identificatore del file EF_ISEE_INFO_APPL (00 01) è specificato nel comando select Command : 00 A Input Data [Le] : In caso di corretta selezione (vedi esempio) la carta restituisce lo SW In caso di invio del comando ad una carta che non contiene il file EF_ISEE_INFO_APPL la carta restituisce lo SW 6A 82 La dimensione del file EF_ISEE_INFO_APPL è di 400 bytes. Se la dimensione della struttura dati applicativi del servizio ISEE (struttura ASN.1) è inferiore a 255 bytes può essere veicolata tramite una sola apdu come mostrato nel seguente esempio (75h = 117 bytes Pag. 7 di 12

8 veicolati) Command : 00 D Input Data [Le] : C 4C C B E C 4C C F E 58 5A 4B 43 2B A 48 4F 2F F B F 59 3D Se la dimensione della struttura dati applicativi del servizio ISEE è superiore a 255 bytes può essere veicolata tramite l inviato in sequenza due apdu UPDATE_BINARY come mostrato nl seguente esempio // scrittura dei primi 255 bytes Command : 00 D FF Input Data [Le] : A6 CC D9 89 D EE 3E ED 56 0A 9D F6 2D D3 13 BC F4 31 7F CB DD 80 1B 62 5D E EB 3A F1 5D BD 77 3C CB 0E 9C 07 EA 76 8B A E7 34 AC E CE E AB FC 39 D6 8A 9A CE FF 73 4F B C7 0B E3 5D 4E D E8 09 C5 42 4C BB E9 51 B D9 B E0 4D 7D CF E 3B CA 36 B1 33 C3 BC 37 C1 D0 9B B9 76 5B E4 E2 30 AD B4 BB B2 70 BC BE 9E 1D 6D B D 26 A2 58 BD 84 5B 38 E4 40 E1 D3 B2 64 F7 5E E C3 0A CF 54 5A FF 4B 83 C D2 D0 98 E0 75 B6 98 F7 2D 33 7F 7C B9 FC B2 F3 47 B E 58 2F B D5 25 B9 CF EA 5F 7B B0 6B 01 F3 EE 8F 8B 90 A4 04 E9 FB D7 22 8E 82 9B 31 C5 A9 46 A5 EA CA 37 5E A4 EC B6 34 // scrittura dei rimanenti 16 bytes Command : 00 D6 00 FF 10 Input Data [Le] : B2 70 BC BE 9E 1D 6D B D 26 A2 58 BD 84 In caso di corretta scrittura (vedi esempio) la carta restituisce lo SW In caso di fallimento la carta restituisce i seguenti SW: SW Esecuzione corretta Esecuzione fallita: condizioni di scrittura non verificate 6A 84 Esecuzione fallita: tentativo di scrittura oltre la dimensione del file Pag. 8 di 12

9 3.3.2 Scrittura contenuto EF_ISEE_HASH L identificatore del file EF_ISEE_HASH (00 02) è specificato nel comando select Command : 00 A Input Data [Le] : La dimensione del file EF_ISEE_HASH è di 20 bytes. Il file deve essere aggiornato con l impronta SHA-1 del contenuto effettivo (dimensione della struttura Asn.1) dei dati applicativi memorizzati in EF_ISEE_INFO_APPL. Per poter scrivere l intero contenuto del file deve essere inviata una sola apdu UPDATE_BINARY. Command : 00 D Input Data [Le] : A9 D3 F0 9E D2 FF E D9 A DF CD Vedi possibili SW al par Scrittura contenuto EF_ISEE_SIGNATURE L identificatore del file EF_ISEE_SIGNATURE (00 03) è specificato nel comando select Command : 00 A Input Data [Le] : La dimensione del file EF_ISEE_SIGNATURE è di 128 bytes. Il file deve essere aggiornato con la firma dell impronta SHA-1 (memorizzata nell EF EF_ISEE_HASH) apposta tramite apposita credenziale di firma del gestore del servizio ISEE dedicata allo scopo. Essendo la lunghezza dell apposita chiave di firma RSA del gestore del servizio ISEE pari a 1024 bit (128 bytes) la firma dell hash avrà lunghezza 128 bytes. La modalità operativa di apposizione della firma dipende dal tipo di supporto per la conservazione della chiave privata ad uso firma (file system, smart card, HSM) e/o dalla particolare libreria crittografica utilizzata. Per poter scrivere l intero contenuto del file deve essere inviata una sola apdu UPDATE_BINARY. Command : 00 D Input Data [Le] : C BA DD FE 8C 3A 05 5A C0 5C EB E EF DF 00 1F 2F D A 99 2E 4C E3 96 9F B6 5D A 4E C B0 13 CB 84 DB E C D BE EC B0 90 BD 9D FC 45 7D C0 80 0B D3 5D D2 81 C2 CC DF B5 B D C B A7 59 C6 C6 3C 60 6C EE 8F C 8D 4A D3 B5 FC 06 Pag. 9 di 12

10 Vedi possibili SW al par LETTURA DATI SERVIZIO ISEE In questo capitolo è riportato un possibile elenco di apdu che consente la lettura dei dati contenuti nel servizio aggiuntivo ISEE. 4.1 Connessione alla carta e selezione DF servizio aggiuntivo ISEE Per poter inviare comandi alla carta è necessario stabilire una connessione come mostrato nel seguente esempio: exec: card#connect#card Reader name: ACS ACR38U 0 Establish Context():... Card inserted into ACS ACR38U 0 Card ATR is 24: 3BDF FE7D006B150C E F8 Output : 3B DF FE 7D 00 6B 15 0C E F8 Status : OK La selezione del folder DF_ISEE avviene tramite l invio di una apdu SELECT avente come argomento l identificatore del folder DF_ISEE (1F 27, valore temporaneo / non ancora registrato). Command : 00 A Input Data [Le] : F 27 In caso di corretta selezione (vedi esempio) la carta restituisce lo SW In caso di invio del comando ad una carta che non contiene il servizio ISEE la carta restituisce lo SW 6A Lettura dei file elementari presenti nel servizio La lettura del contenuto dei tre files elementari presenti avviene tramite l invio di una apdu READ_BINARY previa selezione del file elementare tramite apdu SELECT Lettura contenuto EF_ISEE_INFO_APPL L identificatore del file EF_ISEE_INFO_APPL (00 01) è specificato nel comando select Command : 00 A Input Data [Le] : In caso di corretta selezione (vedi esempio) la carta restituisce lo SW In caso di invio del comando ad una carta che non contiene il file EF_ISEE_INFO_APPL la carta restituisce Pag. 10 di 12

11 lo SW 6A 82 La dimensione del file EF_ISEE_INFO_APPL è di 400 bytes. Per poter leggere l intero contenuto del file possono essere inviate in sequenza le seguenti apdu READ_BINARY. // lettura dei primi 255 bytes Command : 00 B FF Output Data : C 4C C B E C 4C C F E 58 5A 4B 43 2B A 48 4F 2F F B F 59 3D // lettura dei rimanenti 145 bytes Command : 00 B0 00 FF FF Output Data : 00 In caso di corretta selezione (vedi esempio) la carta restituisce lo SW In alternativa alla lettura dell intero EF è ipotizzabile la lettura dei primi bytes della struttura ASN.1 contenuta per recuperare la dimenzione della struttura stessa e conseguentemente leggere solo il numero di bytes Utili Lettura contenuto EF_ISEE_HASH L identificatore del file EF_ISEE_HASH (00 02) è specificato nel comando select Command : 00 A Input Data [Le] : La dimensione del file EF_ISEE_HASH è di 20 bytes. Per poter leggere l intero contenuto del file deve essere inviata una sola apdu READ_BINARY. Pag. 11 di 12

12 Command : 00 B Output Data : A9 D3 F0 9E D2 FF E D9 A DF CD Lettura contenuto EF_ISEE_SIGNATURE L identificatore del file EF_ISEE_SIGNATURE (00 03) è specificato nel comando select Command : 00 A Input Data [Le] : La dimensione del file EF_ISEE_SIGNATURE è di 128 bytes. Per poter leggere l intero contenuto del file deve essere inviata una sola apdu READ_BINARY. Command : 00 B Output Data : C BA DD FE 8C 3A 05 5A C0 5C EB E EF DF 00 1F 2F D A 99 2E 4C E3 96 9F B6 5D A 4E C B0 13 CB 84 DB E C D BE EC B0 90 BD 9D FC 45 7D C0 80 0B D3 5D D2 81 C2 CC DF B5 B D C B A7 59 C6 C6 3C 60 6C EE 8F C 8D 4A D3 B5 FC 06 Pag. 12 di 12