10.8.0 release

kjur · Apr 8, 2023 · 19608d2 · 19608d2
1 parent 574e9ad
commit 19608d2
Show file tree

Hide file tree

Showing 29 changed files with 4,841 additions and 4,010 deletions.
diff --git a/ChangeLog.txt b/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

diff --git a/README.md b/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
 -------

diff --git a/api/files.html b/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>
 
 
 

diff --git a/api/symbols/KJUR.asn1.DERInteger.html b/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>
 
 
 

diff --git a/api/symbols/X509.html b/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>