devsecops-engine-tools 1.6.7__py3-none-any.whl

devsecops_engine_tools/engine_utilities/azuredevops/infrastructure/azure_devops_api.py

@@ -0,0 +1,67 @@
+import json
+from devsecops_engine_tools.engine_utilities.utils.api_error import ApiError
+from urllib.parse import urlsplit, unquote
+from azure.devops.connection import Connection
+from msrest.authentication import BasicAuthentication
+from devsecops_engine_tools.engine_utilities.utils.logger_info import MyLogger
+from devsecops_engine_tools.engine_utilities.settings import SETTING_LOGGER
+from azure.devops.v7_1.git.models import GitVersionDescriptor
+
+logger = MyLogger.__call__(**SETTING_LOGGER).get_logger()
+
+
+class AzureDevopsApi:
+    def __init__(
+        self,
+        personal_access_token: str = "",
+        project_remote_config: str = "",
+        organization_url: str = "",
+        compact_remote_config_url: str = "",
+        repository_id: str = "",
+        remote_config_path: str = "",
+    ):
+        self.__personal_access_token = personal_access_token
+        self.__organization_url = organization_url
+        self.__project_remote_config = project_remote_config
+        self.__compact_remote_config_url = compact_remote_config_url
+        self.__repository_id = repository_id
+        self.__remote_config_path = remote_config_path
+
+    def segment_url(self):
+        if self.__compact_remote_config_url:
+            url_parts = urlsplit(self.__compact_remote_config_url)
+            path = unquote(url_parts.path)
+            path_parts = path.split("/")
+            self.__organization_url = url_parts.scheme + "://" + url_parts.netloc + "/"
+            self.__project_remote_config = path_parts[1]
+            self.__repository_id = path_parts[3]
+            query_parts = url_parts.query.split("=")
+            self.__remote_config_path = query_parts[1]
+
+    def get_azure_connection(self) -> Connection:
+        self.segment_url()
+        try:
+            credentials = BasicAuthentication(username="", password=self.__personal_access_token)
+
+            connection = Connection(base_url=self.__organization_url, creds=credentials)
+
+            return connection
+        except Exception as e:
+            raise ApiError("Error getting Azure DevOps connection: " + str(e))
+
+    def get_remote_json_config(self, connection: Connection):
+        try:
+            git_client = connection.clients.get_git_client()
+            git_version_descriptor = GitVersionDescriptor(version_type="branch", version="feature/migration_open")
+            file_content = git_client.get_item_text(
+                repository_id=self.__repository_id,
+                path=self.__remote_config_path,
+                project=self.__project_remote_config,
+                version_descriptor=git_version_descriptor,
+            )
+            data = json.loads(b"".join(file_content).decode("utf-8"))
+            return data
+        except Exception as e:
+            # Arrojar una excepción personalizada
+            logger.error(str(e))
+            raise ApiError("Error getting remote configuration file: " + str(e))

devsecops_engine_tools/engine_utilities/azuredevops/models/AzureMessageLoggingPipeline.py

@@ -0,0 +1,21 @@
+from enum import Enum
+
+"""https://learn.microsoft.com/en-us/azure/devops/pipelines/scripts/logging-commands?view=azure-devops&tabs=bash """
+
+
+class BaseEnum(Enum):
+    def get_message(self, message: str):
+        return self._value_ + message
+
+
+class AzureMessageResultPipeline(Enum):
+    Failed = "##vso[task.complete result=Failed;]DONE"
+    SucceededWithIssues = "##vso[task.complete result=SucceededWithIssues;]DONE"
+    Succeeded = "##vso[task.complete result=Succeeded;]DONE"
+
+
+class AzureMessageLoggingPipeline(BaseEnum):
+    WarningLogging = "##[warning]"
+    ErrorLogging = "##[error]"
+    SucceededLogging = "##[section]"
+    InfoLogging = "##[command]"

devsecops_engine_tools/engine_utilities/azuredevops/models/AzurePredefinedVariables.py

