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
Metadata
1 maintainer
Release files for cyclarity-sdk 1.0.105
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cyclarity_sdk-1.0.105.tar.gz | 21.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cyclarity_sdk-1.0.105-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 50.8 kB
Release files / cyclarity_sdk-1.0.105.tar.gz
| Download URL | cyclarity_sdk-1.0.105.tar.gz |
|---|---|
| Size | 21.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f4ac0e877dcbb046ed29689d02d58a677322d3666a390200de18a2c06e615855
|
|
BLAKE2b-256 checksum How to use checksums |
35e5ba889c2281c21fa52cbc422fc37f381fba4f1890d0ca77dfad81095ac667
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.3 CPython/3.10.17 Linux/6.18.35
|
Release files / cyclarity_sdk-1.0.105-py3-none-any.whl
| Download URL | cyclarity_sdk-1.0.105-py3-none-any.whl |
|---|---|
| Size | 29.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9510b598cc5c2ddbd7451dce8cdb74606e6f53e20c6433ee32a59a574d84f6fa
|
|
BLAKE2b-256 checksum How to use checksums |
3095e871c5181b9b5fabe7f4cb899e042b18f1762d7b53d214d7c958a7f3f483
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.1.3 CPython/3.10.17 Linux/6.18.35
|
