cartography 0.104.0rc2__py3-none-any.whl → 0.123.0__py3-none-any.whl

cartography/models/gcp/storage/bucket.py

@@ -0,0 +1,119 @@
+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 GCPBucketNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef("id", extra_index=True)
+    # Preserve legacy field for compatibility with existing queries
+    bucket_id: PropertyRef = PropertyRef("bucket_id")
+    project_number: PropertyRef = PropertyRef("project_number")
+    self_link: PropertyRef = PropertyRef("self_link")
+    kind: PropertyRef = PropertyRef("kind")
+    location: PropertyRef = PropertyRef("location")
+    location_type: PropertyRef = PropertyRef("location_type")
+    meta_generation: PropertyRef = PropertyRef("meta_generation")
+    storage_class: PropertyRef = PropertyRef("storage_class")
+    time_created: PropertyRef = PropertyRef("time_created")
+    retention_period: PropertyRef = PropertyRef("retention_period")
+    iam_config_bucket_policy_only: PropertyRef = PropertyRef(
+        "iam_config_bucket_policy_only"
+    )
+    owner_entity: PropertyRef = PropertyRef("owner_entity")
+    owner_entity_id: PropertyRef = PropertyRef("owner_entity_id")
+    versioning_enabled: PropertyRef = PropertyRef("versioning_enabled")
+    log_bucket: PropertyRef = PropertyRef("log_bucket")
+    requester_pays: PropertyRef = PropertyRef("requester_pays")
+    default_kms_key_name: PropertyRef = PropertyRef("default_kms_key_name")
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class GCPBucketToProjectRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:GCPProject)-[:RESOURCE]->(:GCPBucket)
+class GCPBucketToProjectRel(CartographyRelSchema):
+    target_node_label: str = "GCPProject"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("PROJECT_ID", set_in_kwargs=True)}
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "RESOURCE"
+    properties: GCPBucketToProjectRelProperties = GCPBucketToProjectRelProperties()
+
+
+@dataclass(frozen=True)
+class GCPBucketSchema(CartographyNodeSchema):
+    label: str = "GCPBucket"
+    properties: GCPBucketNodeProperties = GCPBucketNodeProperties()
+    sub_resource_relationship: GCPBucketToProjectRel = GCPBucketToProjectRel()
+
+
+@dataclass(frozen=True)
+class GCPBucketLabelNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef("id", extra_index=True)
+    key: PropertyRef = PropertyRef("key", extra_index=True)
+    value: PropertyRef = PropertyRef("value")
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class GCPBucketLabelToProjectRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:GCPProject)-[:RESOURCE]->(:GCPBucketLabel)
+class GCPBucketLabelToProjectRel(CartographyRelSchema):
+    target_node_label: str = "GCPProject"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("PROJECT_ID", set_in_kwargs=True)}
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "RESOURCE"
+    properties: GCPBucketLabelToProjectRelProperties = (
+        GCPBucketLabelToProjectRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class GCPBucketLabelToBucketRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:GCPBucket)-[:LABELED]->(:GCPBucketLabel)
+class GCPBucketLabelToBucketRel(CartographyRelSchema):
+    target_node_label: str = "GCPBucket"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("bucket_id")}
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "LABELED"
+    properties: GCPBucketLabelToBucketRelProperties = (
+        GCPBucketLabelToBucketRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class GCPBucketLabelSchema(CartographyNodeSchema):
+    label: str = "GCPBucketLabel"
+    properties: GCPBucketLabelNodeProperties = GCPBucketLabelNodeProperties()
+    sub_resource_relationship: GCPBucketLabelToProjectRel = GCPBucketLabelToProjectRel()
+    other_relationships: OtherRelationships = OtherRelationships(
+        [
+            GCPBucketLabelToBucketRel(),
+        ]
+    )

cartography/models/github/commits.py

@@ -0,0 +1,63 @@
+"""
+Data model for GitHub commit tracking, specifically for tracking which GitHubUsers have committed
+to which GitHubRepositories in the last 30 days.
+
+This uses MatchLinks to connect existing GitHubUser nodes to GitHubRepository nodes based on
+commit data from a separate GitHub API call.
+"""
+
+from dataclasses import dataclass
+
+from cartography.models.core.common import PropertyRef
+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_source_node_matcher
+from cartography.models.core.relationships import make_target_node_matcher
+from cartography.models.core.relationships import SourceNodeMatcher
+from cartography.models.core.relationships import TargetNodeMatcher
+
+
+@dataclass(frozen=True)
+class GitHubUserCommittedToRepoRelProperties(CartographyRelProperties):
+    """
+    Properties for the COMMITTED_TO relationship between GitHubUser and GitHubRepository.
+    """
+
+    # Required for all MatchLinks
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+    _sub_resource_label: PropertyRef = PropertyRef(
+        "_sub_resource_label", set_in_kwargs=True
+    )
+    _sub_resource_id: PropertyRef = PropertyRef("_sub_resource_id", set_in_kwargs=True)
+
+    # Rich relationship properties
+    commit_count: PropertyRef = PropertyRef("commit_count")
+    last_commit_date: PropertyRef = PropertyRef("last_commit_date")
+    first_commit_date: PropertyRef = PropertyRef("first_commit_date")
+
+
+@dataclass(frozen=True)
+class GitHubUserCommittedToRepoRel(CartographyRelSchema):
+    """
+    MatchLink schema for connecting GitHubUser nodes to GitHubRepository nodes
+    based on commits in the last 30 days.
+    """
+
+    target_node_label: str = "GitHubRepository"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {
+            "id": PropertyRef("repo_url"),
+        }
+    )
+    source_node_label: str = "GitHubUser"
+    source_node_matcher: SourceNodeMatcher = make_source_node_matcher(
+        {
+            "id": PropertyRef("user_url"),
+        }
+    )
+    direction: LinkDirection = LinkDirection.OUTWARD
+    rel_label: str = "COMMITTED_TO"
+    properties: GitHubUserCommittedToRepoRelProperties = (
+        GitHubUserCommittedToRepoRelProperties()
+    )

