Smart Card. Elementi ISO /4. Elementi ISO /4. Elementi ISO /4. Elementi ISO /4. PC/SC MUSCLE Smart card in ambiente linux

Transcript

1 Smart Card Una smart card, nella sua versione di carta a microprocessore, è, a tutti gli effetti, un computer L ISO utilizza il termine ICC (Integrated Circuit Card) 53.98mm 85.6mm Elementi ISO /4 Elementi ISO /4 La card e il lettore comunicano in base ad un paradigma del tipo comando-risposta La strutture dati a livello rete scambiate tra lettore e card si chiamano TPDU I protocolli possono essere di due tipi: T=0 halfduplex asincrono orientato ai byte. Meccanismo di rilevazione degli errori basato sul controllo di parità. T=1: halfduplex asincrono orientato ai blocchi Meccanismo di rivelazione degli errori basato sull uso di un blocco detto Error Detection Code (EDC) capacità di dividere in frame le istruzioni e la conseguente possibilità di scambiare un blocco di dati arbitrariamente lungo il comando può essere prodotto sia dalla card che dal lettore un software di gestione molto complesso T=1 vs T=0 La comunicazione è esclusivamente orientata ai byte Il comando è sempre generato dal lettore un software di gestione semplice e veloce Elementi ISO /4 Una APDU di comando si compone di un intestazione e di un body Classe dell APDU Definisce la specifica istruzione appartenente alla classe indicata in CLA Parametri dell istruzione specificata nel campo INS Elementi ISO /4 Le applicazioni e la card si scambiano informazioni attraverso strutture dati chiamate APDU Struttura dati usata per incapsulare i comandi dal lettore verso la card e i messaggi di response dalla card verso il lettore Viaggiano incapsulate all interno delle TPDU Body CLA INS P1 P2 Lc Dati Le Applicazione Dispatcher APDU Intestazione: campi di un Byte ciascuno Taglia del campo Dati Dati da comunicare alla card Numero di bytes di Response richiesti Lettore Protocollo a livello DLC (T=0 T=1) Comando Read Binary Comando Select File Comando Write Binary

2 Elementi ISO /4 Una APDU di risposta è inviata dalla card verso il lettore in risposta ad una richiesta di elaborazione E composta da un body e un trailer Elementi ISO /4 Codice di ritorno Processo completato Processo interrotto Body: può essere vuoto Elaborazione normale Warning Errore di esecuzione Checking error Trailer :contiene lo status code 61XX opp XX 63XX 64XX 65XX 67XX a 6FXX Dati SW1 SW2 Sono inclusi tutti i codici da 6700 a 6FFF Specifica la categoria dello stato in cui si trova la carta dopo aver processato l ultima istruzione Specifica lo stato in cui si trova la carta (all interno della categoria indicata da SW1) La differenza tra figlio sinistro e destro è che nel primo, al contrario del secondo, la carta non ha modificato lo stato della memoria Se la carta restituisce uno stato di "elaborazione normale", '61XX' indica la dimensione del buffer che la carta vuole restituire all'applicazione, mentre '9000' è restituito nel caso non ci sia un buffer di ritorno. La caratteristica centrale dell'iso è il file system Conservato in una memoria non volatile della card Struttura gerarchica a singola radice Supporta due categorie di files Ciascun file è identificato da un selettore a due bytes Master File (MF) E la radice della gerarchia Il suo selettore è 3F00 E obbligatorio E un DF Mantiene le informazioni sulla memoria Elementi ISO /4 Master File Dedicated Files Sono le directory Possono avere come discendenti altri DF o uno o più EF EF PC/SC - Introduzione Il consorzio PC/SC Workgroup nasce con l obiettivo di permettere agli sviluppatori di produrre applicazioni su smart card indipendenti dal lettore e dalla card Attualmente il supporto per PC/SC versione 1.0 è fornito con tutte le distribuzioni Windows DF DF EF EF DF DF EF DF EF Elementary files. Sono le foglie della gerarchia E composta da tre strati software principali: PC/SC Reference s PC/SC RM PC/SC Drivers Smart Card Readers PC/SC - Architettura PC/SC Software di basso livello Fornisce accesso alle funzionalità native del lettore Nasconde le differenze fra i vari ICC PC/SC Reference s PC/SC Architettura PC/SC RM Drivers Smart Card Readers Stabiliscono un canale di I/O fra l host e la card Forniscono alimentazione elettrica alla card Drivers dei lettori Uno per ciascun lettore installato nel sistema. Devono nascondere ogni differenza fra i vari canali di I/O utilizzabili (PS2, USB, RS232, )

