8.0.21 release

ChangeLog.txt

@@ -1,6 +1,60 @@
 
 ChangeLog for jsrsasign
 
+Donation program started, more RSA-PSS support and add ASN1HEX.get{Idx,TLV,V}byListEx
+* Changes from 8.0.20 to 8.0.21 (2020-Aug-01)
+  - *donation program* have been started.
+    Please consider donation to sustain this project
+    https://github.com/kjur/jsrsasign#donations    
+  - RSA-PSS support in AlgorithmIdentifier, Signature, 
+    X509 and newCertPEM
+  - new method to access ASN.1 decendant object 
+    ASN1HEX.get{Idx,TLV,V}byListEx added
+    Its tutorial page will be provided by following URL near in future
+    https://github.com/kjur/jsrsasign/wiki/Tutorial-for-accessing-deep-inside-of-ASN.1-structure-by-using-new-ASN1HEX.getIdxbyListEx
+  - src/x509.js
+    - update getSignatureAlgorithmField to support
+      RSA-PSS(SHA{,256,384,512}withRSAandMGF1) algorithms
+    - update verifySignature to support
+      RSA-PSS(SHA{,256,384,512}withRSAandMGF1) algorithms
+  - src/crypto.js
+    - Signature class
+      - SHAwithRSAandMGF1 supported (the same as SHA1withRSAandMGF1)
+  - src/asn1hex.js
+    - ASN1HEX.getIdxbyList
+    - add get{Idx,TLV,V}byListEx for context specific tag
+    - add ASN1HEX.isContextTag to check context
+      specific tag
+    - get{Idx,TLV,V} will be deprecated near in the future version
+      Please consider to move get{Idx,TLV,V}byListEx.
+  - src/{asn1csr,dsa,rsapem,ecdsa-modified}.js
+    - replace to use get{Idx,TLV,V}byListEx
+  - test/qunit-do-asn1x509.html
+    - add Certificate class test for RSA-PSS
+    - add TBSCertificate class test for RSA-PSS
+    - add AlgorithmIdentifier class test for
+      SHA{,256,384,512}withRSAandMGF1
+  - test/qunit-do-crypto-pss.html
+    - add Signature class test for 
+      SHAwithRSAandMGF1.
+  - test/qunit-do-asn1x509-newcrt.html
+    - add newCertPEM test for RSA-PSS
+  - test/qunit-do-x509.html
+    - add getSignatureAlgorithmField test for
+      SHA{,256,384,512}withRSAandMGF1
+  - sample_node/asn1extract2
+    - bug fix for -v(--vonly) option
+
+asn1cades
+asn1cms
+asn1ocsp 一部
+asn1tsp
+keyutil
+x509
+
+  - test/qunit-do-asn1hex.html
+    - add test for ASN1HEX.isContextTag
+
 add CSR support for subjectAltName
 * Changes From 8.0.19 to 8.0.20
   - src/asn1csr.js

README.md

