Document toolboxDocument toolbox

API changes - Java Server

New functionality

PAdES support

The 5.2 version of BankID J Server introduces new varaiables to the BIDSessionData class. The new variables provide the possibility to specify CMS (PKCS#7) and OCSP response formats to be used during a Sign operation. The new formats are introduced to enable creation of PAdES compatible PDF Signatures, and should generally not be used in other signing scenarios. 

Authentication transactions will allways use the original default BankID formats. Any formats set in BIDSessionData will be ignored for such transactions.

The formats must be set in the session data before calling initTransaction. They will be passed along to the COI through the web client, and will also be used in BankID J Server during verifyTransactionRequest.

Details about the new enum classes and their values, and the changes to BIDSessionData, can be found in the subsequent sections.

CMSFormat (Enum)

Value

Description

PKCS7

The original default format in BankID. Not compatible with PAdES

PKCS7_ISO320001

Format conforming to ISO320001. Compatible with PAdES

OCSPFormat (Enum)

Value

Description

OCSP_BANKID_DEFAULT

The original default format in BankID. Not compatible with PAdES

OCSP_RFC6960_COMPATIBLE

Format conforming to RFC 6960. Compatible with PAdES

BIDSessionData

Variable

Type

Description

cmsFormat

CMSFormat

The CMS format to be used during a Sign operation.

Default value: CMSFormat.PKCS7

ocspFormat

OCSPFormat

The OCSP format to be used during a Sign operation.

Default value: OCSPFormat.OCSP_BANKID_DEFAULT

 

Removed functionality

Functionality related to BankID 1.0 has been discontinued. In relation to this discontinuation, the following functions have been removed in version 5.2:

  • getTag
  • getLauncherURI

Support for validating the legacy BankID SDO format has also been removed in version 5.2. This affects the method validateSDO, which from now on only supports validation of SEID SDO’s.