|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface AutCardService
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 |
---|
int getChallengeLength(KeyRef key) throws CardServiceException, CardTerminalException
key
- a reference identifying the key to be used for
internal authentication in a subsequent invocation
CardServiceException
- if this service encountered an error.
This may occur if the service needs to contact the smartcard
in order to determine the challenge length. An exception may
also be thrown if the service is unable to locate the security
domain.
CardTerminalException
- if the underlying card terminal encountered an error
when communicating with the smartcardbyte[] internalAuthenticate(KeyRef keyref, byte[] challenge) throws CardServiceException, CardTerminalException
keyref
- a reference identifying the key to be used for
internal authenticationchallenge
- the random challenge to be used by the smartcard
CardServiceException
- if this service encountered an error
CardTerminalException
- if the underlying card terminal encountered an error
when communicating with the smartcardboolean externalAuthenticate(KeyRef keyref, SignCredential credential) throws CardServiceException, 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.
CardServiceException
- if this service encountered an error. In this context, it
is not considered an error if the smartcard rejected the
authentication. However, an exception will be thrown if the
referred key on the smartcard is blocked so that authentication
using this key becomes impossible.
CardTerminalException
- if the underlying card terminal encountered an error
when communicating with the smartcardvoid closeApplication(SecurityDomain domain) throws CardServiceException, 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
authentications
CardServiceException
- if this service, or the underlying implementation,
encountered an error
CardTerminalException
- if the underlying terminal encountered an error while
communicating with the smartcardCHVCardService.closeApplication(opencard.opt.security.SecurityDomain)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |