10.8.0 release

ChangeLog.txt

@@ -1,6 +1,19 @@
 
 ChangeLog for jsrsasign
 
+UserNotice of CertificatePolicies support and more
+* Changes from 10.7.0 to 10.8.0 (2023-Apr-8)
+ - x509.js
+ - X509.getUserNotice supports NoticeReference
+ - add asn1ToDisplayText method
+ - base64x.js
+ - add function msectozulu
+ - add aryval for nested JSON value access
+ - asn1.js
+ - DERInteger refactoring
+ - test/qunit-do-{asn1,asn1x509,base64x,x509-ext}.html
+ - update and add some test cases for above
+
 custom X.509 extension support and utility functions
 * Changes from 10.6.1 to 10.7.0 (2023-Mar-12)
  - x509.js

README.md

@@ -18,8 +18,22 @@ Public page is https://kjur.github.io/jsrsasign .
 
 Your bugfix and pull request contribution are always welcomed :)
 
+NOTICE FOR COMMING 11.0.0 RELEASE
+---------------------------------
+The "jsrsasign" library is a long lived JavaScript library from 2010 developed with old JavaScript style and backword compatibility. From coming release 11.0.0, following are planed and suport them gradually:
+- Stop to support Internet Explorer.
+- Stop to support bower.
+- Modern ECMA functions will be introduced such as Promise, let, Array methods or class.
+- API document generator will be changed from Jsdoc Toolkit to JSDoc3.
+- Module bandler will be used such as browserify or webpack.
+- Not to use YUI compressor.
+- Unit test framework will be changed from QUnit and mocha to jest.
+- W3C Web Crypto API support.
+- split into some modules besides jsrsasign have been all in package before 11.0.0.
+
 NEWS
 ----
+- 2023-Mar-12: [10.7.0 Release](https://github.com/kjur/jsrsasign/releases/tag/10.7.0). Now supports custom X.509 extension and custom OIDs by new "Add-on" architecture. ([See here in detail](https://github.com/kjur/jsrsasign/wiki/jsrsasign-Add-On2))
 - 2021-Nov-21: [10.5.0 Release](https://github.com/kjur/jsrsasign/releases/tag/10.5.0). Now supports secp521r1(P-521) ECDSA.
 - 2021-Apr-14: [Security advisory](https://github.com/kjur/jsrsasign/security/advisories/GHSA-27fj-mc8w-j9wg) and [update](https://github.com/kjur/jsrsasign/releases/tag/10.2.0) for CVE-2021-30246 RSA signature validation vulnerability published
 - 2020-Oct-05: jsrsasign won [Google Open Source Peer Bonus Award](https://opensource.googleblog.com/2020/10/announcing-latest-google-open-source.html). Thank you Google.
@@ -39,7 +53,8 @@ HIGHLIGHTS
 - no dependency to other library
 - no dependency to [W3C Web Cryptography API](https://www.w3.org/TR/WebCryptoAPI/) nor [OpenSSL](https://www.openssl.org/)
 - no dependency on newer ECMAScirpt function. So old browsers also supported. 
-- very popular crypto library with [1M+ npm downloads/month](https://npm-stat.com/charts.html?package=jsrsasign&from=2016-05-01&to=2022-11-18)
+- very popular crypto library with [1M+ npm downloads/month](https://npm-stat.com/charts.html?package=jsrsasign&from=2016-05-01&to=2023-04-05)
+- supports "Add-on" architecture
 
 INSTALL
 -------

api/files.html

@@ -535,7 +535,7 @@ <h2><a href="symbols/src/asn1-1.0.js.html">asn1-1.0.js</a></h2>
 
 
  <dt class="heading">Version:</dt>
- <dd>jsrsasign 10.5.22 asn1 1.0.26 (2022-May-24)</dd>
+ <dd>jsrsasign 10.8.0 asn1 1.0.27 (2023-Apr-08)</dd>
 
 
 
@@ -687,7 +687,7 @@ <h2><a href="symbols/src/base64x-1.1.js.html">base64x-1.1.js</a></h2>
 
 
  <dt class="heading">Version:</dt>
- <dd>jsrsasign 10.7.0 base64x 1.1.31 (2023-Mar-11)</dd>
+ <dd>jsrsasign 10.8.0 base64x 1.1.32 (2023-Apr-08)</dd>
 
 
 
@@ -896,7 +896,7 @@ <h2><a href="symbols/src/x509-1.1.js.html">x509-1.1.js</a></h2>
 
 
  <dt class="heading">Version:</dt>
- <dd>jsrsasign 10.7.0 x509 2.1.2 (2023-Mar-11)</dd>
+ <dd>jsrsasign 10.8.0 x509 2.1.3 (2023-Apr-08)</dd>
 
 
 

api/symbols/KJUR.asn1.DERInteger.html

@@ -789,7 +789,8 @@ <h1 class="classTitle">
 
  <pre class="code">new KJUR.asn1.DERInteger(123);
 new KJUR.asn1.DERInteger({'int': 123});
-new KJUR.asn1.DERInteger({'hex': '1fad'});</pre>
+new KJUR.asn1.DERInteger({'hex': '1fad'});
+new KJUR.asn1.DERInteger({'bigint': new BigInteger("1234", 10)});</pre>
 
 
 

api/symbols/X509.html

@@ -659,6 +659,19 @@ <h1 class="classTitle">
  </thead>
  <tbody>
 
+ <tr>
+ <td class="attributes">&nbsp;</td>
+ <td class="nameDescription">
+ <div class="fixedFont"><b><a href="../symbols/X509.html#asn1ToDisplayText">asn1ToDisplayText</a></b>(pASN1)
+ </div>
+ <div class="description">convert ASN1Object parameter to DisplayText parameter
+This method converts from KJUR.asn1.ASN1Util#newObject paramter to
+<a href="../symbols/KJUR.asn1.x509.DisplayText.html">KJUR.asn1.x509.DisplayText</a> paramter
+for <a href="https://tools.ietf.org/html/rfc5280#section-4.2.1.4">
+DisplayText</a> ASN.1 structure.</div>
+ </td>
+ </tr>
+
  <tr>
  <td class="attributes">&nbsp;</td>
  <td class="nameDescription">
@@ -1853,6 +1866,85 @@ <h1 class="classTitle">
  Method Detail
  </div>
 
+ <a name="asn1ToDisplayText"> </a>
+ <div class="fixedFont">
+
+ <span class="light">{Object}</span>
+ <b>asn1ToDisplayText</b>(pASN1)
+
+ </div>
+ <div class="description">
+ convert ASN1Object parameter to DisplayText parameter
+This method converts from KJUR.asn1.ASN1Util#newObject paramter to
+<a href="../symbols/KJUR.asn1.x509.DisplayText.html">KJUR.asn1.x509.DisplayText</a> paramter
+for <a href="https://tools.ietf.org/html/rfc5280#section-4.2.1.4">
+DisplayText</a> ASN.1 structure.
+<pre>
+DisplayText ::= CHOICE {
+ ia5String IA5String (SIZE (1..200)),
+ visibleString VisibleString (SIZE (1..200)),
+ bmpString BMPString (SIZE (1..200)),
+ utf8String UTF8String (SIZE (1..200)) } 
+</pre>
+Result of this method can be passed to 
+<a href="../symbols/KJUR.asn1.x509.DisplayText.html">KJUR.asn1.x509.DisplayText</a> constructor.
+
+
+ </div>
+
+
+
+ <pre class="code">x = new X509();
+x.asn1ToDisplayText({utf8str: {str: "aaa"}}) &rarr {type: 'utf8', str: 'aaa'}
+x.asn1ToDisplayText({bmpstr: {str: "aaa"}}) &rarr {type: 'bmp', str: 'aaa'}</pre>
+
+
+
+
+ <dl class="detailList">
+ <dt class="heading">Parameters:</dt>
+
+ <dt>
+ <span class="light fixedFont">{Object}</span> <b>pASN1</b>
+
+ </dt>
+ <dd>ASN1Object paramter for DisplayText</dd>
+
+ </dl>
+
+
+
+ <dl class="detailList">
+ <dt class="heading">Since:</dt>
+ <dd>jsrsasign 10.8.0 x509 2.1.3</dd>
+ </dl>
+ </dl>
+
+
+
+ <dl class="detailList">
+ <dt class="heading">Returns:</dt>
+
+ <dd><span class="light fixedFont">{Object}</span> DisplayText paramter</dd>
+
+ </dl>
+
+
+
+ <dl class="detailList">
+ <dt class="heading">See:</dt>
+
+ <dd><a href="../symbols/X509.html#getDisplayText">X509#getDisplayText</a></dd>
+
+ <dd><a href="../symbols/KJUR.asn1.x509.DisplayText.html">KJUR.asn1.x509.DisplayText</a></dd>
+
+ <dd>KJUR.asn1.ASN1Util#newObject</dd>
+
+ </dl>
+
+
+ <hr />
+
  <a name="c14nRDNArray"> </a>
  <div class="fixedFont">
 
@@ -6448,20 +6540,28 @@ <h1 class="classTitle">
 UserNotice ::= SEQUENCE {
  noticeRef NoticeReference OPTIONAL,
  explicitText DisplayText OPTIONAL }
+NoticeReference ::= SEQUENCE {
+ organization DisplayText,
+ noticeNumbers SEQUENCE OF INTEGER }
 </pre>
 Result of this method can be passed to 
-<a href="../symbols/KJUR.asn1.x509.NoticeReference.html">KJUR.asn1.x509.NoticeReference</a> constructor.
+<a href="../symbols/KJUR.asn1.x509.UserNotice.html">KJUR.asn1.x509.UserNotice</a> constructor.
 <br/>
-NOTE: NoticeReference parsing is currently not supported and
-it will be ignored.
+NOTE: NoticeReference supported from jsrsasign 10.8.0.
 
 
  </div>
 
 
 
  <pre class="code">x = new X509();
-x.getUserNotice("30...") &rarr; {exptext: {type: 'utf8', str: 'aaa'}}</pre>
+x.getUserNotice("30...") &rarr; { 
+ noticeref: {
+ org: {type: 'utf8', str: 'test org'},
+ noticenum: [1]
+ },
+ exptext: {type: 'utf8', str: 'test text'}
+}</pre>
 
 
 
@@ -6505,6 +6605,8 @@ <h1 class="classTitle">
 
  <dd><a href="../symbols/X509.html#getPolicyQualifierInfo">X509#getPolicyQualifierInfo</a></dd>
 
+ <dd><a href="../symbols/KJUR.asn1.x509.UserNotice.html">KJUR.asn1.x509.UserNotice</a></dd>
+
  </dl>