9bbd62a5b6
* Refactors sending IPP request and handling errors thereof into sendIPPRequest() * Adds dependency of IPP zgrab2 schema on HTTP zgrab2 schema. * Refactors out trying to grab with multiple versions into re-usable function. * Determines whether to output nil result in a concise and accurate manner. * Refactors reading attributes present in IPP response to its own function. Calls that in Grab and augmentWithCUPSData. Formats code using Go fmt. * Rejects successful non-IPP responses with protocol error. Reports HTTP errors. * Removes circular dependency upon http zgrab2 schema. * Changes name of objects to make IPP schema actually work. |
||
|---|---|---|
| .. | ||
| zgrab2 | ||
| __init__.py | ||
| README.md | ||
ZGrab 2.0 schemas for zschema
Validating
integration_tests.sh automatically validates output from the integration tests; to manually validate a zgrab2 result, you can follow these steps:
- Get zschema (e.g.
git clone https://github.com/zmap/zschema) - Run the zschema validator:
- Run the zschema module's main function
- Pass it the
validatecommand - Give the path to the zgrab2 schema
schemas/__init__.py:zgrab2 - Pass in the zgrab2 JSON file to validate
-
echo 127.0.0.1 | ./cmd/zgrab2/zgrab2 mysql > output.json PYTHONPATH=/path/to/zschema python -m zschema validate schemas/__init__.py:zgrab2 output.json
Adding new module schemas
There are two steps to adding a new zgrab2 module schema:
- Add the module a. Register the response type with the zgrab2 schema
- Register the module in
__init__.py
Add the module
Create your python file; if your protocol identifier (the default name
in the result table) is my_protocol, name the file my_protocol.py
(this allows a static schema validation from protocol_name to protocol_schema;
unfortunately, this means that multiple scans on a single host, or scans
using custom identifiers, will not validate).
Your module should include a SubRecord that extends from zgrab2.base_scan_response,
specifically, overridding the result field. See schemas/mysql.py
for an example.
Register the module
In schemas/__init__.py, add an import for your
module (e.g. import my_protocol). This will ensure that the module code
is executed and that the response type is registered with the zgrab2 module.