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 enum
Kapselt die Features der Karte. -
Field Summary
FieldsModifier and TypeFieldDescription(package private) static final Charset
Der 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 int
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 int
(package private) static final byte
(package private) static final byte
(package private) static final byte
(package private) static final byte
private javax.smartcardio.Card
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected final void
check
(javax.smartcardio.ResponseAPDU response, byte[] returncodes) Prueft das Response auf die angegebenen Return-Codes.void
close()
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.Card
getCard()
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 void
init
(javax.smartcardio.Card card) Initialisiert den Service mit der angegebenen Karte.protected final byte[]
internalAuthenticate
(int keynum, byte[] challenge) protected final void
putData
(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 int
SCARD_CTL_CODE
(int code) Ermittelt den Namen der Funktion zum Abrufen der Features aus der Karte.protected final void
selectFile
(int id) protected final void
selectSubFile
(int id) protected final void
send
(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 String
toHex
(byte[] bytes) Konvertiert die Bytes in HEX-Darstellung.protected final String
Konvertiert die Bytes in HEX-Darstellung.protected final void
updateRecordBySFI
(int sfi, int idx, byte[] data) protected final void
writeRecordBySFI
(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.
-