cartography/models/github/dependencies.py

@@ -0,0 +1,73 @@
+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")
+    requirements: PropertyRef = PropertyRef("requirements")
+    ecosystem: PropertyRef = PropertyRef("ecosystem")
+    package_manager: PropertyRef = PropertyRef("package_manager")
+    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/github/users.py

@@ -33,6 +33,7 @@ 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
@@ -52,6 +53,9 @@ class BaseGitHubUserNodeProperties(CartographyNodeProperties):
     is_enterprise_owner: PropertyRef = PropertyRef("isEnterpriseOwner")
     email: PropertyRef = PropertyRef("email")
     company: PropertyRef = PropertyRef("company")
+    organization_verified_domain_emails: PropertyRef = PropertyRef(
+        "organizationVerifiedDomainEmails"
+    )
 
 
 @dataclass(frozen=True)
@@ -113,6 +117,9 @@ class GitHubUserUnaffiliatedOrganizationRel(CartographyRelSchema):
 @dataclass(frozen=True)
 class GitHubOrganizationUserSchema(CartographyNodeSchema):
     label: str = "GitHubUser"
+    extra_node_labels: ExtraNodeLabels = ExtraNodeLabels(
+        ["UserAccount"]
+    )  # UserAccount label is used for ontology mapping
     properties: GitHubOrganizationUserNodeProperties = (
         GitHubOrganizationUserNodeProperties()
     )
@@ -128,6 +135,9 @@ class GitHubOrganizationUserSchema(CartographyNodeSchema):
 @dataclass(frozen=True)
 class GitHubUnaffiliatedUserSchema(CartographyNodeSchema):
     label: str = "GitHubUser"
+    extra_node_labels: ExtraNodeLabels = ExtraNodeLabels(
+        ["UserAccount"]
+    )  # UserAccount label is used for ontology mapping
     properties: GitHubUnaffiliatedUserNodeProperties = (
         GitHubUnaffiliatedUserNodeProperties()
     )

cartography/models/googleworkspace/device.py

