You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

220 lines
7.3 KiB

4 years ago
  1. Forge ChangeLog
  2. ===============
  3. ## 0.9.0 - 2019-09-04
  4. ### Added
  5. - Add ed25519.publicKeyFromAsn1 and ed25519.privateKeyFromAsn1 APIs.
  6. - A few OIDs used in EV certs.
  7. ### Fixed
  8. - Improve ed25519 NativeBuffer check.
  9. ## 0.8.5 - 2019-06-18
  10. ### Fixed
  11. - Remove use of `const`.
  12. ## 0.8.4 - 2019-05-22
  13. ### Changed
  14. - Replace all instances of Node.js `new Buffer` with `Buffer.from` and `Buffer.alloc`.
  15. ## 0.8.3 - 2019-05-15
  16. ### Fixed
  17. - Use basic character set for code.
  18. ## 0.8.2 - 2019-03-18
  19. ### Fixed
  20. - Fix tag calculation when continuing an AES-GCM block.
  21. ### Changed
  22. - Switch to eslint.
  23. ## 0.8.1 - 2019-02-23
  24. ### Fixed
  25. - Fix off-by-1 bug with kem random generation.
  26. ## 0.8.0 - 2019-01-31
  27. ### Fixed
  28. - Handle creation of certificates with `notBefore` and `notAfter` dates less
  29. than Jan 1, 1950 or greater than or equal to Jan 1, 2050.
  30. ### Added
  31. - Add OID 2.5.4.13 "description".
  32. - Add OID 2.16.840.1.113730.1.13 "nsComment".
  33. - Also handle extension when creating a certificate.
  34. - `pki.verifyCertificateChain`:
  35. - Add `validityCheckDate` option to allow checking the certificate validity
  36. period against an arbitrary `Date` or `null` for no check at all. The
  37. current date is used by default.
  38. - `tls.createConnection`:
  39. - Add `verifyOptions` option that passes through to
  40. `pki.verifyCertificateChain`. Can be used for the above `validityCheckDate`
  41. option.
  42. ### Changed
  43. - Support WebCrypto API in web workers.
  44. - `rsa.generateKeyPair`:
  45. - Use `crypto.generateKeyPair`/`crypto.generateKeyPairSync` on Node.js if
  46. available (10.12.0+) and not in pure JS mode.
  47. - Use JS fallback in `rsa.generateKeyPair` if `prng` option specified since
  48. this isn't supported by current native APIs.
  49. - Only run key generation comparison tests if keys will be deterministic.
  50. - PhantomJS is deprecated, now using Headless Chrome with Karma.
  51. - **Note**: Using Headless Chrome vs PhantomJS may cause newer JS features to
  52. slip into releases without proper support for older runtimes and browsers.
  53. Please report such issues and they will be addressed.
  54. - `pki.verifyCertificateChain`:
  55. - Signature changed to `(caStore, chain, options)`. Older `(caStore, chain,
  56. verify)` signature is still supported. New style is to to pass in a
  57. `verify` option.
  58. ## 0.7.6 - 2018-08-14
  59. ### Added
  60. - Test on Node.js 10.x.
  61. - Support for PKCS#7 detached signatures.
  62. ### Changed
  63. - Improve webpack/browser detection.
  64. ## 0.7.5 - 2018-03-30
  65. ### Fixed
  66. - Remove use of `const`.
  67. ## 0.7.4 - 2018-03-07
  68. ### Fixed
  69. - Potential regex denial of service in form.js.
  70. ### Added
  71. - Support for ED25519.
  72. - Support for baseN/base58.
  73. ## 0.7.3 - 2018-03-05
  74. - Re-publish with npm 5.6.0 due to file timestamp issues.
  75. ## 0.7.2 - 2018-02-27
  76. ### Added
  77. - Support verification of SHA-384 certificates.
  78. - `1.2.840.10040.4.3'`/`dsa-with-sha1` OID.
  79. ### Fixed
  80. - Support importing PKCS#7 data with no certificates. RFC 2315 sec 9.1 states
  81. certificates are optional.
  82. - `asn1.equals` loop bug.
  83. - Fortuna implementation bugs.
  84. ## 0.7.1 - 2017-03-27
  85. ### Fixed
  86. - Fix digestLength for hashes based on SHA-512.
  87. ## 0.7.0 - 2017-02-07
  88. ### Fixed
  89. - Fix test looping bugs so all tests are run.
  90. - Improved ASN.1 parsing. Many failure cases eliminated. More sanity checks.
  91. Better behavior in default mode of parsing BIT STRINGs. Better handling of
  92. parsed BIT STRINGs in `toDer()`. More tests.
  93. - Improve X.509 BIT STRING handling by using new capture modes.
  94. ### Changed
  95. - Major refactor to use CommonJS plus a browser build system.
  96. - Updated tests, examples, docs.
  97. - Updated dependencies.
  98. - Updated flash build system.
  99. - Improve OID mapping code.
  100. - Change test servers from Python to JavaScript.
  101. - Improve PhantomJS support.
  102. - Move Bower/bundle support to
  103. [forge-dist](https://github.com/digitalbazaar/forge-dist).
  104. - **BREAKING**: Require minimal digest algorithm dependencies from individual
  105. modules.
  106. - Enforce currently supported bit param values for byte buffer access. May be
  107. **BREAKING** for code that depended on unspecified and/or incorrect behavior.
  108. - Improve `asn1.prettyPrint()` BIT STRING display.
  109. ### Added
  110. - webpack bundler support via `npm run build`:
  111. - Builds `.js`, `.min.js`, and basic sourcemaps.
  112. - Basic build: `forge.js`.
  113. - Build with extra utils and networking support: `forge.all.js`.
  114. - Build WebWorker support: `prime.worker.js`.
  115. - Browserify support in package.json.
  116. - Karma browser testing.
  117. - `forge.options` field.
  118. - `forge.options.usePureJavaScript` flag.
  119. - `forge.util.isNodejs` flag (used to select "native" APIs).
  120. - Run PhantomJS tests in Travis-CI.
  121. - Add "Donations" section to README.
  122. - Add IRC to "Contact" section of README.
  123. - Add "Security Considerations" section to README.
  124. - Add pbkdf2 usePureJavaScript test.
  125. - Add rsa.generateKeyPair async and usePureJavaScript tests.
  126. - Add .editorconfig support.
  127. - Add `md.all.js` which includes all digest algorithms.
  128. - Add asn1 `equals()` and `copy()`.
  129. - Add asn1 `validate()` capture options for BIT STRING contents and value.
  130. ### Removed
  131. - **BREAKING**: Can no longer call `forge({...})` to create new instances.
  132. - Remove a large amount of old cruft.
  133. ### Migration from 0.6.x to 0.7.x
  134. - (all) If you used the feature to create a new forge instance with new
  135. configuration options you will need to rework your code. That ability has
  136. been removed due to implementation complexity. The main rare use was to set
  137. the option to use pure JavaScript. That is now available as a library global
  138. flag `forge.options.usePureJavaScript`.
  139. - (npm,bower) If you used the default main file there is little to nothing to
  140. change.
  141. - (npm) If you accessed a sub-resource like `forge/js/pki` you should either
  142. switch to just using the main `forge` and access `forge.pki` or update to
  143. `forge/lib/pki`.
  144. - (bower) If you used a sub-resource like `forge/js/pki` you should switch to
  145. just using `forge` and access `forge.pki`. The bower release bundles
  146. everything in one minified file.
  147. - (bower) A configured workerScript like
  148. `/bower_components/forge/js/prime.worker.js` will need to change to
  149. `/bower_components/forge/dist/prime.worker.min.js`.
  150. - (all) If you used the networking support or flash socket support, you will
  151. need to use a custom build and/or adjust where files are loaded from. This
  152. functionality is not included in the bower distribution by default and is
  153. also now in a different directory.
  154. - (all) The library should now directly support building custom bundles with
  155. webpack, browserify, or similar.
  156. - (all) If building a custom bundle ensure the correct dependencies are
  157. included. In particular, note there is now a `md.all.js` file to include all
  158. digest algorithms. Individual files limit what they include by default to
  159. allow smaller custom builds. For instance, `pbdkf2.js` has a `sha1` default
  160. but does not include any algorithm files by default. This allows the
  161. possibility to include only `sha256` without the overhead of `sha1` and
  162. `sha512`.
  163. ### Notes
  164. - This major update requires updating the version to 0.7.x. The existing
  165. work-in-progress "0.7.x" branch will be painfully rebased on top of this new
  166. 0.7.x and moved forward to 0.8.x or later as needed.
  167. - 0.7.x is a start of simplifying forge based on common issues and what has
  168. appeared to be the most common usage. Please file issues with feedback if the
  169. changes are problematic for your use cases.
  170. ## 0.6.x - 2016 and earlier
  171. - See Git commit log or https://github.com/digitalbazaar/forge.