@@ -6,13 +6,59 @@ jsrsasign
 [![npm version](https://badge.fury.io/js/jsrsasign.svg)](https://badge.fury.io/js/jsrsasign)
 [![npm downloads](https://img.shields.io/npm/dm/jsrsasign.svg)](https://www.npmjs.com/package/jsrsasign)
 [![CDNJS](https://img.shields.io/cdnjs/v/jsrsasign.svg)](https://cdnjs.com/libraries/jsrsasign)
+[![githubsponsors](https://img.shields.io/badge/github-donate-yellow.svg)](https://github.com/sponsors/kjur)
+[![cryptocurrency](https://img.shields.io/badge/crypto-donate-yellow.svg)](https://github.com/kjur/jsrsasign#cryptocurrency)
 
 The 'jsrsasign' (RSA-Sign JavaScript Library) is an opensource free cryptography library supporting RSA/RSAPSS/ECDSA/DSA signing/validation, ASN.1, PKCS#1/5/8 private/public key, X.509 certificate, CRL, OCSP, CMS SignedData, TimeStamp, CAdES JSON Web Signature/Token/Key in pure JavaScript.
 
 Public page is https://kjur.github.io/jsrsasign .
 
 Your bugfix and pull request contribution are always welcomed :)
 
+HIGHLIGHTS
+----------
+- Swiss Army Knife style all in one package crypto and PKI library
+- available on Node and browsers
+- very easy API to use
+- powerful various format key loader and ASN.1 API
+- rich document and samples
+- no dependency to other library
+- no dependency to W3C Web Crypto API nor OpenSSL
+- very popular crypto library with 6M+ npm downloads/month
+
+INSTALL
+-------
+### Node NPM
+    > npm install jsrsasign jsrsasign-util
+### Bower
+    > bower install jsrsasign
+### Or include in HTML from many CDN sites
+    > <script src="https://cdnjs.cloudflare.com/ajax/libs/jsrsasign/8.0.20/jsrsasign-all-min.js"></script>
+
+USAGE
+-----
+
+Loading encrypted PKCS#5 private key:
+
+    > var rs = require('jsrsasign');
+    > var rsu = require('jsrsasign-util');
+    > var pem = rsu.readFile('z1.prv.p5e.pem');
+    > var prvKey = rs.KEYUTIL.getKey(pem, 'passwd');
+
+Sign string 'aaa' with the loaded private key:
+
+    > var sig = new a.Signature({alg: 'SHA1withRSA'});
+    > sig.init(prvKey);
+    > sig.updateString('aaa');
+    > var sigVal = sig.sign();
+    > sigVal
+    'd764dcacb...'
+
+MORE TUTORIALS AND SAMPLES
+--------------------------
+- [Tutorials in GitHub Wiki](https://github.com/kjur/jsrsasign/wiki)
+- [Sample Node Scripts](https://github.com/kjur/jsrsasign/tree/master/sample_node)
+
 ## RECENT SECURITY ADVISORY
 
 |published|fixed version|title/advisory|CVE|CVSS|

api/files.html

@@ -500,7 +500,7 @@ <h2><a href="symbols/src/asn1csr-1.0.js.html">asn1csr-1.0.js</a></h2>
 
 
 						<dt class="heading">Version:</dt>
-							<dd>jsrsasign 8.0.20 asn1csr 1.0.7 (2020-Jun-24)</dd>
+							<dd>jsrsasign 8.0.21 asn1csr 1.0.8 (2020-Jul-24)</dd>
 
 
 
@@ -538,7 +538,7 @@ <h2><a href="symbols/src/asn1ocsp-1.0.js.html">asn1ocsp-1.0.js</a></h2>
 
 
 						<dt class="heading">Version:</dt>
-							<dd>jsrsasign 7.2.1 asn1ocsp 1.0.3 (2017-Jun-03)</dd>
+							<dd>jsrsasign 8.0.21 asn1ocsp 1.0.4 (2020-Jul-24)</dd>
 
 
 
@@ -576,7 +576,7 @@ <h2><a href="symbols/src/asn1x509-1.0.js.html">asn1x509-1.0.js</a></h2>
 
 
 						<dt class="heading">Version:</dt>
-							<dd>jsrsasign 8.0.19 asn1x509 1.1.10 (2020-Jun-22)</dd>
+							<dd>jsrsasign 8.0.21 asn1x509 1.1.11 (2020-Jul-28)</dd>
 
 
 
@@ -614,7 +614,7 @@ <h2><a href="symbols/src/crypto-1.1.js.html">crypto-1.1.js</a></h2>
 
 
 						<dt class="heading">Version:</dt>
-							<dd>1.2.3 (2020-May-28)</dd>
+							<dd>1.2.4 (2020-Jul-28)</dd>
 
 
 
@@ -633,7 +633,7 @@ <h2><a href="symbols/src/dsa-2.0.js.html">dsa-2.0.js</a></h2>
 
 
 						<dt class="heading">Version:</dt>
-							<dd>jsrsasign 7.2.0 dsa 2.1.1 (2017-May-11)</dd>
+							<dd>jsrsasign 8.0.21 dsa 2.1.2 (2020-Jul-24)</dd>
 
 
 
@@ -652,7 +652,7 @@ <h2><a href="symbols/src/ecdsa-modified-1.0.js.html">ecdsa-modified-1.0.js</a></
 
 
 						<dt class="heading">Version:</dt>
-							<dd>jsrsasign 8.0.20 ecdsa-modified 1.1.3 (2020-Jun-22)</dd>
+							<dd>jsrsasign 8.0.21 ecdsa-modified 1.1.4 (2020-Jul-24)</dd>
 
 
 
@@ -766,7 +766,7 @@ <h2><a href="symbols/src/rsapem-1.1.js.html">rsapem-1.1.js</a></h2>
 
 
 						<dt class="heading">Version:</dt>
-							<dd>jsrsasign 8.0.0 rsapem 1.3.0 (2017-Jun-24)</dd>
+							<dd>jsrsasign 8.0.21 rsapem 1.3.1 (2020-Jul-24)</dd>
 
 
 
@@ -804,7 +804,7 @@ <h2><a href="symbols/src/x509-1.1.js.html">x509-1.1.js</a></h2>
 
 
 						<dt class="heading">Version:</dt>
-							<dd>jsrsasign 8.0.19 x509 1.1.21 (2020-Jun-21)</dd>
+							<dd>jsrsasign 8.0.19 x509 1.1.22 (2020-Jul-29)</dd>