cartography 0.107.0rc2__py3-none-any.whl → 0.108.0__py3-none-any.whl

cartography/models/aws/guardduty/findings.py

@@ -0,0 +1,102 @@
+from dataclasses import dataclass
+
+from cartography.models.core.common import PropertyRef
+from cartography.models.core.nodes import CartographyNodeProperties
+from cartography.models.core.nodes import CartographyNodeSchema
+from cartography.models.core.nodes import ExtraNodeLabels
+from cartography.models.core.relationships import CartographyRelProperties
+from cartography.models.core.relationships import CartographyRelSchema
+from cartography.models.core.relationships import LinkDirection
+from cartography.models.core.relationships import make_target_node_matcher
+from cartography.models.core.relationships import OtherRelationships
+from cartography.models.core.relationships import TargetNodeMatcher
+
+
+@dataclass(frozen=True)
+class GuardDutyFindingNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef("id")
+    arn: PropertyRef = PropertyRef("arn", extra_index=True)
+    title: PropertyRef = PropertyRef("title")
+    description: PropertyRef = PropertyRef("description")
+    type: PropertyRef = PropertyRef("type")
+    severity: PropertyRef = PropertyRef("severity")
+    confidence: PropertyRef = PropertyRef("confidence")
+    eventfirstseen: PropertyRef = PropertyRef("eventfirstseen")
+    eventlastseen: PropertyRef = PropertyRef("eventlastseen")
+    accountid: PropertyRef = PropertyRef("accountid")
+    region: PropertyRef = PropertyRef("region")
+    detectorid: PropertyRef = PropertyRef("detectorid")
+    resource_type: PropertyRef = PropertyRef("resource_type")
+    resource_id: PropertyRef = PropertyRef("resource_id")
+    archived: PropertyRef = PropertyRef("archived")
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class GuardDutyFindingToAWSAccountRelRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class GuardDutyFindingToAWSAccountRel(CartographyRelSchema):
+    target_node_label: str = "AWSAccount"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("AWS_ID", set_in_kwargs=True)},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "RESOURCE"
+    properties: GuardDutyFindingToAWSAccountRelRelProperties = (
+        GuardDutyFindingToAWSAccountRelRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class GuardDutyFindingToEC2InstanceRelRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class GuardDutyFindingToEC2InstanceRel(CartographyRelSchema):
+    target_node_label: str = "EC2Instance"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("resource_id")},
+    )
+    direction: LinkDirection = LinkDirection.OUTWARD
+    rel_label: str = "AFFECTS"
+    properties: GuardDutyFindingToEC2InstanceRelRelProperties = (
+        GuardDutyFindingToEC2InstanceRelRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class GuardDutyFindingToS3BucketRelRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class GuardDutyFindingToS3BucketRel(CartographyRelSchema):
+    target_node_label: str = "S3Bucket"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("resource_id")},
+    )
+    direction: LinkDirection = LinkDirection.OUTWARD
+    rel_label: str = "AFFECTS"
+    properties: GuardDutyFindingToS3BucketRelRelProperties = (
+        GuardDutyFindingToS3BucketRelRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class GuardDutyFindingSchema(CartographyNodeSchema):
+    label: str = "GuardDutyFinding"
+    properties: GuardDutyFindingNodeProperties = GuardDutyFindingNodeProperties()
+    extra_node_labels: ExtraNodeLabels = ExtraNodeLabels(["Risk"])
+    sub_resource_relationship: GuardDutyFindingToAWSAccountRel = (
+        GuardDutyFindingToAWSAccountRel()
+    )
+    other_relationships: OtherRelationships = OtherRelationships(
+        [
+            GuardDutyFindingToEC2InstanceRel(),
+            GuardDutyFindingToS3BucketRel(),
+        ],
+    )

cartography/models/aws/secretsmanager/secret.py

@@ -0,0 +1,106 @@
+from dataclasses import dataclass
+
+from cartography.models.core.common import PropertyRef
+from cartography.models.core.nodes import CartographyNodeProperties
+from cartography.models.core.nodes import CartographyNodeSchema
+from cartography.models.core.relationships import CartographyRelProperties
+from cartography.models.core.relationships import CartographyRelSchema
+from cartography.models.core.relationships import LinkDirection
+from cartography.models.core.relationships import make_target_node_matcher
+from cartography.models.core.relationships import OtherRelationships
+from cartography.models.core.relationships import TargetNodeMatcher
+
+
+@dataclass(frozen=True)
+class SecretsManagerSecretNodeProperties(CartographyNodeProperties):
+    """
+    Properties for AWS Secrets Manager Secret
+    """
+
+    id: PropertyRef = PropertyRef("ARN")
+    arn: PropertyRef = PropertyRef("ARN", extra_index=True)
+    name: PropertyRef = PropertyRef("Name", extra_index=True)
+    description: PropertyRef = PropertyRef("Description")
+
+    # Rotation properties
+    rotation_enabled: PropertyRef = PropertyRef("RotationEnabled")
+    rotation_lambda_arn: PropertyRef = PropertyRef("RotationLambdaARN")
+    rotation_rules_automatically_after_days: PropertyRef = PropertyRef(
+        "RotationRulesAutomaticallyAfterDays"
+    )
+
+    # Date properties (will be converted to epoch timestamps)
+    created_date: PropertyRef = PropertyRef("CreatedDate")
+    last_rotated_date: PropertyRef = PropertyRef("LastRotatedDate")
+    last_changed_date: PropertyRef = PropertyRef("LastChangedDate")
+    last_accessed_date: PropertyRef = PropertyRef("LastAccessedDate")
+    deleted_date: PropertyRef = PropertyRef("DeletedDate")
+
+    # Other properties
+    kms_key_id: PropertyRef = PropertyRef("KmsKeyId")
+    owning_service: PropertyRef = PropertyRef("OwningService")
+    primary_region: PropertyRef = PropertyRef("PrimaryRegion")
+
+    # Standard cartography properties
+    region: PropertyRef = PropertyRef("Region", set_in_kwargs=True)
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class SecretsManagerSecretRelProperties(CartographyRelProperties):
+    """
+    Properties for relationships between Secret and other nodes
+    """
+
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class SecretsManagerSecretToAWSAccountRel(CartographyRelSchema):
+    """
+    Relationship between Secret and AWS Account
+    """
+
+    target_node_label: str = "AWSAccount"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("AWS_ID", set_in_kwargs=True)},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "RESOURCE"
+    properties: SecretsManagerSecretRelProperties = SecretsManagerSecretRelProperties()
+
+
+@dataclass(frozen=True)
+class SecretsManagerSecretToKMSKeyRel(CartographyRelSchema):
+    """
+    Relationship between Secret and its KMS key
+    Only created when KmsKeyId is present
+    """
+
+    target_node_label: str = "AWSKMSKey"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("KmsKeyId")},
+    )
+    direction: LinkDirection = LinkDirection.OUTWARD
+    rel_label: str = "ENCRYPTED_BY"
+    properties: SecretsManagerSecretRelProperties = SecretsManagerSecretRelProperties()
+
+
+@dataclass(frozen=True)
+class SecretsManagerSecretSchema(CartographyNodeSchema):
+    """
+    Schema for AWS Secrets Manager Secret
+    """
+
+    label: str = "SecretsManagerSecret"
+    properties: SecretsManagerSecretNodeProperties = (
+        SecretsManagerSecretNodeProperties()
+    )
+    sub_resource_relationship: SecretsManagerSecretToAWSAccountRel = (
+        SecretsManagerSecretToAWSAccountRel()
+    )
+    other_relationships: OtherRelationships = OtherRelationships(
+        [
+            SecretsManagerSecretToKMSKeyRel(),
+        ],
+    )