@@ -0,0 +1,65 @@
+import os
+from enum import Enum
+from devsecops_engine_tools.engine_utilities.input_validations.env_utils import EnvVariables
+
+""" Info de https://learn.microsoft.com/en-us/azure/devops/pipelines/process/variables?view=azure-devops&tabs=yaml%2Cbatch
+Build variables (DevOps Services) https://learn.microsoft.com/en-us/azure/devops/pipelines/build/variables?view=azure-devops&tabs=yaml """
+
+
+class EnvVariables:
+    @staticmethod
+    def get_value(env_name):
+        env_var = os.environ.get(env_name)
+        if env_var is None:
+            raise ValueError(f"La variable de entorno {env_name} no está definida")
+        return env_var
+
+
+class BaseEnum(Enum):
+    @property
+    def env_name(self):
+        return self._value_.replace(".", "_").upper()
+
+    def value(self):
+        return EnvVariables.get_value(self.env_name)
+
+
+class SystemVariables(BaseEnum):
+    System_AccessToken = "System.AccessToken"
+    System_CollectionId = "System.CollectionId"
+    System_DefaultWorkingDirectory = "System.DefaultWorkingDirectory"
+    System_StageName = "System.StageName"
+    System_HostType = "System.HostType"
+    System_TeamFoundationCollectionUri = "System.TeamFoundationCollectionUri"
+    System_TeamProject = "System.TeamProject"
+    System_TeamProjectId = "System.TeamProject"
+    System_PullRequestId = "System.PullRequest.PullRequestId"
+    System_TargetBranchName = "System.PullRequest.TargetBranchName"
+    System_SourceBranch = "System.PullRequest.SourceBranch"
+
+
+class BuildVariables(BaseEnum):
+    Build_BuildId = "Build.BuildId"
+    Build_BuildNumber = "Build.BuildNumber"
+    Build_DefinitionName = "Build.DefinitionName"
+    Build_Project_Name = "Build.ProjectName"
+    Build_Repository_Name = "Build.Repository.Name"
+    Build_SourceBranch = "Build.SourceBranch"
+    Build_SourceBranchName = "Build.SourceBranchName"
+    Build_StagingDirectory = "Build.StagingDirectory"
+    Build_SourceVersion = "Build.SourceVersion"
+    Build_Repository_Provider = "Build.Repository.Provider"
+
+
+class ReleaseVariables(BaseEnum):
+    Release_Definitionname = "Release.DefinitionName"
+    Release_Releaseid = "Release.ReleaseId"
+    Artifact_Path = "ARTIFACT_PATH"
+    Environment = "ENV"
+
+
+class AgentVariables(BaseEnum):
+    Agent_BuildDirectory = "Agent.BuildDirectory"
+    Agent_WorkFolder = "Agent.WorkFolder"
+    Agent_TempDirectory = "Agent.TempDirectory"
+    Agent_OS = "Agent.OS"

devsecops_engine_tools/engine_utilities/defect_dojo/__init__.py

@@ -0,0 +1,5 @@
+from .domain.request_objects.import_scan import ImportScanRequest
+from .domain.request_objects.finding import FindingRequest
+from .applications.defect_dojo import DefectDojo
+from .applications.finding import Finding
+from .applications.connect import Connect

devsecops_engine_tools/engine_utilities/defect_dojo/applications/connect.py

@@ -0,0 +1,37 @@
+from devsecops_engine_tools.engine_utilities.utils.api_error import ApiError
+from devsecops_engine_tools.engine_utilities.defect_dojo.domain.request_objects.import_scan import ImportScanRequest
+from devsecops_engine_tools.engine_utilities.defect_dojo.domain.serializers.import_scan import ImportScanSerializer
+from devsecops_engine_tools.engine_utilities.defect_dojo.domain.user_case.cmdb import CmdbUserCase
+from devsecops_engine_tools.engine_utilities.defect_dojo.infraestructure.driver_adapters.cmdb import CmdbRestConsumer
+from devsecops_engine_tools.engine_utilities.azuredevops.infrastructure.azure_devops_api import AzureDevopsApi
+from devsecops_engine_tools.engine_utilities.utils.session_manager import SessionManager
+
+
+class Connect:
+    @staticmethod
+    # Configuration Management Database aws
+    def cmdb(**kwargs) -> ImportScanRequest:
+        try:
+            request: ImportScanRequest = ImportScanSerializer().load(kwargs)
+            rc = CmdbRestConsumer(
+                token=request.token_cmdb,
+                host=request.host_cmdb,
+                mapping_cmdb=request.cmdb_mapping,
+                session=SessionManager(),
+            )
+
+            utils_azure = AzureDevopsApi(
+                personal_access_token=request.personal_access_token,
+                project_remote_config=request.project_remote_config,
+                organization_url=request.organization_url,
+                compact_remote_config_url=request.compact_remote_config_url,
+                repository_id=request.repository_id,
+                remote_config_path=request.remote_config_path,
+            )
+
+            uc = CmdbUserCase(rest_consumer_cmdb=rc, utils_azure=utils_azure, expression=request.expression)
+            response = uc.execute(request)
+        except Exception as e:
+            return e
+
+        return response

