Skip to content

Target

sereto.models.target

TargetDastModel

Bases: TargetModel

Model representing a target which is characterized by IP address.

Source code in sereto/models/target.py 
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
class TargetDastModel(TargetModel):
    """Model representing a target which is characterized by IP address."""

    dst_ips_dynamic: bool = False
    dst_ips_dynamic_details: str | None = None
    src_ips: list[IPvAnyAddress | IPvAnyNetwork] = []
    ip_filtering: bool = False
    ip_allowed: bool | None = None
    authentication: bool = False
    credentials_provided: bool | None = None
    internal: bool = False
    environment: Environment = Environment.acceptance
    waf_present: bool = False
    waf_whitelisted: bool | None = None
    clickpath: str | None = None
    api: str | None = None

TargetModel

Bases: SeretoBaseModel

Base class for model representing the details of a target.

Attributes:

Name Type Description
id str | None

Unique identifier for the target, optional.
category str

The category of the target.
name str

The name of the target (e.g. DAST, SAST).
locators list[LocatorModel]

List of locators for the target, such as URLs or IP addresses, source code files, etc.
Source code in sereto/models/target.py 
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
class TargetModel(SeretoBaseModel, extra="allow"):
    """Base class for model representing the details of a target.

    Attributes:
        id: Unique identifier for the target, optional.
        category: The category of the target.
        name: The name of the target (e.g. DAST, SAST).
        locators: List of locators for the target, such as URLs or IP addresses, source code files, etc.
    """

    id: str | None = None
    category: str
    name: str
    locators: list[LocatorModel] = Field(default_factory=list)

    @field_validator("category")
    @classmethod
    def category_valid(cls, v: str) -> str:
        settings = load_settings_function()
        if v in settings.categories:
            return v
        else:
            raise ValueError(f'category "{v}" is unknown')

    @property
    def uname(self) -> str:
        """Unique name for the target instance (version is not included)."""
        return lower_alphanum(f"target_{self.category}_{self.name}")

uname property

Unique name for the target instance (version is not included).

TargetSastModel

Bases: TargetModel

Model representing the details of the 'sast' category.

Attributes:

Name Type Description
code_origin Literal['vcs', 'archive'] | None

where we obtained the code - Version Control System or archive (ZIP/TAR/...)
code_origin_name str | None

origin details - e.g. "Gitlab" or "project_source.zip"
code_integrity dict[str, str]

dictionary containing file name with hash type as the key and corresponding hash as the value
source_code_analyzer_files list[str]

additional files from source code analyzers (like Fortify SCA or Sonarqube)
Source code in sereto/models/target.py 
60
61
62
63
64
65
66
67
68
69
70
71
72
73
class TargetSastModel(TargetModel):
    """Model representing the details of the 'sast' category.

    Attributes:
        code_origin: where we obtained the code - Version Control System or archive (ZIP/TAR/...)
        code_origin_name: origin details - e.g. "Gitlab" or "project_source.zip"
        code_integrity: dictionary containing file name with hash type as the key and corresponding hash as the value
        source_code_analyzer_files: additional files from source code analyzers (like Fortify SCA or Sonarqube)
    """

    code_origin: Literal["vcs", "archive"] | None = None
    code_origin_name: str | None = None
    code_integrity: dict[str, str] = {}
    source_code_analyzer_files: list[str] = []