All notable changes to this add-on will be documented in this file.
The format is based on Keep a Changelog.
- Correct definition detection while spidering.
- Clarified an error message which occurs in automation if there's a problem importing.
44 - 2025-01-09
- Update minimum ZAP version to 2.16.0.
- Depend on newer version of Common Library add-on (Issue 8016).
- Fields with default or missing values are omitted for the
openapi
job in saved Automation Framework plans.
43 - 2024-09-23
- Allow to import the OpenAPI definitions with a user (Issue 7739).
- Honour context exclusions when importing (Issue 8021).
- Allow to select the contexts of the Automation Framework plan when configuring the job.
- Correctly handle empty context name in the Automation Framework job.
42 - 2024-07-04
- Workaround issue loading fully resolved definitions that are too large by trying to use the original definition only (Issue 8193).
41 - 2024-05-10
- Rely on Common Library add-on for use of Jackson library.
40 - 2024-05-07
- Update minimum ZAP version to 2.15.0.
- Maintenance changes.
- Dependency updates.
39 - 2024-01-26
- Video link in help for Automation Framework job.
- Dependency updates.
38 - 2023-10-23
- Dependency updates.
- An issue in the headers generator which might lead to content-type header being incorrectly set.
37 - 2023-10-12
- Update minimum ZAP version to 2.14.0.
36 - 2023-09-07
- Dependency updates.
- The "Import an OpenAPI definition from the local file system" and "Import an OpenAPI definition from a URL" menu items were merged into one, "Import an OpenAPI Definition".
- Depend on newer versions of Automation Framework and Common Library add-ons (Related to Issue 7961).
- Use Common Library add-on to obtain the Value Generator (Issue 8016).
- Importing empty or invalid OpenAPI definitions failed silently in some cases (Issue 7949).
35 - 2023-07-11
- Update minimum ZAP version to 2.13.0.
- Dependency updates.
34 - 2023-06-27
- Dependency updates.
- Fix exception when generating data for parameters without schema.
- An exception which might occur on large definition imports (Issue 7876).
33 - 2023-04-04
- Dependency updates.
- Fix null pointer exception when importing a definition with requestBody content set as an empty dictionary (Issue 7808).
32 - 2023-02-09
- Support for relative file paths and ones including vars in the Automation Framework job.
- Maintenance changes.
31 - 2023-01-03
- Maintenance changes.
- When a definition doesn't define a response then an appropriate warning bubbles up, no longer resulting in a NullPointerException (Issue 7115).
30 - 2022-11-15
- Dependency updates.
- Each imported endpoint is included in the selected context, unless its URL matches an already existing Include in Context regex entry.
29 - 2022-10-27
- Update minimum ZAP version to 2.12.0.
- Remove parser used for core spider (Related to Issue 3113).
- Maintenance changes.
28 - 2022-09-21
- Imported specs are now persisted to the session database. They are used by the new variant to mark path parameters as Data Driven Nodes.
- JSON body examples specified under
schema
were being enclosed in quotes. - Error message when
apiFile
field is not accessible was outputting thetargetUrl
and not the incorrect filename (Issue 7370).
- Maintenance changes.
- Use Spider add-on (Issue 3113).
- Use Form Handler add-on directly.
- DDNs added as Structural Modifiers have been superseded by a custom variant. The variant supports nested DDNs and leaf DDNs, prevents non-parameter URL paths from being merged with DDNs, and treats paths with different HTTP methods uniquely. DDNs are named with the parameter name from the spec.
27 - 2022-03-29
- Support content field (JSON) in parameters (Issue 6166).
- Now depends on commonlib for display of import progress (Issue 6783).
- Dependency updates.
- Properly generate Content-Type header when in presence of more than one supported content (Issue 7082).
- Quote provided string values in JSON content (Issue 7128).
- Properly handle empty default values in server variables.
26 - 2022-02-01
- Do not report "Unrecognised parameter" for valid parameters.
25 - 2022-01-18
- Update minimum ZAP version to 2.11.1.
- Dependency updates.
- When the automation Job is edited via UI Dialog then the status will be set to Not started
- Parameter examples specified as part of the schema were not being used.
24 - 2021-12-06
- Use examples defined in parameters (Issue #6870).
- Tweak error message shown when content type is not supported.
- Dependency updates.
- Fixed ClassCastException when using nested map properties with mixed definition styles.
23 - 2021-10-06
- Fixed StackOverflow in the Body/DataGenerator when an invalid property type is specified. (Issue #6591)
- Use path and operation servers (Issue #6754).
- Warn when request has content type
application/xml
, not supported (Related to Issue #6767). - Maintenance changes.
- Update minimum ZAP version to 2.11.0.
22 - 2021-09-16
- Maintenance changes.
21 - 2021-09-01
- The import progress is now displayed using a Progress Panel.
- Fixed var support in URLs (Issue #6726)
- Import file definition even if it has issues (Issue #6758).
- Use
application/json
media type examples when available.
20 - 2021-08-05
- Automation Framework GUI
- Maintenance changes.
- Fix RequestMethod enum name for OPTIONS (Issue 6666)
19 - 2021-06-29
- Added support for Multipart form-data (Issue 6418).
- Always use enum values when defined (Issue 6489).
- Now using 2.10 logging infrastructure (Log4j 2.x).
- Automation parameters are now in camelCase. This is a breaking change, and older automation configurations containing all-lowercase openapi parameters will stop working.
- The import dialogs now show the values used in the previous import when reopened.
- Maintenance changes.
- NPE if form has no schema element.
18 - 2021-03-09
- Support for the Automation Framework
- Support for statistics (number of URLs added)
- Maintenance changes.
17 - 2020-12-15
- Handle cookie parameters (Issue 6045).
- Use default values in
x-www-form-urlencoded
andjson
bodies (Issue 6095).
- Show import exceptions in the Output tab (Issue 6042).
- Maintenance changes.
- Update minimum ZAP version to 2.10.0.
- Add imported messages synchronously to the Sites tree (Issue 5936).
- Correct parent dialogue when choosing the file to import (Issue 6041).
- Properly handle no schema when generating the request body (Issue 6042).
- Return API error
illegal_parameter
(instead ofinternal_error
) when unable to get the OpenAPI definition from the provided URL.
16 - 2020-06-09
- Map Structure support for OpenAPI v3.0 (Issue 5863).
- Using OpenAPI Example values for value generation in request bodies and urls (Issue 5168).
- Improve content checks when spidering for specifications (Issue 5725).
- Update minimum ZAP version to 2.9.0.
- Maintenance changes.
- Notify all redirects followed for proper passive scanning.
15 - 2020-01-17
- Add info and repo URLs.
- Promote addon to Beta.
14 - 2019-12-02
- Support OpenAPI v3.0 (Issue 4549).
- Allow to specify the target URL (scheme, authority, and path) when importing through the command line.
- Do not consume spider resource if not parsed as OpenAPI definition.
- Allow to specify the target URL when importing from file through the API and GUI.
- Allow to override also the scheme and path when importing from URL through the API.
13 - 2019-07-18
- Added Accept header for importing an OpenAPI definition from an URL, in the proper format.
- Correct import of v1.2 definitions (Issue 5262).
- Fix exception when reporting errors.
- Update minimum ZAP version to 2.8.0.
- Add import menu to (new) top level Import menu instead of Tools menu.
- Add support for primitive values (standalone and within arrays) in a request body (Issue 5250).
- Ignore BOM when parsing and don't rely on default character encoding (Issue 4676).
- Include exception message in warning dialog when a parse error occurs (Issue 4667).
- Open previously chosen directory when importing local file.
- Fallback to host of request URI (Issue 4271).
- Update Swagger/OpenAPI parser (Issue 3479).
- Fix exception with ref parameters.
- Fix NPE in BodyGenerator.
- Fix NPEs when a parameter is null.
- Correct validations when importing a file through the API.
- Support optional host override.
- Detect and warn on potential loops.
- Allow add-on to be unloaded dynamically.
- Support user specified values when importing (Issue 3344).
- Support older swagger formats (Issue 3598).
- Run synchronously and return any warnings when importing via API or cmdline.
- Fallback to scheme of request URI (Issue 3433).
- Added cmdline support.
- Configure Swagger library logging.
- First Version