The Deep Security Python SDK consists of a package containing the module that you can use to interact with the API. If you would rather use the API directly via tools such as Postman and curl, you do not need an SDK.
Get set up to use the Python SDK
- Python version 3.4 or 3.7
The Python executable must be in your system path. For Windows, in the Python installer, select Add Python 3.<x> to PATH at the start of the installation.
For Linux, Python is added to the system path during Python installation.
- pip package manager
For Windows, pip is installed with Python. For Linux, pip is installed separately from Python. You can install pip using the package manager of your Linux distribution.
Download and install the Python SDK
Make sure that you download the SDK that is compatible with your Deep Security Manager.
- Download the Python SDK.
- Extract the Python SDK ZIP file.
- Open a Command Line or Terminal and change the current directory to the directory of the extracted contents.
- Enter the following command to install the module and dependencies:
The below commands assume that the Python executable is in your system path.
python -m pip install .
python3 -m pip install .
- Download the Python SDK.
deepsecurity.Configuration.verify_ssl = False.
You should only disable SSL verification in development environments. For production environments make sure that SSL verification is on.
Install a Python IDE
You can use any Python IDE to develop for the Deep Security API. If you need to install one, we recommend using PyCharm Community Edition. It is free, well-supported, and has a comprehensive feature set.
Download PyCharm Community Edition.
Follow the PyCharm installation instructions for your Linux distribution.
If you prefer to use Eclipse, the following videos step you through the process of setting up the Eclipse IDE with the Python SDK:
Add the SDK to a project in PyCharm
Follow the procedure below to create a PyCharm project that can run the code examples in the Automation Center guides.
- Run PyCharm.
- Click Create New Project.
- In Location, change the folder you wish to save to if needed and then enter a name for the project.
- Click Project Interpreter: New Virtualenv environment.
- Select Inherit global site-packages.
- Click Create.
- To get familiar with how to use the SDK with the Deep Security API, see the Send Your First Request Using the API guide.
- If you are already familiar with using an API or have specific tasks that you want to use the SDK for, see Run the Code Examples to get started with the task-based examples in other Automation Center guides.
You can add the code examples from any of the other Automation Center guides to the project you created above.