cartography/models/github/dependencies.py

@@ -0,0 +1,74 @@
+from dataclasses import dataclass
+
+from cartography.models.core.common import PropertyRef
+from cartography.models.core.nodes import CartographyNodeProperties
+from cartography.models.core.nodes import CartographyNodeSchema
+from cartography.models.core.relationships import CartographyRelProperties
+from cartography.models.core.relationships import CartographyRelSchema
+from cartography.models.core.relationships import LinkDirection
+from cartography.models.core.relationships import make_target_node_matcher
+from cartography.models.core.relationships import OtherRelationships
+from cartography.models.core.relationships import TargetNodeMatcher
+
+
+@dataclass(frozen=True)
+class GitHubDependencyNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef("id")
+    name: PropertyRef = PropertyRef("name")
+    original_name: PropertyRef = PropertyRef("original_name")
+    version: PropertyRef = PropertyRef("version")
+    ecosystem: PropertyRef = PropertyRef("ecosystem")
+    package_manager: PropertyRef = PropertyRef("package_manager")
+    repo_name: PropertyRef = PropertyRef("repo_name")
+    manifest_file: PropertyRef = PropertyRef("manifest_file")
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class GitHubDependencyToRepositoryRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+    requirements: PropertyRef = PropertyRef("requirements")
+    manifest_path: PropertyRef = PropertyRef("manifest_path")
+
+
+@dataclass(frozen=True)
+class GitHubDependencyToRepositoryRel(CartographyRelSchema):
+    target_node_label: str = "GitHubRepository"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("repo_url", set_in_kwargs=True)}
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "REQUIRES"
+    properties: GitHubDependencyToRepositoryRelProperties = (
+        GitHubDependencyToRepositoryRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class DependencyGraphManifestToDependencyRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class DependencyGraphManifestToDependencyRel(CartographyRelSchema):
+    target_node_label: str = "DependencyGraphManifest"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("manifest_id", set_in_kwargs=True)}
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "HAS_DEP"
+    properties: DependencyGraphManifestToDependencyRelProperties = (
+        DependencyGraphManifestToDependencyRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class GitHubDependencySchema(CartographyNodeSchema):
+    label: str = "Dependency"
+    properties: GitHubDependencyNodeProperties = GitHubDependencyNodeProperties()
+    sub_resource_relationship: GitHubDependencyToRepositoryRel = (
+        GitHubDependencyToRepositoryRel()
+    )
+    other_relationships: OtherRelationships = OtherRelationships(
+        [DependencyGraphManifestToDependencyRel()]
+    )

cartography/models/github/manifests.py

@@ -0,0 +1,49 @@
+from dataclasses import dataclass
+
+from cartography.models.core.common import PropertyRef
+from cartography.models.core.nodes import CartographyNodeProperties
+from cartography.models.core.nodes import CartographyNodeSchema
+from cartography.models.core.relationships import CartographyRelProperties
+from cartography.models.core.relationships import CartographyRelSchema
+from cartography.models.core.relationships import LinkDirection
+from cartography.models.core.relationships import make_target_node_matcher
+from cartography.models.core.relationships import TargetNodeMatcher
+
+
+@dataclass(frozen=True)
+class DependencyGraphManifestNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef("id")
+    blob_path: PropertyRef = PropertyRef("blob_path")
+    filename: PropertyRef = PropertyRef("filename")
+    dependencies_count: PropertyRef = PropertyRef("dependencies_count")
+    repo_url: PropertyRef = PropertyRef("repo_url")
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class DependencyGraphManifestToRepositoryRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class DependencyGraphManifestToRepositoryRel(CartographyRelSchema):
+    target_node_label: str = "GitHubRepository"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("repo_url", set_in_kwargs=True)}
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "HAS_MANIFEST"
+    properties: DependencyGraphManifestToRepositoryRelProperties = (
+        DependencyGraphManifestToRepositoryRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class DependencyGraphManifestSchema(CartographyNodeSchema):
+    label: str = "DependencyGraphManifest"
+    properties: DependencyGraphManifestNodeProperties = (
+        DependencyGraphManifestNodeProperties()
+    )
+    sub_resource_relationship: DependencyGraphManifestToRepositoryRel = (
+        DependencyGraphManifestToRepositoryRel()
+    )

cartography/models/sentinelone/application.py

@@ -0,0 +1,44 @@
+from dataclasses import dataclass
+
+from cartography.models.core.common import PropertyRef
+from cartography.models.core.nodes import CartographyNodeProperties
+from cartography.models.core.nodes import CartographyNodeSchema
+from cartography.models.core.relationships import CartographyRelProperties
+from cartography.models.core.relationships import CartographyRelSchema
+from cartography.models.core.relationships import LinkDirection
+from cartography.models.core.relationships import make_target_node_matcher
+from cartography.models.core.relationships import TargetNodeMatcher
+
+
+@dataclass(frozen=True)
+class S1ApplicationNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef("id")
+    name: PropertyRef = PropertyRef("name")
+    vendor: PropertyRef = PropertyRef("vendor")
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class S1ApplicationToAccountRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:S1Application)<-[:RESOURCE]-(:S1Account)
+class S1ApplicationToAccount(CartographyRelSchema):
+    target_node_label: str = "S1Account"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("S1_ACCOUNT_ID", set_in_kwargs=True)},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "RESOURCE"
+    properties: S1ApplicationToAccountRelProperties = (
+        S1ApplicationToAccountRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class S1ApplicationSchema(CartographyNodeSchema):
+    label: str = "S1Application"
+    properties: S1ApplicationNodeProperties = S1ApplicationNodeProperties()
+    sub_resource_relationship: S1ApplicationToAccount = S1ApplicationToAccount()

cartography/models/sentinelone/application_version.py

@@ -0,0 +1,96 @@
+from dataclasses import dataclass
+
+from cartography.models.core.common import PropertyRef
+from cartography.models.core.nodes import CartographyNodeProperties
+from cartography.models.core.nodes import CartographyNodeSchema
+from cartography.models.core.relationships import CartographyRelProperties
+from cartography.models.core.relationships import CartographyRelSchema
+from cartography.models.core.relationships import LinkDirection
+from cartography.models.core.relationships import make_target_node_matcher
+from cartography.models.core.relationships import OtherRelationships
+from cartography.models.core.relationships import TargetNodeMatcher
+
+
+@dataclass(frozen=True)
+class S1ApplicationVersionNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef("id", extra_index=True)
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+    application_name: PropertyRef = PropertyRef("application_name")
+    application_vendor: PropertyRef = PropertyRef("application_vendor")
+    version: PropertyRef = PropertyRef("version")
+
+
+@dataclass(frozen=True)
+class S1ApplicationVersionToAccountRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:S1ApplicationVersion)<-[:RESOURCE]-(:S1Account)
+class S1ApplicationVersionToAccount(CartographyRelSchema):
+    target_node_label: str = "S1Account"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("S1_ACCOUNT_ID", set_in_kwargs=True)},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "RESOURCE"
+    properties: S1ApplicationVersionToAccountRelProperties = (
+        S1ApplicationVersionToAccountRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class S1AgentToApplicationVersionRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+    installeddatetime: PropertyRef = PropertyRef("installed_dt")
+    installationpath: PropertyRef = PropertyRef("installation_path")
+
+
+@dataclass(frozen=True)
+# (:S1Agent)-[:HAS_INSTALLED]->(:S1ApplicationVersion)
+class S1AgentToS1ApplicationVersion(CartographyRelSchema):
+    target_node_label: str = "S1Agent"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"uuid": PropertyRef("agent_uuid")},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "HAS_INSTALLED"
+    properties: S1AgentToApplicationVersionRelProperties = (
+        S1AgentToApplicationVersionRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class S1ApplicationVersionToApplicationRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:S1ApplicationVersion)<-[:VERSION]-(:S1Application)
+class S1ApplicationVersionToApplication(CartographyRelSchema):
+    target_node_label: str = "S1Application"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("application_id")},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "VERSION"
+    properties: S1ApplicationVersionToApplicationRelProperties = (
+        S1ApplicationVersionToApplicationRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class S1ApplicationVersionSchema(CartographyNodeSchema):
+    label: str = "S1ApplicationVersion"
+    properties: S1ApplicationVersionNodeProperties = (
+        S1ApplicationVersionNodeProperties()
+    )
+    sub_resource_relationship: S1ApplicationVersionToAccount = (
+        S1ApplicationVersionToAccount()
+    )
+    other_relationships: OtherRelationships = OtherRelationships(
+        [
+            S1AgentToS1ApplicationVersion(),
+            S1ApplicationVersionToApplication(),
+        ],
+    )

{cartography-0.107.0rc2.dist-info → cartography-0.108.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cartography
-Version: 0.107.0rc2
+Version: 0.108.0
 Summary: Explore assets and their relationships across your technical infrastructure.
 Maintainer: Cartography Contributors
 License: apache2
@@ -82,14 +82,14 @@ You can learn more about the story behind Cartography in our [presentation at BS
 
 ## Supported platforms
 - [Airbyte](https://cartography-cncf.github.io/cartography/modules/airbyte/index.html) - Organization, Workspace, User, Source, Destination, Connection, Tag, Stream
-- [Amazon Web Services](https://cartography-cncf.github.io/cartography/modules/aws/index.html) - ACM, API Gateway, CloudWatch, CodeBuild, Config, EC2, ECS, ECR, Elasticsearch, Elastic Kubernetes Service (EKS), DynamoDB, IAM, Inspector, KMS, Lambda, RDS, Redshift, Route53, S3, Secrets Manager(Secret Versions), Security Hub, SQS, SSM, STS, Tags
+- [Amazon Web Services](https://cartography-cncf.github.io/cartography/modules/aws/index.html) - ACM, API Gateway, CloudWatch, CodeBuild, Config, EC2, ECS, ECR, Elasticsearch, Elastic Kubernetes Service (EKS), DynamoDB, GuardDuty, IAM, Inspector, KMS, Lambda, RDS, Redshift, Route53, S3, Secrets Manager(Secret Versions), Security Hub, SQS, SSM, STS, Tags
 - [Anthropic](https://cartography-cncf.github.io/cartography/modules/anthropic/index.html) - Organization, ApiKey, User, Workspace
 - [BigFix](https://cartography-cncf.github.io/cartography/modules/bigfix/index.html) - Computers
 - [Cloudflare](https://cartography-cncf.github.io/cartography/modules/cloudflare/index.html) - Account, Role, Member, Zone, DNSRecord
 - [Crowdstrike Falcon](https://cartography-cncf.github.io/cartography/modules/crowdstrike/index.html) - Hosts, Spotlight vulnerabilities, CVEs
 - [DigitalOcean](https://cartography-cncf.github.io/cartography/modules/digitalocean/index.html)
 - [Duo](https://cartography-cncf.github.io/cartography/modules/duo/index.html) - Users, Groups, Endpoints
-- [GitHub](https://cartography-cncf.github.io/cartography/modules/github/index.html) - repos, branches, users, teams
+- [GitHub](https://cartography-cncf.github.io/cartography/modules/github/index.html) - repos, branches, users, teams, dependency graph manifests, dependencies
 - [Google Cloud Platform](https://cartography-cncf.github.io/cartography/modules/gcp/index.html) - Cloud Resource Manager, Compute, DNS, Storage, Google Kubernetes Engine
 - [Google GSuite](https://cartography-cncf.github.io/cartography/modules/gsuite/index.html) - users, groups
 - [Kandji](https://cartography-cncf.github.io/cartography/modules/kandji/index.html) - Devices