@@ -0,0 +1,132 @@
+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 GoogleWorkspaceDeviceNodeProperties(CartographyNodeProperties):
+    """
+    Google Workspace device node properties
+    """
+
+    id: PropertyRef = PropertyRef("deviceId")
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+    hostname: PropertyRef = PropertyRef("hostname", extra_index=True)
+
+    # Device information
+    model: PropertyRef = PropertyRef("model")
+    manufacturer: PropertyRef = PropertyRef("manufacturer")
+    release_version: PropertyRef = PropertyRef("releaseVersion")
+    brand: PropertyRef = PropertyRef("brand")
+    build_number: PropertyRef = PropertyRef("buildNumber")
+    kernel_version: PropertyRef = PropertyRef("kernelVersion")
+    baseband_version: PropertyRef = PropertyRef("basebandVersion")
+    device_type: PropertyRef = PropertyRef("deviceType")
+    os_version: PropertyRef = PropertyRef("osVersion")
+    owner_type: PropertyRef = PropertyRef("ownerType")
+    serial_number: PropertyRef = PropertyRef("serialNumber")
+    asset_tag: PropertyRef = PropertyRef("assetTag")
+    imei: PropertyRef = PropertyRef("imei")
+    meid: PropertyRef = PropertyRef("meid")
+    wifi_mac_addresses: PropertyRef = PropertyRef("wifiMacAddresses")
+    network_operator: PropertyRef = PropertyRef("networkOperator")
+
+    # Security and state
+    encryption_state: PropertyRef = PropertyRef("encryptionState")
+    compromised_state: PropertyRef = PropertyRef("compromisedState")
+    management_state: PropertyRef = PropertyRef("managementState")
+
+    # Timestamps
+    create_time: PropertyRef = PropertyRef("createTime")
+    last_sync_time: PropertyRef = PropertyRef("lastSyncTime")
+    security_patch_time: PropertyRef = PropertyRef("securityPatchTime")
+
+    # Android specific
+    android_specific_attributes: PropertyRef = PropertyRef("androidSpecificAttributes")
+    enabled_developer_options: PropertyRef = PropertyRef("enabledDeveloperOptions")
+    enabled_usb_debugging: PropertyRef = PropertyRef("enabledUsbDebugging")
+    bootloader_version: PropertyRef = PropertyRef("bootloaderVersion")
+    other_accounts: PropertyRef = PropertyRef("otherAccounts")
+
+    # Additional identifiers
+    unified_device_id: PropertyRef = PropertyRef("unifiedDeviceId")
+    endpoint_verification_specific_attributes: PropertyRef = PropertyRef(
+        "endpointVerificationSpecificAttributes"
+    )
+
+    # Tenant relationship
+    customer_id: PropertyRef = PropertyRef("CUSTOMER_ID", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class GoogleWorkspaceDeviceToTenantRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class GoogleWorkspaceDeviceToTenantRel(CartographyRelSchema):
+    """
+    Relationship from Google Workspace device to Google Workspace tenant
+    """
+
+    target_node_label: str = "GoogleWorkspaceTenant"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {
+            "id": PropertyRef("CUSTOMER_ID", set_in_kwargs=True),
+        }
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "RESOURCE"
+    properties: GoogleWorkspaceDeviceToTenantRelProperties = (
+        GoogleWorkspaceDeviceToTenantRelProperties()
+    )
+
+
+# Direct relationship from GoogleWorkspaceUser to GoogleWorkspaceDevice
+@dataclass(frozen=True)
+class GoogleWorkspaceUserToDeviceRelProperties(CartographyRelProperties):
+    # Required for all MatchLinks
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class GoogleWorkspaceUserToDeviceRel(CartographyRelSchema):
+    target_node_label: str = "GoogleWorkspaceUser"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {
+            "primary_email": PropertyRef("owner_email"),
+        }
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "OWNS"
+    properties: GoogleWorkspaceUserToDeviceRelProperties = (
+        GoogleWorkspaceUserToDeviceRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class GoogleWorkspaceDeviceSchema(CartographyNodeSchema):
+    """
+    Google Workspace device node schema
+    """
+
+    label: str = "GoogleWorkspaceDevice"
+    properties: GoogleWorkspaceDeviceNodeProperties = (
+        GoogleWorkspaceDeviceNodeProperties()
+    )
+    sub_resource_relationship: GoogleWorkspaceDeviceToTenantRel = (
+        GoogleWorkspaceDeviceToTenantRel()
+    )
+    other_relationships: OtherRelationships = OtherRelationships(
+        [
+            GoogleWorkspaceUserToDeviceRel(),
+        ]
+    )