Additional Configuration Options

Rules Processing

Several Jigsaw features use a rule processing system to determine what is in scope. The rules are specified as a JSON array of strings, where the strings are processed from left to right, adding or subtracting values to the set. Rules support the following special characters:

The following table demonstrates some example rule arrays:

Seed Value

Randomness is used to create diversity in protections and ensures that no two protections are the same. Several of the protection techniques use random values to vary code and/or data.

{
    # Use a fixed random seed
    "seed": 645261

    # Other configurations:
    ...
}

Any assigned value is used as a seed for the random generator and, therefore, predetermines the output. No seed value (the default) results in the system random entropy being used to generate a random stream.

Protection Reports

Jigsaw can generate protection reports for each library it protects. This feature is enabled by adding the following property to the top-level JSON configuration:

{
    # Turn on protection reports
    "report": true

    # Other configurations:
    ...
}

This creates an HTML report in the current working directory. The report includes high level protection statistics and a very detailed listing of all control flow call instructions redirected, which ones carry checksums, and the checksum ranges covered by each call.

For any sizeable library, these reports are likely to be several megabytes in size.