Class Index | File Index

Classes


Namespace KJUR.asn1.cades


Defined in: asn1cades-1.0.js.

Namespace Summary
Constructor Attributes Constructor Name and Description
 
kjur's ASN.1 class for RFC 5126 CAdES long term signature

This name space provides RFC 5126 CAdES(CMS Advanced Electronic Signature) generator.

Method Summary
Method Attributes Method Name and Description
<static>  
KJUR.asn1.cades.getEncodedHex()
<static>  
KJUR.asn1.cades.getValueArray()
<static>  
KJUR.asn1.cades.setByParam(params)
<static>  
KJUR.asn1.cades.tohex()
Namespace Detail
KJUR.asn1.cades
kjur's ASN.1 class for RFC 5126 CAdES long term signature

This name space provides RFC 5126 CAdES(CMS Advanced Electronic Signature) generator.

SUPPORTED FORMATS

Following CAdES formats is supported by this library.
  • CAdES-BES - CAdES Basic Electronic Signature
  • CAdES-EPES - CAdES Explicit Policy-based Electronic Signature
  • CAdES-T - Electronic Signature with Time

PROVIDED ATTRIBUTE CLASSES

NOTE: Currntly CAdES-C is not supported since parser can't handle unsigned attribute.

OTHER CLASSES

GENERATE CAdES-BES

To generate CAdES-BES, KJUR.asn.cades namespace classes are not required and already KJUR.asn.cms namespace provides attributes for CAdES-BES. Create KJUR.asn1.cms.SignedData with following mandatory attribute in CAdES-BES: CMSUtil.newSignedData method is very useful to generate CAdES-BES.
sd = KJUR.asn1.cms.CMSUtil.newSignedData({
  content: {str: "aaa"},
  certs: [certPEM],
  signerInfos: [{
    hashAlg: 'sha256',
    sAttr: {SigningCertificateV2: {array: [certPEM]}},
    signerCert: certPEM,
    sigAlg: 'SHA256withRSA',
    signerPrvKey: pkcs8PrvKeyPEM
  }]
});
signedDataHex = sd.getContentInfoEncodedHex();
NOTE: ContentType and MessageDigest signed attributes are automatically added by default.

GENERATE CAdES-BES with multiple signers

If you need signature by multiple signers, you can specify one or more items in 'signerInfos' property as below.
sd = KJUR.asn1.cms.CMSUtil.newSignedData({
  content: {str: "aaa"},
  certs: [certPEM1, certPEM2],
  signerInfos: [{
    hashAlg: 'sha256',
    sAttr: {SigningCertificateV2: {array: [certPEM1]}},
    signerCert: certPEM1,
    sigAlg: 'SHA256withRSA',
    signerPrvKey: pkcs8PrvKeyPEM1
  },{
    hashAlg: 'sha1',
    sAttr: {SigningCertificateV2: {array: [certPEM2]}},
    signerCert: certPEM2,
    sigAlg: 'SHA1withRSA',
    signerPrvKey: pkcs8PrvKeyPEM2
  }]
});
signedDataHex = sd.getContentInfoEncodedHex();

GENERATE CAdES-EPES

When you need a CAdES-EPES signature, you just need to add 'SignaturePolicyIdentifier' attribute as below.
sd = KJUR.asn1.cms.CMSUtil.newSignedData({
  content: {str: "aaa"},
  certs: [certPEM],
  signerInfos: [{
    hashAlg: 'sha256',
    sAttr: {
      SigningCertificateV2: {array: [certPEM]},
      SignaturePolicyIdentifier: {
        oid: '1.2.3.4.5',
        hash: {alg: 'sha1', hash: 'b1b2b3b4b...'}
      },
    },
    signerCert: certPEM,
    sigAlg: 'SHA256withRSA',
    signerPrvKey: pkcs8PrvKeyPEM
  }]
});
signedDataHex = sd.getContentInfoEncodedHex();

GENERATE CAdES-T

After a signed CAdES-BES or CAdES-EPES signature have been generated, you can generate CAdES-T by adding SigningTimeStamp unsigned attribute.
beshex = "30..."; // hex of CAdES-BES or EPES data 
info = KJUR.asn1.cades.CAdESUtil.parseSignedDataForAddingUnsigned(beshex);
// You can refer a hexadecimal string of signature value 
// in the first signerInfo in the CAdES-BES/EPES with a variable:
// 'info.si[0].sigval'. You need to get RFC 3161 TimeStampToken
// from a trusted time stamp authority. Otherwise you can also 
// get it by 'KJUR.asn1.tsp' module. We suppose that we could 
// get proper time stamp.
tsthex0 = "30..."; // hex of TimeStampToken for signerInfo[0] sigval
si0 = info.obj.signerInfoList[0];
si0.addUnsigned(new KJUR.asn1.cades.SignatureTimeStamp({tst: tsthex0});
esthex = info.obj.getContentInfoEncodedHex(); // CAdES-T

SAMPLE CODES

Method Detail
<static> KJUR.asn1.cades.getEncodedHex()

<static> KJUR.asn1.cades.getValueArray()

<static> KJUR.asn1.cades.setByParam(params)
Parameters:
params

<static> KJUR.asn1.cades.tohex()

© 2012-2023 Kenji Urushima, All rights reserved
Documentation generated by JsDoc Toolkit 2.4.0