Package org.kapott.hbci.smartcardio
Class SmartCardService
java.lang.Object
org.kapott.hbci.smartcardio.SmartCardService
- Direct Known Subclasses:
ChipTanCardService,HBCICardService
Smartcard-Service fuer den DDVPCSC-Passport, basierend auf dem OCF-Code
aus HBCI4Java 2.5.8.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionprotected static enumKapselt die Features der Karte. -
Field Summary
FieldsModifier and TypeFieldDescription(package private) static final CharsetDer Zeichensatz.private Map<SmartCardService.Feature, Integer> (package private) static final int(package private) static final int(package private) static final int(package private) static final intprivate static final int(package private) static final int(package private) static final int(package private) static final int(package private) static final int(package private) static final int(package private) static final int(package private) static final int(package private) static final int(package private) static final int(package private) static final int(package private) static final int(package private) static final int(package private) static final int(package private) static final int(package private) static final int(package private) static final int(package private) static final int(package private) static final byte(package private) static final byte(package private) static final byte(package private) static final byteprivate javax.smartcardio.Card -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected final voidcheck(javax.smartcardio.ResponseAPDU response, byte[] returncodes) Prueft das Response auf die angegebenen Return-Codes.voidclose()Schliesst die Karte und resettet den Service.static <T extends SmartCardService>
TcreateInstance(Class<? extends SmartCardService> type, String name) Erzeut eine neue Instanz des Card-Service fuer die angegebene Karte.protected final byte[]Fuellt den String rechtsbuendig mit Leerzeichen auf die angegebene Laenge.protected final javax.smartcardio.CardgetCard()Liefert die Instanz der Smartcard.protected final byte[]protected final Map<SmartCardService.Feature, Integer> Liefert die Map mit den verfuegbaren Features.protected final byte[]getKeyInfo(int idx) protected voidinit(javax.smartcardio.Card card) Initialisiert den Service mit der angegebenen Karte.protected final byte[]internalAuthenticate(int keynum, byte[] challenge) protected final voidputData(int tag, byte[] data) protected byte[]readBinary(int offset, int length) protected final byte[]readRecordBySFI(int sfi, int idx) protected final byte[]receive(javax.smartcardio.CommandAPDU command) Sendet ein Kommando an den Kartenleser, prueft ob es erfolgreich ausgefuehrt wurde und liefert die Antwort zurueck.protected byte[]receive(javax.smartcardio.CommandAPDU command, byte[] returncodes) Sendet ein Kommando an den Kartenleser, prueft ob es erfolgreich ausgefuehrt wurde und liefert die Antwort zurueck.private static intSCARD_CTL_CODE(int code) Ermittelt den Namen der Funktion zum Abrufen der Features aus der Karte.protected final voidselectFile(int id) protected final voidselectSubFile(int id) protected final voidsend(javax.smartcardio.CommandAPDU command) Sendet ein Kommando an den Kartenleser und prueft, ob es erfolgreich ausgefuehrt wurde.byte[]Konvertiert den HEX-String zurueck in ein Byte-Array.protected final StringtoHex(byte[] bytes) Konvertiert die Bytes in HEX-Darstellung.protected final StringKonvertiert die Bytes in HEX-Darstellung.protected final voidupdateRecordBySFI(int sfi, int idx, byte[] data) protected final voidwriteRecordBySFI(int sfi, int idx, byte[] data)
-
Field Details
-
CHARSET
Der Zeichensatz. -
statusCodes
-
HBCI_DDV_EF_ID
static final int HBCI_DDV_EF_ID- See Also:
-
HBCI_DDV_EF_BNK
static final int HBCI_DDV_EF_BNK- See Also:
-
HBCI_DDV_EF_MAC
static final int HBCI_DDV_EF_MAC- See Also:
-
HBCI_DDV_EF_SEQ
static final int HBCI_DDV_EF_SEQ- See Also:
-
SECCOS_SELECT_RET_NOTHING
static final int SECCOS_SELECT_RET_NOTHING- See Also:
-
SECCOS_CLA_EXT
static final int SECCOS_CLA_EXT- See Also:
-
SECCOS_CLA_SM_PROPR
static final int SECCOS_CLA_SM_PROPR- See Also:
-
SECCOS_CLA_SM1
static final int SECCOS_CLA_SM1- See Also:
-
SECCOS_CLA_STD
static final int SECCOS_CLA_STD- See Also:
-
SECCOS_INS_GET_CHALLENGE
static final int SECCOS_INS_GET_CHALLENGE- See Also:
-
SECCOS_INS_GET_KEYINFO
static final int SECCOS_INS_GET_KEYINFO- See Also:
-
SECCOS_INS_INT_AUTH
static final int SECCOS_INS_INT_AUTH- See Also:
-
SECCOS_INS_PUT_DATA
static final int SECCOS_INS_PUT_DATA- See Also:
-
SECCOS_INS_READ_BINARY
static final int SECCOS_INS_READ_BINARY- See Also:
-
SECCOS_INS_READ_RECORD
static final int SECCOS_INS_READ_RECORD- See Also:
-
SECCOS_INS_SELECT_FILE
static final int SECCOS_INS_SELECT_FILE- See Also:
-
SECCOS_INS_VERIFY
static final int SECCOS_INS_VERIFY- See Also:
-
SECCOS_INS_UPDATE_RECORD
static final int SECCOS_INS_UPDATE_RECORD- See Also:
-
SECCOS_INS_WRITE_RECORD
static final int SECCOS_INS_WRITE_RECORD- See Also:
-
SECCOS_KEY_TYPE_DF
static final int SECCOS_KEY_TYPE_DF- See Also:
-
SECCOS_PWD_TYPE_DF
static final int SECCOS_PWD_TYPE_DF- See Also:
-
SECCOS_SM_CRT_CC
static final byte SECCOS_SM_CRT_CC- See Also:
-
SECCOS_SM_REF_INIT_DATA
static final byte SECCOS_SM_REF_INIT_DATA- See Also:
-
SECCOS_SM_RESP_DESCR
static final byte SECCOS_SM_RESP_DESCR- See Also:
-
SECCOS_SM_VALUE_LE
static final byte SECCOS_SM_VALUE_LE- See Also:
-
IOCTL_GET_FEATURE_REQUEST
private static final int IOCTL_GET_FEATURE_REQUEST -
features
-
smartCard
private javax.smartcardio.Card smartCard
-
-
Constructor Details
-
SmartCardService
public SmartCardService()
-
-
Method Details
-
createInstance
public static <T extends SmartCardService> T createInstance(Class<? extends SmartCardService> type, String name) Erzeut eine neue Instanz des Card-Service fuer die angegebene Karte.- Parameters:
type- der Typ des zu erzeugenden Service.name- optionale Angabe des Kartenlesernamens - noetig, wenn am Rechner mehrere Kartenleser angeschlossen sind.- Returns:
- die neue Instanz des Card-Service.
-
SCARD_CTL_CODE
private static int SCARD_CTL_CODE(int code) Ermittelt den Namen der Funktion zum Abrufen der Features aus der Karte.- Parameters:
code- der Code.- Returns:
- der Funktions-Code.
-
close
public void close()Schliesst die Karte und resettet den Service. -
init
protected void init(javax.smartcardio.Card card) Initialisiert den Service mit der angegebenen Karte.- Parameters:
card- die Karte.
-
getFeatures
Liefert die Map mit den verfuegbaren Features.- Returns:
- die Map mit den verfuegbaren Features.
-
getCard
protected final javax.smartcardio.Card getCard()Liefert die Instanz der Smartcard.- Returns:
- die Instanz der Smartcard.
-
writeRecordBySFI
protected final void writeRecordBySFI(int sfi, int idx, byte[] data) - Parameters:
sfi-idx-data-
-
updateRecordBySFI
protected final void updateRecordBySFI(int sfi, int idx, byte[] data) - Parameters:
sfi-idx-data-
-
readRecordBySFI
protected final byte[] readRecordBySFI(int sfi, int idx) - Parameters:
sfi-idx-- Returns:
-
readBinary
protected byte[] readBinary(int offset, int length) - Parameters:
offset-length-- Returns:
-
selectFile
protected final void selectFile(int id) - Parameters:
id-
-
selectSubFile
protected final void selectSubFile(int id) - Parameters:
id-
-
getKeyInfo
protected final byte[] getKeyInfo(int idx) - Parameters:
idx-- Returns:
-
putData
protected final void putData(int tag, byte[] data) - Parameters:
tag-data-
-
getChallenge
protected final byte[] getChallenge()- Returns:
-
internalAuthenticate
protected final byte[] internalAuthenticate(int keynum, byte[] challenge) - Parameters:
keynum-challenge-- Returns:
-
send
protected final void send(javax.smartcardio.CommandAPDU command) Sendet ein Kommando an den Kartenleser und prueft, ob es erfolgreich ausgefuehrt wurde.- Parameters:
command- das Kommando.
-
receive
protected final byte[] receive(javax.smartcardio.CommandAPDU command) Sendet ein Kommando an den Kartenleser, prueft ob es erfolgreich ausgefuehrt wurde und liefert die Antwort zurueck.- Parameters:
command- das Kommando.- Returns:
- die Antwort.
-
receive
protected byte[] receive(javax.smartcardio.CommandAPDU command, byte[] returncodes) Sendet ein Kommando an den Kartenleser, prueft ob es erfolgreich ausgefuehrt wurde und liefert die Antwort zurueck.- Parameters:
command- das Kommando.returncodes- zulaessige Return-Codes.- Returns:
- die Antwort.
-
check
protected final void check(javax.smartcardio.ResponseAPDU response, byte[] returncodes) Prueft das Response auf die angegebenen Return-Codes.- Parameters:
response- das Response.returncodes- zulaessige Return-Codes.
-
toHex
Konvertiert die Bytes in HEX-Darstellung.- Parameters:
bytes-- Returns:
- String-Repraesentation.
-
toHex
Konvertiert die Bytes in HEX-Darstellung.- Parameters:
bytes-sep- Separator-Zeichen.- Returns:
- String-Repraesentation.
-
toBytes
Konvertiert den HEX-String zurueck in ein Byte-Array.- Parameters:
hex- der Text in HEX-Schreibweise.- Returns:
- das Byte-Array.
-
expand
Fuellt den String rechtsbuendig mit Leerzeichen auf die angegebene Laenge.- Parameters:
st- der String.len- die Gesamtlaenge.- Returns:
- der codierte String mit Leerzeichen auf der rechten Seite.
-