org.globalplatform
Interface HTTPAdministration

All Superinterfaces:
javacard.framework.Shareable

public interface HTTPAdministration
extends javacard.framework.Shareable

This interface defines a method to trigger a new HTTP administration session.

To retrieve an instance of this interface, an Application shall use the GlobalService instance, if available, registered with a service name of (GPSystem.FAMILY_HTTP_ADMINISTRATION<<8|0x00).

Since:
See Also:
GlobalService, GPSystem.getService(javacard.framework.AID, short)

Method Summary
 void requestHTTPAdministrationSession(byte[] triggeringParameters, short offset, short length)
          Triggers a new administration session.
 

Method Detail

requestHTTPAdministrationSession

void requestHTTPAdministrationSession(byte[] triggeringParameters,
                                      short offset,
                                      short length)
Triggers a new administration session.

The Security Domain of the Application invoking this method will handle the SCP81 (PSK TLS) security of the communication.

The Application invoking this method will be notified of the result of the request if it implements the HTTPReportListener interface.

Parameters:
triggeringParameters - byte array containing administration session triggering parameters.
offset - offset of triggering parameters within triggeringParameters.
length - length of triggering parameters.
Throws:
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 command 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 SCP81 session could be established).


Copyright © 2003-2014 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.