devsecops_engine_tools/engine_utilities/defect_dojo/applications/defect_dojo.py

@@ -0,0 +1,40 @@
+from devsecops_engine_tools.engine_utilities.utils.api_error import ApiError
+from devsecops_engine_tools.engine_utilities.utils.logger_info import MyLogger
+from devsecops_engine_tools.engine_utilities.defect_dojo.infraestructure.driver_adapters.import_scan import ImportScanRestConsumer
+from devsecops_engine_tools.engine_utilities.defect_dojo.infraestructure.driver_adapters.product_type import ProductTypeRestConsumer
+from devsecops_engine_tools.engine_utilities.defect_dojo.infraestructure.driver_adapters.product import ProductRestConsumer
+from devsecops_engine_tools.engine_utilities.defect_dojo.infraestructure.driver_adapters.scan_configurations import (
+    ScanConfigrationRestConsumer,
+)
+from devsecops_engine_tools.engine_utilities.defect_dojo.infraestructure.driver_adapters.engagement import EngagementRestConsumer
+from devsecops_engine_tools.engine_utilities.defect_dojo.domain.request_objects.import_scan import ImportScanRequest
+from devsecops_engine_tools.engine_utilities.defect_dojo.domain.user_case.import_scan import ImportScanUserCase
+from devsecops_engine_tools.engine_utilities.utils.session_manager import SessionManager
+from devsecops_engine_tools.engine_utilities.settings import SETTING_LOGGER
+
+logger = MyLogger.__call__(**SETTING_LOGGER).get_logger()
+
+
+class DefectDojo:
+    @staticmethod
+    def send_import_scan(request: ImportScanRequest):
+        try:
+            if not isinstance(request, ImportScanRequest):
+                return request
+            rest_import_scan = ImportScanRestConsumer(request, session=SessionManager())
+            rest_product_type = ProductTypeRestConsumer(request, session=SessionManager())
+            rest_product = ProductRestConsumer(request, session=SessionManager())
+            rest_engagement = EngagementRestConsumer(request, session=SessionManager())
+
+            rest_scan_configuration = ScanConfigrationRestConsumer(request, session=SessionManager())
+            uc = ImportScanUserCase(
+                rest_import_scan,
+                rest_product_type,
+                rest_product,
+                rest_scan_configuration,
+                rest_engagement=rest_engagement,
+            )
+            response = uc.execute(request)
+            return response
+        except ApiError as e:
+            return e

devsecops_engine_tools/engine_utilities/defect_dojo/applications/finding.py

@@ -0,0 +1,40 @@
+from devsecops_engine_tools.engine_utilities.defect_dojo.domain.request_objects.finding import FindingRequest
+from devsecops_engine_tools.engine_utilities.defect_dojo.domain.serializers.finding import FindingSerializer
+from devsecops_engine_tools.engine_utilities.defect_dojo.infraestructure.driver_adapters.finding import FindingRestConsumer
+from devsecops_engine_tools.engine_utilities.defect_dojo.domain.user_case.finding import FindingUserCase, FindingGetUserCase
+from devsecops_engine_tools.engine_utilities.utils.session_manager import SessionManager
+from devsecops_engine_tools.engine_utilities.utils.api_error import ApiError
+from devsecops_engine_tools.engine_utilities.utils.logger_info import MyLogger
+from devsecops_engine_tools.engine_utilities import settings
+
+logger = MyLogger.__call__(**settings.SETTING_LOGGER).get_logger()
+
+
+class Finding:
+    @staticmethod
+    def serializer(*args, **request):
+        serializer = FindingSerializer()
+        errors = serializer.validate(request)
+        if errors:
+            logger.error(errors)
+            raise Exception(errors)
+
+    @staticmethod
+    def close_finding(session, **request):
+        try:
+            Finding.serializer(**request)
+            rest_finding = FindingRestConsumer(session=session)
+            uc = FindingUserCase(rest_finding)
+            return uc.execute(request)
+        except Exception as e:
+            raise e
+
+    @staticmethod
+    def get_finding(session, **request):
+        try:
+            Finding.serializer(**request)
+            rest_finding = FindingRestConsumer(session=session)
+            uc = FindingGetUserCase(rest_finding)
+            return uc.execute(request)
+        except Exception as e:
+            raise e