3 PC/SC Architettura PC/SC Architettura PC/SC Reference s PC/SC Reference s PC/SC RM PC/SC RM PC/SC Drivers Smart Card Readers PC/SC Drivers Smart Card Readers Smart Card E un vigile che si occupa di instradare l APDU, generata dallo strato SSP, verso l handler del lettore dove la card è inserita Fornisce un accesso controllato al lettore e, attraverso quest ultimo, ad una specifica carta. Deve essere presente e dovrebbe essere fornito dal produttore del sistema operativo Dovrebbe essere unico all interno di un sistema Risolve tre tipologie tipiche di problemi: Identificazione delle risorse (lettori installati, card supportate, eventi di inserzione e rimozione delle card da uno dei lettori Controllo dell allocazione delle risorse dei lettori alle applicazioni che le richiedono (accesso esclusivo o condiviso) Supporta primitive che gestiscono la transazione sugli accessi a servizi forniti da una specifica card PC/SC Reference s PC/SC Architettura PC/SC Reference s PC/SC Architettura PC/SC RM PC/SC Drivers Smart Card Readers Leggi sulla limitazione dell esportazione di tecnologia militare strategica La crittografia forte è tale per molti paesi PC/SC RM PC/SC Drivers Smart Card Readers Interfacce di programmazione per le operazioni più comuni su una card (accesso ai file, autenticazione,...) e per fornire servizi di crittografia Uno per ogni card supportata dal sistema Si divide in due componenti indipendenti ICC Cryptographic (CSP) Sono logicamente parti di un unico modulo ma nella realtà sono distinti PC/SC Reference s PC/SC RM PC/SC Architettura ICC ICC PC/SC Reference s PC/SC Architettura Cryptographic PC/SC RM ICC Cryptographic PC/SC Drivers PC/SC Drivers Smart Card Readers Smart Card Readers Fornisce i servizi comuni di accesso ai files e di autenticazione E estendibile con funzionalità tipiche di un determinato dominio di applicazioni (mediche, bancarie ) Non dovrebbe fornire funzionalità crittografiche Necessita di una procedura di setup all interno del SCRM prima di poter essere utilizzato dal sistema Fornisce API che permettno l accesso alle funzionalità crittografiche di una specifica card I servizi crittografici generalmente supportati sono: generazione di chiavi gestione di chiavi servizi di encrypting E un componente opzionale

4 PC/SC Architettura ICC Aware Applications Overview PC/SC Reference s PC/SC RM PC/SC Drivers Smart Card Readers Qualsiasi software all interno dell ambiente del sistema operativo che voglia utilizzare le funzionalità messe a disposizione da una o più card Versione minimale dello stack PC/SC implementato per macchine Linux/Unix Implementato dal (Movement for the Use of Smart Card under LinuxEnvironment) E scritto in ANSI C Il suo componente centrale, il demone pcscd Gira in modalità kernel e gestisce efficientemente applicazioni concorrenti lettori con slot multipli multiutenza tipi di smart card Overview API Quando è inizializzato, esegue i seguenti passi 1. alloca memoria per i lettori 2. acquisisce informazioni sui lettori statici installati (come i lettori seriali) 3. testa le connessioni hot-plug per lettori, ad esempio, USB o PCMCIA 4. setta il canale attraverso il quale le applicazioni possono fare le loro richieste 5. ascolta il canale Le applicazioni si connettono al demone linkandosi alla libreria libpcsclite Iinsieme di API, che le applicazioni utilizzano per utilizzare le risorse del resource manager della card Costituiscono il livello più basso utilizzabile dalle applicazioni nello stack PC/SC SCardEstablishContext SCardListReaders La comunicazione con ICC, avviene all interno di un Contesto La chiamata a questa API provoca l assegnazione all applicazione chiamante di un canale di comunicazione privato con il resource manager LONG SCardEstablishContext (DWORD dwscope, LPCVOID pvreserved1, LPCVOID pvreserved2, LPSCARDCONTEXT phcontext Dopo aver stabilito un contesto, è possibile interrogare il sistema sui lettori correntemente installati LONG SCardListReaders ( SCARDCONTEXT hcontext, LPCSTR mszgroups, LPSTR mszreaders, LPDWORD pcchreaders

5 SCardConnect Il prossimo passo è quello di connettere la card inserita nel lettore e il lettore stesso Non esiste un meccanismo plug&play permette l interfacciamento automatico fra card e lettore LONG SCardConnect (SCARDCONTEXT hcontext, LPCSTR szreader, DWORD dwsharemode, DWORD dwpreferredprotocols, LPSCARDHANDLE phcard, LPDWORD pdwactiveprotocol Apre una connessione tra la card e il lettore SCardConnect La connessione è stabilita nell ambito di un contesto valido col card manager E possibile, in ogni momento conoscere lo stato in cui il lettore si trova nell ambito della sessione corrente SCardStatus LONG SCardStatus ( SCARDHANDLE hcard, LPSTR szreadername, LPDWORD pcchreaderlen, LPDWORD dwstate, LPDWORD pdwprotocol, LPBYTE pbatr, LPDWORD pcbatrlen SCardStatus I possibili valori di ritorno sono: carta assente carta presente carta presente ma resettata.. SCardGetStatusChange SCardGetStatusChange Sia il lettore che la card si trovano, in ogni istante di una seesione, in un determinato stato Nessuna card nel lettore Carta presente nel lettore Carta presente e allocata in modo esclusivo ad un altra applicazione Per interrogare i cambiamenti di stato, ad esempio per bloccare un applicazione nell attesa che un utente inserisca una carta nel lettore, si usa la funzione LONG SCardGetStatusChange ( SCARDCONTEXT hcontext, DWORD dwtimeout, LPSCARD_READERSTATE rgreaderstates, DWORD creaders

6 SCardTransmit SCardBeginTransaction LONG SCardTransmit ( SCARDHANDLE hcard, LPCSCARD_IO_REQUEST piosendpci, LPCBYTE pbsendbuffer, DWORD cbsendlength, LPSCARD_IO_REQUEST piorecvpci, LPBYTE pbrecvbuffer, LPDWORD pcbrecvlength Utilizzata per trasmettere le APDU sulla carta Invia l APDU alla carta inserita nel lettore cui la carta si è connessa tramite la SCardConnect In ambienti multitasking, è possibile che più applicazioni possano utilizzare concorrentemente la card Anche all interno di questi scenari, una di queste applicazioni, potrebbe voler assumere temporaneamente il controllo esclusivo delle risorse LONG SCardBeginTransaction ( SCARDHANDLE hcard Realizza una sezione critica iniziando una transazione logica tra l applicazione chiamante e la card associata al contesto referenziato da hcard SCardEndTransaction Meccanismi di Autenticazione Quando l applicazione ha terminato la sequenza di operazioni da svolgere in regime di detenzione esclusiva delle risorse, deve rilasciarle terminando la transazione LONG SCardEndTransaction ( SCARDHANDLE hcard, DWORD dwdisposition Sono due i tipi di autenticazione utilizzati dalle schede ISO compliant External Authenticate: la card si accerta dell identità dell host Internal Autenthicate: l host verifica le credenziali della card Supporti Utilizzati: Schlumberger Supporti Utilizzati: Gemplus Schlunberger CyberflexAccess 16k Non è una Java Card Fornisce 8 identità che identificano i diversi livelli di accesso alle risorse della carta default chv1 chv2 aut0-aut4 E dotata di una Transport Key Gemplus GemXpresso 211PK_Is E una Java Card Supporta le specifiche Visa per la sicurezza delle transazioni Supporta vari algoritmi di crittografia (simmetrica e asimmetrica) Versione non USA: usa chiavi a 512 bit Non è dotata di una Transport Key: utilizza l External Auth per ogni tentativo di accesso

7 Configurazione del lettore Installazione Delle Risorse 1/2 Scaricare i driver del proprio lettore da Per GEMPLUS PC410 cercare gp_core-2.4.tar.gz Compilare il file gp_core-2.4 Viene creato il file libgp_core.so Creare la directory /usr/local/lib/readers/ Installazione Delle Risorse 2/2 Installazione di PC/SC Scaricare la versione aggiornata della libreria pcsclite-1.x.x da Compilare./configure make make install Viene creato il file /usr/local/etc/reader.conf Inserire in tale file Il lettore utilizzato La porta di comunicazione La versione dei driver Un friendly name per il lettore Creare la directory /dev/pcsc e /tmp/pcsc Lanciare il demone con pcscd d stdout Inserire la card nel lettore e.. Particolari tipi di smart card che presentano una serie di caratteristiche Indipendenza dalla piattaforma Supporto a più applicazioni: su una stessa JavaCard possono coesistere diverse Java Card Applet indipendenti fra loro e selezionabili singolarmente run time Caricamento di nuove applicazioni dopo la consegna all utente finale Flessibilità: il linguaggio utilizzato per programmarle è un subset del linguaggio Java Compatibilità con gli standard delle SmartCard: le JavaCard sono compatibili con lo standard ISO 7816 L infrastruttura L infrastruttura L infrastruttura Forniscono le funzionalità di I/O, le funzionalità crittografiche e i servizi di allocazione della memoria Java Card Virutal Machine Si occupa dell interpretazione del bytecode Java Card Fornisce il supporto al linguaggio Java

8 L infrastruttura L infrastruttura Insieme delle classi che implementano l API Java Card Include i package standard e le eventuali estensioni Provvede alla distribuzione agli altri componenti dei comandi provenienti dall esterno, alla gestione delle operazioni atomiche all installazione delle Java Card Applet Interfaccia utilizzata dalle Java Card Applet per l accesso al JCRE e ai Metodi Nativi L infrastruttura L infrastruttura Java Card Runtime Environment E l ambiente Java Card che permette la portabilità del codice classi aggiuntive definite dal costruttore della Java Card, utilizzabili dalle Java Card Applet L infrastruttura Le Applet Le Java Card Applet devono presentare una struttura ben definita per funzionare correttamente Tale struttura è del tutto simile alle applet Java eseguibili dai browser in ambiente PC Nelle slide successive sono descritti i metodi necessari all utilizzo di una Java Card Applet Applicazioni scritte in un subset del linguaggio Java per essere eseguite su Java Card Implementano tutte le funzionalità della Java Card accessibili dall esterno L applicazione esterna di controllo può selezionarle una alla volta, in maniera esclusiva, e richiedergli certi servizi, quali la memorizzazione o l esecuzione di operazioni

9 Le Applet Le Applet: il metodo install() Questa è la struttura generale di una applet per Java Card I metodi necessari sono descritti in seguito import javacard.framework.*; // importazione di classi del framework... public class <Nome JavaCard Applet> extends Applet {... private <Nome JavaCard Applet>() { // metodo costruttore // si consiglia di creare qui tutti gli oggetti utilizzati dalla JavaCard Applet }. // seguono metodi nelle slide successive } Richiamato dal JCRE come ultimo passo dell installazione Applet Tutte le Java Card Applet sono oggetti persistenti per cui questo metodo è chiamato una sola volta nella vita della Java Card Applet Al suo interno vanno inserite - tutte le istruzioni di creazione degli oggetti l Applet intende utilizzare - una chiamata a System.register( ) per la registrazione della Applet presso il JCRE public static void install (APDU apdu) Le Applet: il metodo select() Le Applet: il metodo process() Richiamato dal JCRE per selezionare una Java Card Applet - il JCRE ha ricevuto un APDU riportante un istruzione di selezione della Java Card Applet La Java Card Applet può accettare o rifiutare la selezione facendo restituire al metodo true o false richiamato dal JCRE - immediatamente dopo la chiamata di select( ) la prima volta - ogni volta che arriva un APDU di comando dall entità esterna successivamente Una volta assolte le richieste, l Applet risponde con un APDU di risposta public boolean select () public void process (APDU apdu) Conclusioni Introduzione La creazione di una Java Card Applet, è un operazione piuttosto semplice Questo è vero per due motivi: - l utilizzo di un linguaggio ad alto livello quale Java - la possibilità di utilizzare un approccio ad oggetti nella creazione delle funzionalità Progetto per coordinare lo sviluppo di applicazioni per smart card in ambiente Linux Crea un interfaccia di comunicazione tra l host e la smart card compatibile con i vari modelli di lettore e di scheda e che fornisce funzionalità di sicurezza

10 Introduzione Terminologia La comunicazione con la s.c. è basata su PC/SC Progetto sviluppato per Javacard 2.0 e 2.1 compliant Nasce per Linux e per i sistemi Unix-like ma offre compatibilità anche con piattaforme basate su Windows (2000, 98, CE) e Macintosh (OS X) Un Token è un qualsiasi tipo di card, scheda pcmcia o dispositivo crittografico in generale Uno Slot è il dispositivo che contiene un token (Es. lettore di smart card) Non tutti i token e gli slot sono supportati, ma è facile verificarlo con delle funzioni fornite da Terminologia Terminologia L ACL (Access Control List) è una lista di permessi per proteggere i dati e per controllarne l accesso Definendo un ACL per un applicazione, si stabilisce la condizione che deve essere soddisfatta per effettuare una determinata operazione (Es. la verifica di un PIN) Un Oggetto Musclecard (o semplicemente oggetto) è un contenitore nel quale un applicazione può leggere e scrivere dati Non ha una propria struttura né tanto meno dei metodi ad esso associati Ha un id cha va dai 2 ai 64 caratteri ed è dotato di un ACL Terminologia Architettura - Introduzione Una Musclecard Key è una chiave identificata con un numero da 0 a 15 Ogni chiave ha delle proprietà specifiche, quali il tipo e la dimensione (in bit) Opera su due livelli differenti: Host Card Un MuscleCard PIN è una stringa di caratteri decimali a cui si fa riferimento con un identificativo compreso tra 0 e 8

11 Il livello Host ha una struttura suddivisa in 4 strati Architettura - Introduzione CARD FRAMEWORK API è il cuore di tutta la struttura di Architettura MuscleCard Plug-in CARD FRAMEWORK API Il livello Smart Card prevede il solo strato Java Card Applet CARD PLUG - IN ( CSP ) PC/SC Lite API PC/SC CSP Applet JavaCard 2.1 Compilant Card In questo strato è implementato il CSP che si occupa di tutte le caratteristiche legate alla sicurezza (es. generazione e gestione delle chiavi, dei PIN) CARD PLUG - IN ( CSP ) PC/SC Lite API PC/SC CSP Applet JavaCard 2.1 Compilant Card Architettura MuscleCard Plug-in Architettura MuscleCard Plug-in utilizza per la comunicazione un approccio basato su una javacard applet L idea è la seguente: si definiscono delle specifiche per un unico CSP a livello host si implementa un applet, da caricare sulla card, che rispetta tali specifiche La comunicazione tra l host (CSP) e la card avviene tramite l applet che viene caricata sulla carta ed a cui si può fare riferimento con un identificatore statico predefinito chiamato application id (AID) I comandi forniti dal plug-in si dividono in quattro gruppi : gestione delle chiavi gestione dei PIN gestione dei Musclecard Object gestione generale a questo livello di astrazione i comandi sono delle APDU Architettura MuscleCard Plug-in Facciamo qualche esempio: GenerateKeyPair Architettura MuscleCard Plug-in GenerateKeyPair Codice dell istruzione (hex) Dimensione del campo successivo Caratteristiche delle chiavi GenetareKeyPair S 30 Chiave Priv Chiave Pub Size Param. Gen. GenetareKeyPair S 30 Chiave Priv Chiave Pub Size Param. Gen. Nome del comando Indica che al termine del comando la carta non restituisce un buffer di dati Identificativo della chiave privata Identificativo della chiave pubblica

12 Architettura MuscleCard Plug-in VerifyPIN Architettura MuscleCard Plug-in VerifyPIN Codice dell istruzione (hex) Identificativo del PIN Codice PIN da verificare VerifyPIN S 42 Num. del PIN 0x00 Size Codice PIN VerifyPIN S 42 Num. Del PIN 0x00 Size Codice PIN Nome del comando Indica che al termine del comando la carta non restituisce un buffer di dati Dimensione del campo successivo L interfaccia utente dell architettura E costituito da un API scritta in C che compie una mappatura diretta dei comandi definiti nel CSP Fornisce funzioni aggiuntive per effettuare più facilmente le operazioni più comuni della comunicazione CARD FRAMEWORK API CARD PLUG - IN ( CSP ) PC/SC Lite API PC/SC CSP Applet JavaCard 2.1 Compilant Card La libreria è stata progettata per funzionare anche in ambiente multi-applicazione Gestisce la mutua esclusione delle applicazioni sulla card e sul lettore In questo strato l ACL è definita come una serie di costanti Le costanti si utilizzano come parametro di certe funzioni che svolgono dei compiti per i quali c è bisogno di un autorizzazione Alcune costanti ACL: MSC_AUT_NONE MSC_AUT_ALL MSC_AUT_PIN_0 MSC_AUT_KEY_0 - operazione mai permessa - operazione sempre permessa - op. permessa dopo la verifica del PIN 0 - op. permessa dopo l autenticazione della KEY 0

13 #include <musclecard.h> MSCListTokens ( MSCULong32 listscope, MSCLPTokenInfo tokenarray, MSCPULong32 arraylenght Parametri listscope tokenarray arraylenght Specifica il tipo di lista che si desidera leggere Array di strutture di tipo MSCTokenInfo Numero di strutture in tokenarray MSCListTokens ritorna la lista dei token validi del sistema arraylenght è una variabile INOUT usata come IN specifica Il numero di strutture allocate dall applicazione usata come OUT restituisce il numero di strutture ritornate Se tokenarray o arraylenght sono NULL la funzione restituisce il numero delle strutture nell array Possibili valori di listscope: MSC_LIST_KNOWN MSC_LIST_ALL MSC_LIST_SLOTS MSCListTokens Lista solo i token supportati Lista tutti i token Lista tutti gli slot se non vi è inserito un token MSCListTokens Struttura MSCTokenInfo: Contiene le informazioni su un token. E usata per ricevere informazioni e per gestire la connessione MSCLPTokenInfo è un puntatore a MSCTokenInfo #include <musclecard.h> MSCEstablishConnection ( MSCLPTokenInfo tokenstruct, MSCULong32 sharingmode, MSCPUChar8 applicationname, MSCULong32 namesize, MSCLPTokenConnection pconnection Parametri tokenstruct Puntatore alla struttura ritornata dalla MSCListToken sharingmode Determina se il token deve essere condiviso applicationname Nome dell applicazione o applet ID namesize Lunghezza del nome dell applicazione pconnection Gestore della connessione MSCEstablishConnection stabilisce una connessione con un token che è stato restituito dalla MSCListTokens applicationname può essere l applet ID (AID) o il nome stesso dell applicazione namesize può essere settato a NULL indicando che si intende usare l applicazione di default

14 MSCEstablishConnection Possibili valori di sharingmode: MSC_SHARE_SHARED Permette a questo token di essere condiviso MSC_SHARE_EXCLUSIVE Permette a questo token di non essere condiviso MSC_SHARE_DIRECT Stabilisce una connessione diretta con il lettore (condivisa) MSCEstablishConnection Struttura MSCTokenConnection: è usata come gestore della connessione MSCLPTokenConnection è un puntatore a MSCTokenConnection #include <musclecard.h> MSCVerifyPIN ( MSCLPTokenConnection pconnection, MSCUChar8 pinnum, MSCPUChar8 ppincode, MSCULong32 pincodesize MSCVerifyPin Verifica un PIN per ottenere privilegi di autenticazione per compiere una determinata operazione Parametri pconnection pinnum ppincode pincodesize Gestore della connessione precedentemente aperta Identificatore del PIN Codice PIN da verificare Dimensione del codice PIN #include <musclecard.h> MSCCreateObject ( MSCLPTokenConnection pconnection, MSCString objectid, MSCULong32 objectsize, MSCLPObjectACL pobjectacl MSCCreateObject Crea un oggetto vuoto di dimensione variabile su una javacard L oggetto è identificato dalla stringa specificata dal parametro objectid Parametri pconnection objectid objectsize pobjectacl Gestore della connessione precedentemente aperta Identificatore dell oggetto Dimensione dell oggetto (in 16 bit) ACL dell oggetto Dopo la creazione è possibile accedere in lettura e/o scrittura, rispettando le costanti ACL ad esso associate

15 MSCCreateObject La struttura MSCObject specifica nei suoi campi le costanti ACL associate all oggetto per la lettura, scrittura e cancellazione MSCLPObject è un puntatore alla struttura MSCObject #include <musclecard.h> MSCWriteObject( MSCLPTokenConnection pconnection, MSCString objectid, MSCULong32 offset, MSCPUChar8 pinputdata, MSCULong32 datasize, LPRWEventCallback rwcallback, MSCPVoid32 addparams MSCWriteObject MSCWriteObject Parametri pconnection objectid offset pinputdata datasize rwcallback addparams Gestore della connessione precedentemente aperta Identificatore dell oggetto Posizione (byte)da cui iniziare a scrivere Dati da scrivere Dimensione dei dati da scrivere Funzione di callback (opzionale) Parametri della funzione di callback (opzionale) Scrive nell oggetto specificato dall ObjectID L applicazione che usa questa funzione deve essersi già autenticata precedentemente Per la gestione delle funzioni di callback fare riferimento alle specifiche MuscleCard Framework API disponibili sul sito #include <musclecard.h> MSCReadObject( MSCLPTokenConnection pconnection, MSCString objectid, MSCULong32 offset, MSCPUChar8 poutputdata, MSCULong32 datasize, LPRWEventCallback rwcallback, MSCPVoid32 addparams MSCReadObject Parametri pconnection Gestore della connessione precedentemente aperta objectid Identificatore dell oggetto offset Posizione (byte)da cui iniziare a scrivere poutputdata Dati da leggere datasize Dimensione dei dati da scrivere rwcallback Funzione di callback (opzionale) addparams Parametri della funzione di callback (opzionale)

16 MSCReadObject Legge nell oggetto specificato dall ObjectID L applicazione che usa questa funzione deve essersi già autenticata precedentemente