Python application tracer installation

The SandboxAQ Python Tracer is a Python module that logs cryptographic calls made by the Pyca cryptography library. The logged information is formatted for analysis by AQtive Guard.

Requirements

• Python 3.5 or higher
• Pyca cryptography library 39.0.x

Download

The Python Tracer is distributed as a single Python wheel package: sandbox-<VERSION>-py3-none-any.whl.

If you’ve purchased the appropriate license, a download link to the tracer should have been sent to you. Visit our support portal if you have questions or need help.

Installation

There are several ways to install the Python Tracer, depending on your preferred package manager. The following two examples demonstrate how to use pip or Poetry.

Note

Make sure the Python wheel file is either located in the same directory where you’re running the command or is accessible from the current working directory.

pip installation

If your application uses pip, you can install the Python Tracer using the following command:

pip install sandbox-<VERSION>-py3-none-any.whl

Poetry installation

If your application uses Poetry, you can install the Python Tracer using either of the following commands:

poetry add sandbox-<VERSION>-py3-none-any.whl

and then

poetry install

Test the poetry installation

As a smoke test, you can verify the successful poetry installation by checking your pyproject.toml file, which should contain the following line:

sandbox = {path = sandbox-<VERSION>-py3-none-any.whl}