public interface AdministrationSession
extends javacard.framework.Shareable
Two different protocols are supported for Administration Sessions:
GlobalService
instance, if available, registered with service name
(GPSystem.FAMILY_HTTP_ADMINISTRATION
<<8|0x00)
for HTTP, and(GPSystem.FAMILY_COAP_ADMINISTRATION
<<8|0x00)
for CoAPGlobalService
,
GPSystem.getService(javacard.framework.AID, short)
Modifier and Type | Method and Description |
---|---|
void |
requestAdministrationSession(byte[] triggeringParameters,
short offset,
short length)
Triggers a new administration session.
|
void requestAdministrationSession(byte[] triggeringParameters, short offset, short length)
The Security Domain of the Application invoking this method will handle the SCP81 (PSK TLS) or SCP82 (PSK DTLS) security of the communication.
The Application invoking this method will be notified of the result of the
request if it implements the AdminSessionListener
interface.
triggeringParameters
- byte array containing administration session
triggering parameters.offset
- offset of triggering parameters within triggeringParameters
.length
- length of triggering parameters.java.lang.SecurityException
- if triggeringParameters
is not
accessible in the caller's context.java.lang.NullPointerException
- if triggeringParameters
is
null
.java.lang.ArrayIndexOutOfBoundsException
- if reading triggering parameters
would cause access of data outside array bounds.javacard.framework.ISOException
- with one of the following reason codes: SW_WRONG_DATA
if parameters are not
correctly formatted.
SW_CONDITIONS_NOT_SATISFIED
if the request could not be
processed (e.g. if no SCP session could be established).
Copyright © 2003-2024 GlobalPlatform, Inc. All rights reserved. The technology provided or described in this specification is subject to updates, revisions, and extensions by GlobalPlatform. Recipients of this document are invited to submit, with their comments, notification of any relevant patent rights or other intellectual property rights of which they may be aware which might be necessarily infringed by the implementation of the specification or other work product set forth in this document, and to provide supporting documentation.
THIS SPECIFICATION OR OTHER WORK PRODUCT IS BEING OFFERED WITHOUT ANY WARRANTY WHATSOEVER, AND IN PARTICULAR, ANY WARRANTY OF NON-INFRINGEMENT IS EXPRESSLY DISCLAIMED. ANY IMPLEMENTATION OF THIS SPECIFICATION OR OTHER WORK PRODUCT SHALL BE MADE ENTIRELY AT THE IMPLEMENTER'S OWN RISK, AND NEITHER THE COMPANY, NOR ANY OF ITS MEMBERS OR SUBMITTERS, SHALL HAVE ANY LIABILITY WHATSOEVER TO ANY IMPLEMENTER OR THIRD PARTY FOR ANY DAMAGES OF ANY NATURE WHATSOEVER DIRECTLY OR INDIRECTLY ARISING FROM THE IMPLEMENTATION OF THIS SPECIFICATION OR OTHER WORK PRODUCT.