|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Method Summary | |
void |
closeApplication(SecurityDomain domain)
Resets the achieved external authentications on the smartcard. |
boolean |
externalAuthenticate(KeyRef keyref,
SignCredential credential)
Performs an external authentication against the smartcard. |
int |
getChallengeLength(KeyRef key)
Determines the required length of a challenge for internal authentication. |
byte[] |
internalAuthenticate(KeyRef keyref,
byte[] challenge)
Requests an internal authentication from the smartcard. |
Methods inherited from interface opencard.opt.service.CardServiceInterface |
getCard,
setCHVDialog |
Method Detail |
public int getChallengeLength(KeyRef key) throws opencard.core.service.CardServiceException, opencard.core.terminal.CardTerminalException
keyref
- a reference identifying the key to be used for
internal authentication in a subsequent invocationpublic byte[] internalAuthenticate(KeyRef keyref, byte[] challenge) throws opencard.core.service.CardServiceException, opencard.core.terminal.CardTerminalException
keyref
- a reference identifying the key to be used for
internal authenticationchallenge
- the random challenge to be used by the smartcardpublic boolean externalAuthenticate(KeyRef keyref, SignCredential credential) throws opencard.core.service.CardServiceException, opencard.core.terminal.CardTerminalException
keyref
- a reference identifying the key to be used for
external authenticationcredential
- the secret to be used to authenticate the application
against the smartcard. The secret will be used only
once, and before this method returns. The application
may take actions to ensure that the secret cannot be
used arbitrarily often, or after this method returned.public void closeApplication(SecurityDomain domain) throws opencard.core.service.CardServiceException, opencard.core.terminal.CardTerminalException
The name of this method implies that an application on the smartcard is first selected and then opened by performing external authentication, giving access to the application data. By resetting the external authentication, the on-card application therefore gets closed.
External authentication as well as Card Holder Verification (CHV) can be required to satisfy access conditions that are imposed by the card. The operation expected to be performed when invoking this method is to reset the state in the smartcard so that these access conditions are no longer satisfied. This avoids that another terminal or host application accesses the smartcard's data without proving it's authorization first. The signature of the method here is the same as in the interface CHVCardService, since both are expected to do the same thing.
domain
- the security domain for which to reset external
authenticationsCHVCardService.closeApplication(opencard.opt.security.SecurityDomain)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |