This release is a pre-release and may not be stable for production use.
Project description CyClarity SDK
Introduction
CyClarity SDK is a Python package that provides an interface for interacting with the CyClarity platform. It includes classes and methods for creating, managing, and interacting with various resources on the platform.
Installation
You can install the CyClarity SDK using poetry in your poetry project:
poetry add cyclarity-sdk
To create a poetry project use this docs: https://python-poetry.org/docs/
You can download your sdk-usage-example using cyclarity git hub example : https://github.com/cyclarity/cyclarity-sdk-usage-examples Usage
Here are examples of how to use the classes in the CyClarity SDK. Runnable The Runnable class is a base class for creating objects that can be run with setup and teardown phases. It has setup, run, and teardown methods that need to be implemented.
This is the structure of a runnable:
from cyclarity_sdk.runnable import Runnable, BaseResultsModel
from cyclarity_sdk.sdk_models.findings import PTFinding
import cyclarity_sdk.sdk_models.findings.types import FindingStatus , FindingType , AssessmentCategory
import cyclarity_sdk.sdk_models.findings.types as PTFindingTypes
class MyResult(BaseResultsModel):
res_str: str
class MyRunnable(Runnable[MyResult]):
desc: str
cli_args: str
#self.platform_api inherited attribute,initiates PlatformApi class
def setup(self):
self.logger.info("Setting up")
#the run function is the first function to be initiated when a runnable is executed.
def run(self):
self.logger.info("Running")
self.platform_api.send_test_report_description("This is a test description")
self.platform_api.send_finding(PTFinding(
topic='hello world',
status=PTFindingTypes.FindingStatus.FINISHED,
type=PTFindingTypes.FindingType.FINDING,
assessment_category=PTFindingTypes.AssessmentCategory.FUNCTIONAL_TEST,
assessment_technique=PTFindingTypes.AssessmentTechnique.OTHER_EXPLORATION,
purpose='Snippet example',
description='This is an example snippet on how to user platform_api'))
for percentage in range(101):
self.platform_api.report_test_progress(percentage=percentage)
time.sleep(0.01)
return MyResult(res_str="success!")
def teardown(self, exception_type, exception_value, traceback):
self.logger.info("Tearing down")
PlatformApi
The PlatformApi class provides methods for interacting with the CyClarity platform. It is used within a Runnable instance through the self.platform_api attribute.
from cyclarity_sdk.platform_api.Iplatform_connector import IPlatformConnectorApi as IPlatformConnectorApi
from cyclarity_sdk.sdk_models.findings import PTFinding as PTFinding
class PlatformApi:
def __init__(self, platform_connector: IPlatformConnectorApi | None = None) -> None: ...
def send_test_report_description(self, description: str): ...
def send_finding(self, pt_finding: PTFinding): ...
def report_test_progress(self, percentage: int): ...
send_test_report_description:
description: str (expects a description)
send_finding:
Gets PTfinding object and sends it to be visible on the website (See PTFinding)
report_test_progress
percentage: int (expects a percentage , example above)
PTFinding
from pydantic import BaseModel, Field, computed_field, field_validator
from enum import Enum
from cyclarity_sdk.sdk_models.findings.types import FindingStatus, FindingType, AssessmentCategory, AssessmentTechnique
from cyclarity_sdk.sdk_models import ExecutionMetadata, MessageType
class PTFinding(BaseModel):
topic: str
status: FindingStatus
type: FindingType
assessment_category: AssessmentCategory
assessment_technique: AssessmentTechnique
purpose: str
description: str
class FindingStatus(str, Enum):
FINISHED = 'Finished'
PARTIALLY_PERFORMED = 'Partially Performed'
NOT_PERFORMED = 'Not Performed'
class FindingType(str, Enum):
FINDING = 'Finding'
NON_FINDING = 'Non Finding'
INSIGHT = 'Insight'
ADDITIONAL_INFORMATION = 'Additional Information'
class AssessmentCategory(str, Enum):
FUNCTIONAL_TEST = 'functional test'
PENTEST = 'pentest'
VULNERABILITY_ANALYSIS = 'vulnerability analysis'
INCIDENT = 'incident'
CODE_REVIEW = 'code review'
UNKNOWN = 'unknown'
class AssessmentTechnique(str, Enum):
SPEC_BASED_TEST_CASE = 'specification-based test case'
HARDWARE_ANALYSIS = 'hardware analysis'
BINARY_ANALYSIS = 'binary analysis'
INTERFACE_ANALYSIS = 'interface analysis'
NETWORK_ANALYSIS = 'network analysis'
CODE_REVIEW = 'code review'
SPECIFICATION_REVIEW = 'specification review'
CVE_SEARCH = 'CVE search'
OTHER_EXPLORATION = 'other exploration'
UNKNOWN = 'unknown'
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cyclarity_sdk-1.0.101a133801.tar.gz.
File metadata
- Download URL: cyclarity_sdk-1.0.101a133801.tar.gz
- Upload date:
- Size: 19.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.1.3 CPython/3.10.17 Linux/6.18.35
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b54ebd9e8d894a130f870219334f45c905b14c67ef72fcf2d7821a7b1454d68f
|
|
| MD5 |
6491fc7d5efb4caa7c54df4e6a92e6c0
|
|
| BLAKE2b-256 |
b8616489df3dc7018652f8a68746874ae9f7dd722b3fae294487f79a959e17ef
|
File details
Details for the file cyclarity_sdk-1.0.101a133801-py3-none-any.whl.
File metadata
- Download URL: cyclarity_sdk-1.0.101a133801-py3-none-any.whl
- Upload date:
- Size: 28.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.1.3 CPython/3.10.17 Linux/6.18.35
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
24bf52d55b6259000a55fee12d5387ba3e8ab3245ff03189d4b8f2b8c5438696
|
|
| MD5 |
4ababbfab8733143c87cdd95a0bb99ba
|
|
| BLAKE2b-256 |
47af637f8d741b6de6faa150b99b885132dc86eb5bb27277332c1cd4a541d77f
|