devsecops_engine_tools/engine_utilities/defect_dojo/domain/models/cmdb.py

@@ -0,0 +1,11 @@
+import dataclasses
+from devsecops_engine_tools.engine_utilities.utils.dataclass_classmethod import FromDictMixin
+
+
+@dataclasses.dataclass
+class Cmdb(FromDictMixin):
+    product_type_name: str = ""
+    product_name: str = ""
+    tag_product: str = ""
+    product_description: str = ""
+    codigo_app: str = ""

devsecops_engine_tools/engine_utilities/defect_dojo/domain/models/engagement.py

@@ -0,0 +1,55 @@
+import dataclasses
+from typing import List
+from devsecops_engine_tools.engine_utilities.utils.dataclass_classmethod import FromDictMixin
+
+
+@dataclasses.dataclass
+class Engagement(FromDictMixin):
+    id: int = 0
+    tags = []
+    name: str = ""
+    description: str = ""
+    version: str = ""
+    first_contacted: str = ""
+    target_start: str = ""
+    target_end: str = ""
+    reason: str = ""
+    updated: str = ""
+    created: str = ""
+    active: str = ""
+    tracker: str = ""
+    test_strategy: str = ""
+    threat_model: str = ""
+    api_test: str = ""
+    pen_test: str = ""
+    check_list: str = ""
+    status: str = ""
+    progress: str = ""
+    tmodel_path: str = ""
+    done_testing: str = ""
+    engagement_type: str = ""
+    build_id: str = ""
+    commit_hash: str = ""
+    branch_tag: str = ""
+    source_code_management_uri: str = ""
+    deduplication_on_engagement: str = ""
+    lead: int = 0
+    requester: str = ""
+    preset: str = ""
+    report_type: str = ""
+    product: int = 0
+    build_server: str = ""
+    source_code_management_server: str = ""
+    orchestration_engine: str = ""
+    notes = []
+    files = []
+    risk_acceptance = []
+
+
+@dataclasses.dataclass
+class EngagementList(FromDictMixin):
+    count: int = 0
+    next = None
+    previous = None
+    results: List[Engagement] = dataclasses.field(default_factory=list)
+    prefetch = None

devsecops_engine_tools/engine_utilities/defect_dojo/domain/models/finding.py

