[client] Add mTLS support and update isort (#363)

Author: juliapaluch

.pre-commit-config.yaml

@@ -1,7 +1,7 @@
 ---
 repos:
   - repo: https://github.com/PyCQA/isort
-    rev: 5.10.1
+    rev: 5.12.0
     hooks:
       - id: isort
         args:

README.md

@@ -75,7 +75,7 @@ $ pip install -r ./test-requirements.txt
 #### Prerequisite
 
 Your OpenCTI API should be running.
-Your conftest.py should be configured with your API url and your token.
+Your conftest.py should be configured with your API url, your token, and if applicable, your mTLS cert/key.
 
 #### Launching
 

docs/client_usage/getting_started.rst

@@ -12,9 +12,13 @@ Using the helper functions
 **************************
 
 The main class :class:`OpenCTIApiClient` contains all what you need to interact
-with the platform, you just have to initialize it. The following example shows
-how you create an indicator in OpenCTI using the python library with TLP marking
-and OpenCTI compatible date format.
+with the platform, you just have to initialize it. If your OpenCTI instance requires mTLS,
+you can specify the paths to your cert and private key in a tuple with the `cert` parameter when
+initializing the `OpenCTIApiClient`. If you need to specify a path to a CA root certificate,
+you can do so with the `ssl_verify` parameter.
+
+The following example shows how you create an indicator in OpenCTI using the python library
+with TLP marking and OpenCTI compatible date format.
 
 .. code-block:: python
 

pycti/api/opencti_api_client.py

@@ -117,11 +117,13 @@ def __init__(
         ssl_verify=False,
         proxies=None,
         json_logging=False,
+        cert=None,
     ):
         """Constructor method"""
 
         # Check configuration
         self.ssl_verify = ssl_verify
+        self.cert = cert
         self.proxies = proxies
         if url is None or len(url) == 0:
             raise ValueError("An URL must be set")
@@ -315,6 +317,7 @@ def query(self, query, variables={}):
                 files=multipart_files,
                 headers=self.request_headers,
                 verify=self.ssl_verify,
+                cert=self.cert,
                 proxies=self.proxies,
             )
         # If no
@@ -324,6 +327,7 @@ def query(self, query, variables={}):
                 json={"query": query, "variables": variables},
                 headers=self.request_headers,
                 verify=self.ssl_verify,
+                cert=self.cert,
                 proxies=self.proxies,
             )
         # Build response