@@ -0,0 +1,96 @@
+import dataclasses
+from typing import List
+from devsecops_engine_tools.engine_utilities.utils.dataclass_classmethod import FromDictMixin
+
+
+@dataclasses.dataclass
+class Finding(FromDictMixin):
+    id: int = 0
+    tags: List[None] = dataclasses.field(default_factory=list)
+    request_response = None
+    req_resp: List[None] = dataclasses.field(default_factory=list)
+    accepted_risks: List[None] = dataclasses.field(default_factory=list)
+    push_to_jira: bool = False
+    age: int = 0
+    sla_days_remaining: int = 0
+    finding_meta: List[None] = dataclasses.field(default_factory=list)
+    related_fields = None
+    jira_creation = None
+    jira_change = None
+    display_status: str = ""
+    finding_groups: List[None] = dataclasses.field(default_factory=list)
+    vulnerability_ids: List[None] = dataclasses.field(default_factory=list)
+    reporter: int = 0
+    title: int = 0
+    date: str = ""
+    sla_start_date = None
+    cwe: int = 0
+    cvssv3 = None
+    cvssv3_score = None
+    url: str = ""
+    severity: str = ""
+    description: str = ""
+    mitigation = None
+    impact = None
+    steps_to_reproduce = None
+    severity_justification = None
+    references = None
+    active: bool = None
+    verified: bool = None
+    false_p: bool = None
+    duplicate: bool = None
+    out_of_scope: bool = None
+    risk_status: str = ""
+    risk_accepted: bool = None
+    under_review: bool = None
+    last_status_update: str = ""
+    under_defect_review: bool = None
+    is_mitigated: bool = None
+    thread_id: int = -1
+    mitigated = None
+    numerical_severity: str = ""
+    last_reviewed: str = ""
+    param = None
+    payload = None
+    hash_code: str = ""
+    line = None
+    file_path: str = ""
+    component_name: str = ""
+    component_version: str = ""
+    static_finding: bool = None
+    dynamic_finding: bool = None
+    created: str = ""
+    scanner_confidence = None
+    unique_id_from_tool: str = ""
+    vuln_id_from_tool: str = ""
+    sast_source_object = None
+    sast_sink_object = None
+    sast_source_line = None
+    sast_source_file_path = None
+    nb_occurences = None
+    publish_date = None
+    service = None
+    planned_remediation_date = None
+    planned_remediation_version = None
+    effort_for_fixing = None
+    test: int = -1
+    duplicate_finding = None
+    review_requested_by = None
+    defect_review_requested_by = None
+    mitigated_by = None
+    last_reviewed_by: int = -1
+    sonarqube_issue = None
+    endpoints: List[None] = dataclasses.field(default_factory=list)
+    reviewers: List[None] = dataclasses.field(default_factory=list)
+    notes: List[None] = dataclasses.field(default_factory=list)
+    files: List[None] = dataclasses.field(default_factory=list)
+    found_by: List[None] = dataclasses.field(default_factory=list)
+
+
+@dataclasses.dataclass
+class FindingList(FromDictMixin):
+    count: int = 0
+    next = None
+    previous = None
+    results: List[Finding] = dataclasses.field(default_factory=list)
+    prefetch = None

devsecops_engine_tools/engine_utilities/defect_dojo/domain/models/product.py

@@ -0,0 +1,35 @@
+import dataclasses
+from typing import List
+from devsecops_engine_tools.engine_utilities.utils.dataclass_classmethod import FromDictMixin
+
+
+@dataclasses.dataclass
+class Product(FromDictMixin):
+    id: int = 0
+    findings_count: int = 0
+    findings_list: List[None] = dataclasses.field(default_factory=list)
+    tags: List[None] = dataclasses.field(default_factory=list)
+    product_meta: List[None] = dataclasses.field(default_factory=list)
+    name: int = ""
+    description: str = ""
+    created: str = ""
+    prod_numeric_grade: int = 0
+    business_criticality = None
+    platform = None
+    lifecycle = None
+    origin = None
+    user_records = None
+    revenue = None
+    external_audience: bool = None
+    internet_accessible: bool = None
+    enable_simple_risk_acceptance: bool = None
+    enable_full_risk_acceptance: bool = None
+    disable_sla_breach_notifications: bool = None
+    product_manager = None
+    technical_contact = None
+    team_manager = None
+    prod_type: int = 0
+    sla_configuration: int = 0
+    members: List[int] = dataclasses.field(default_factory=list)
+    authorization_groups: List[None] = dataclasses.field(default_factory=list)
+    regulations: List[None] = dataclasses.field(default_factory=list)

devsecops_engine_tools/engine_utilities/defect_dojo/domain/models/product_list.py

@@ -0,0 +1,12 @@
+import dataclasses
+from typing import List
+from devsecops_engine_tools.engine_utilities.utils.dataclass_classmethod import FromDictMixin
+from devsecops_engine_tools.engine_utilities.defect_dojo.domain.models.product import Product
+
+
+@dataclasses.dataclass
+class ProductList(FromDictMixin):
+    count: int = 0
+    next = None
+    previous = None
+    results: List[Product] = dataclasses.field(default_factory=list)

devsecops_engine_tools/engine_utilities/defect_dojo/domain/models/product_type.py

@@ -0,0 +1,16 @@
+import dataclasses
+from typing import List
+from devsecops_engine_tools.engine_utilities.utils.dataclass_classmethod import FromDictMixin
+
+
+@dataclasses.dataclass
+class ProductType(FromDictMixin):
+    id: int = 0
+    name: str = ""
+    description: str = ""
+    critical_product: bool = None
+    key_product: bool = None
+    updated: str = ""
+    created: str = ""
+    members: List[int] = dataclasses.field(default_factory=list)
+    authorization_groups: List[None] = dataclasses.field(default_factory=list)

devsecops_engine_tools/engine_utilities/defect_dojo/domain/models/product_type_list.py

@@ -0,0 +1,13 @@
+import dataclasses
+from typing import List
+from devsecops_engine_tools.engine_utilities.utils.dataclass_classmethod import FromDictMixin
+from devsecops_engine_tools.engine_utilities.defect_dojo.domain.models.product_type import ProductType
+
+
+@dataclasses.dataclass
+class ProductTypeList(FromDictMixin):
+    count: int = 0
+    next = None
+    previous = None
+    results: List[ProductType] = dataclasses.field(default_factory=list)
+    prefetch = None

devsecops_engine_tools/engine_utilities/defect_dojo/domain/models/scan_configuration.py

@@ -0,0 +1,21 @@
+import dataclasses
+from typing import List
+from devsecops_engine_tools.engine_utilities.utils.dataclass_classmethod import FromDictMixin
+
+
+@dataclasses.dataclass
+class ScanConfiguration(FromDictMixin):
+    id: int = 0
+    service_key_1: str = ""
+    service_key_2: str = ""
+    service_key_3: str = ""
+    product: int = 0
+    tool_configuration: int = 0
+
+
+@dataclasses.dataclass
+class ScanConfigurationList(FromDictMixin):
+    count: int = 2
+    next = None
+    previous = None
+    results: List[ScanConfiguration] = dataclasses.field(default_factory=list)

devsecops_engine_tools/engine_utilities/defect_dojo/domain/request_objects/finding.py

@@ -0,0 +1,95 @@
+import dataclasses
+
+
+@dataclasses.dataclass
+class FindingRequest:
+    active: bool = True
+    component_name: str = ""
+    component_version: str = ""
+    created: str = ""
+    cvssv3: str = ""
+    cvssv3_score: float = 0.0
+    cwe = None
+    date: str = ""
+    defect_review_requested_by = None
+    description: str = ""
+    duplicate: bool = True
+    duplicate_finding = 0
+    dynamic_finding: bool = False
+    effort_for_fixing: str = ""
+    endpoints = None
+    false_p: bool = False
+    file_path: str = ""
+    finding_group = None
+    found_by: int = 0
+    has_jira: bool = False
+    has_tags: bool = False
+    hash_code: str = ""
+    id = None
+    impact: str = ""
+    inherited_tags = None
+    is_mitigated: bool = False
+    jira_change: str = ""
+    jira_creation: str = ""
+    last_reviewed: str = ""
+    last_reviewed_by = None
+    limit: int = 0
+    mitigated: str = ""
+    mitigated_by = None
+    mitigation: str = ""
+    nb_occurences = None
+    not_tag: str = ""
+    not_tags = None
+    not_test__engagement__product__tags = None
+    not_test__engagement__tags = None
+    not_test__tags = None
+    numerical_severity: str = ""
+    offset: int = 0
+    out_of_scope: bool = False
+    outside_of_sla: int = 0
+    param: str = ""
+    payload: str = ""
+    planned_remediation_date: str = ""
+    planned_remediation_version: str = ""
+    prefetch = None
+    product_name: str = ""
+    product_name_contains: str = ""
+    publish_date: str = ""
+    references: str = ""
+    related_fields: str = ""
+    reporter = None
+    review_request_by = None
+    reviewers = None
+    risk_accetance: int = 0
+    risk_accepted: bool = False
+    sast_sink_object: str = ""
+    sast_source_object: str = ""
+    scanner_confidence = None
+    service: str = ""
+    severity: str = ""
+    severity_justification: str = ""
+    sla_start_date: str = ""
+    sonarqube_issue = None
+    static_finding: bool = False
+    steps_to_reproduce: str = ""
+    tag: str = ""
+    tags: str = ""
+    test = None
+    test__engagement = None
+    test__engagement__product = None
+    test__engagement__product__prod_type = None
+    test__engagement__product__tags = None
+    test__engagement__tags = None
+    test__tags = None
+    test__test_type = None
+    title: str = ""
+    under_defect_review: bool = False
+    under_review: bool = False
+    unique_id_from_tool: str = ""
+    verified: bool = False
+    vuln_id_from_tool: str = ""
+    vulnerability_id: str = ""
+
+    @classmethod
+    def from_dict(cls, obj):
+        obj = cls(unique_id_from_tool=obj.get("unique_id_from_tool"))