cartography 0.102.0rc2__py3-none-any.whl → 0.103.0__py3-none-any.whl

cartography/models/snipeit/asset.py

@@ -16,18 +16,19 @@ class SnipeitAssetNodeProperties(CartographyNodeProperties):
     """
     https://snipe-it.readme.io/reference/hardware-list
     """
+
     # Common properties
-    id: PropertyRef = PropertyRef('id')
-    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+    id: PropertyRef = PropertyRef("id")
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
 
     # SnipeIT specific properties
-    asset_tag: PropertyRef = PropertyRef('asset_tag')
-    assigned_to: PropertyRef = PropertyRef('assigned_to.email')
-    category: PropertyRef = PropertyRef('category.name')
-    company: PropertyRef = PropertyRef('company.name')
-    manufacturer: PropertyRef = PropertyRef('manufacturer.name')
-    model: PropertyRef = PropertyRef('model.name')
-    serial: PropertyRef = PropertyRef('serial', extra_index=True)
+    asset_tag: PropertyRef = PropertyRef("asset_tag")
+    assigned_to: PropertyRef = PropertyRef("assigned_to.email")
+    category: PropertyRef = PropertyRef("category.name")
+    company: PropertyRef = PropertyRef("company.name")
+    manufacturer: PropertyRef = PropertyRef("manufacturer.name")
+    model: PropertyRef = PropertyRef("model.name")
+    serial: PropertyRef = PropertyRef("serial", extra_index=True)
 
 
 ###
@@ -35,45 +36,53 @@ class SnipeitAssetNodeProperties(CartographyNodeProperties):
 ###
 @dataclass(frozen=True)
 class SnipeitTenantToSnipeitAssetRelProperties(CartographyRelProperties):
-    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
 
 
 @dataclass(frozen=True)
 class SnipeitTenantToSnipeitAssetRel(CartographyRelSchema):
-    target_node_label: str = 'SnipeitTenant'
+    target_node_label: str = "SnipeitTenant"
     target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
-        {'id': PropertyRef('TENANT_ID', set_in_kwargs=True)},
+        {"id": PropertyRef("TENANT_ID", set_in_kwargs=True)},
     )
     direction: LinkDirection = LinkDirection.INWARD
     rel_label: str = "HAS_ASSET"
-    properties: SnipeitTenantToSnipeitAssetRelProperties = SnipeitTenantToSnipeitAssetRelProperties()
+    properties: SnipeitTenantToSnipeitAssetRelProperties = (
+        SnipeitTenantToSnipeitAssetRelProperties()
+    )
 
 
 ###
 # (:SnipeitUser)-[:HAS_CHECKED_OUT]->(:SnipeitAsset)
 ###
 @dataclass(frozen=True)
-class SnipeitUserToSnipeitAssetProperties(CartographyRelProperties):
-    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+class SnipeitUserToSnipeitAssetRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
 
 
 @dataclass(frozen=True)
 class SnipeitUserToSnipeitAssetRel(CartographyRelSchema):
-    target_node_label: str = 'SnipeitUser'
+    target_node_label: str = "SnipeitUser"
     target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
-        {'email': PropertyRef('assigned_to.email')},
+        {"email": PropertyRef("assigned_to.email")},
     )
     direction: LinkDirection = LinkDirection.INWARD
     rel_label: str = "HAS_CHECKED_OUT"
-    properties: SnipeitUserToSnipeitAssetProperties = SnipeitUserToSnipeitAssetProperties()
+    properties: SnipeitUserToSnipeitAssetRelProperties = (
+        SnipeitUserToSnipeitAssetRelProperties()
+    )
 
 
 ###
 @dataclass(frozen=True)
 class SnipeitAssetSchema(CartographyNodeSchema):
-    label: str = 'SnipeitAsset'  # The label of the node
-    properties: SnipeitAssetNodeProperties = SnipeitAssetNodeProperties()  # An object representing all properties
-    sub_resource_relationship: SnipeitTenantToSnipeitAssetRel = SnipeitTenantToSnipeitAssetRel()
+    label: str = "SnipeitAsset"  # The label of the node
+    properties: SnipeitAssetNodeProperties = (
+        SnipeitAssetNodeProperties()
+    )  # An object representing all properties
+    sub_resource_relationship: SnipeitTenantToSnipeitAssetRel = (
+        SnipeitTenantToSnipeitAssetRel()
+    )
     other_relationships: OtherRelationships = OtherRelationships(
         [
             SnipeitUserToSnipeitAssetRel(),

cartography/models/snipeit/tenant.py

@@ -7,11 +7,13 @@ from cartography.models.core.nodes import CartographyNodeSchema
 
 @dataclass(frozen=True)
 class SnipeitTenantNodeProperties(CartographyNodeProperties):
-    id: PropertyRef = PropertyRef('id')
-    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+    id: PropertyRef = PropertyRef("id")
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
 
 
 @dataclass(frozen=True)
 class SnipeitTenantSchema(CartographyNodeSchema):
-    label: str = 'SnipeitTenant'  # The label of the node
-    properties: SnipeitTenantNodeProperties = SnipeitTenantNodeProperties()  # An object representing all properties
+    label: str = "SnipeitTenant"  # The label of the node
+    properties: SnipeitTenantNodeProperties = (
+        SnipeitTenantNodeProperties()
+    )  # An object representing all properties

cartography/models/snipeit/user.py

@@ -15,35 +15,42 @@ class SnipeitUserNodeProperties(CartographyNodeProperties):
     """
     Ref: https://snipe-it.readme.io/reference/users
     """
+
     # Common properties
-    id: PropertyRef = PropertyRef('id')
-    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+    id: PropertyRef = PropertyRef("id")
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
 
     # SnipeIT specific properties
-    company: PropertyRef = PropertyRef('company_id.name', extra_index=True)
-    email: PropertyRef = PropertyRef('email', extra_index=True)
-    username: PropertyRef = PropertyRef('username')
+    company: PropertyRef = PropertyRef("company_id.name", extra_index=True)
+    email: PropertyRef = PropertyRef("email", extra_index=True)
+    username: PropertyRef = PropertyRef("username")
 
 
 @dataclass(frozen=True)
 class SnipeitTenantToSnipeitUserRelProperties(CartographyRelProperties):
-    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
 
 
 @dataclass(frozen=True)
 # (:SnipeitTenant)-[:HAS_USER]->(:SnipeitUser)
 class SnipeitTenantToSnipeitUserRel(CartographyRelSchema):
-    target_node_label: str = 'SnipeitTenant'
+    target_node_label: str = "SnipeitTenant"
     target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
-        {'id': PropertyRef('TENANT_ID', set_in_kwargs=True)},
+        {"id": PropertyRef("TENANT_ID", set_in_kwargs=True)},
     )
     direction: LinkDirection = LinkDirection.INWARD
     rel_label: str = "HAS_USER"
-    properties: SnipeitTenantToSnipeitUserRelProperties = SnipeitTenantToSnipeitUserRelProperties()
+    properties: SnipeitTenantToSnipeitUserRelProperties = (
+        SnipeitTenantToSnipeitUserRelProperties()
+    )
 
 
 @dataclass(frozen=True)
 class SnipeitUserSchema(CartographyNodeSchema):
-    label: str = 'SnipeitUser'  # The label of the node
-    properties: SnipeitUserNodeProperties = SnipeitUserNodeProperties()  # An object representing all properties
-    sub_resource_relationship: SnipeitTenantToSnipeitUserRel = SnipeitTenantToSnipeitUserRel()
+    label: str = "SnipeitUser"  # The label of the node
+    properties: SnipeitUserNodeProperties = (
+        SnipeitUserNodeProperties()
+    )  # An object representing all properties
+    sub_resource_relationship: SnipeitTenantToSnipeitUserRel = (
+        SnipeitTenantToSnipeitUserRel()
+    )

cartography/models/tailscale/device.py

@@ -0,0 +1,95 @@
+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 TailscaleDeviceNodeProperties(CartographyNodeProperties):
+    # We use nodeId because the old property `id` is deprecated
+    id: PropertyRef = PropertyRef("nodeId")
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+    name: PropertyRef = PropertyRef("name")
+    hostname: PropertyRef = PropertyRef("hostname")
+    client_version: PropertyRef = PropertyRef("clientVersion")
+    update_available: PropertyRef = PropertyRef("updateAvailable")
+    os: PropertyRef = PropertyRef("os")
+    created: PropertyRef = PropertyRef("created")
+    last_seen: PropertyRef = PropertyRef("lastSeen")
+    key_expiry_disabled: PropertyRef = PropertyRef("keyExpiryDisabled")
+    expires: PropertyRef = PropertyRef("expires")
+    authorized: PropertyRef = PropertyRef("authorized")
+    is_external: PropertyRef = PropertyRef("isExternal")
+    node_key: PropertyRef = PropertyRef("nodeKey")
+    blocks_incoming_connections: PropertyRef = PropertyRef("blocksIncomingConnections")
+    client_connectivity_endpoints: PropertyRef = PropertyRef(
+        "clientConnectivity.endpoints"
+    )
+    client_connectivity_mapping_varies_by_dest_ip: PropertyRef = PropertyRef(
+        "clientConnectivity.mappingVariesByDestIP"
+    )
+    tailnet_lock_error: PropertyRef = PropertyRef("tailnetLockError")
+    tailnet_lock_key: PropertyRef = PropertyRef("tailnetLockKey")
+    posture_identity_serial_numbers: PropertyRef = PropertyRef(
+        "postureIdentity.serialNumbers"
+    )
+    posture_identity_disabled: PropertyRef = PropertyRef("postureIdentity.disabled")
+
+
+@dataclass(frozen=True)
+class TailscaleDeviceToTailnetRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:TailscaleTailnet)-[:RESOURCE]->(:TailscaleDevice)
+class TailscaleDeviceToTailnetRel(CartographyRelSchema):
+    target_node_label: str = "TailscaleTailnet"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("org", set_in_kwargs=True)},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "RESOURCE"
+    properties: TailscaleDeviceToTailnetRelProperties = (
+        TailscaleDeviceToTailnetRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class TailscaleDeviceToUserRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:TailscaleUser)-[:OWNS]->(:TailscaleDevice)
+class TailscaleDeviceToUserRel(CartographyRelSchema):
+    target_node_label: str = "TailscaleUser"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"login_name": PropertyRef("user")},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "OWNS"
+    properties: TailscaleDeviceToUserRelProperties = (
+        TailscaleDeviceToUserRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class TailscaleDeviceSchema(CartographyNodeSchema):
+    label: str = "TailscaleDevice"
+    properties: TailscaleDeviceNodeProperties = TailscaleDeviceNodeProperties()
+    sub_resource_relationship: TailscaleDeviceToTailnetRel = (
+        TailscaleDeviceToTailnetRel()
+    )
+    other_relationships = OtherRelationships(
+        [
+            TailscaleDeviceToUserRel(),
+        ]
+    )

cartography/models/tailscale/group.py

@@ -0,0 +1,86 @@
+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 TailscaleGroupNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef("id")
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+    name: PropertyRef = PropertyRef("name")
+
+
+@dataclass(frozen=True)
+class TailscaleGroupToTailnetRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:TailscaleTailnet)-[:RESOURCE]->(:TailscaleGroup)
+class TailscaleGroupToTailnetRel(CartographyRelSchema):
+    target_node_label: str = "TailscaleTailnet"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("org", set_in_kwargs=True)},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "RESOURCE"
+    properties: TailscaleGroupToTailnetRelProperties = (
+        TailscaleGroupToTailnetRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class TailscaleGroupToUserRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:TailscaleUser)-[:MEMBER_OF]->(:TailscaleGroup)
+class TailscaleGroupToUserRel(CartographyRelSchema):
+    target_node_label: str = "TailscaleUser"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"login_name": PropertyRef("members", one_to_many=True)},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "MEMBER_OF"
+    properties: TailscaleGroupToUserRelProperties = TailscaleGroupToUserRelProperties()
+
+
+@dataclass(frozen=True)
+class TailscaleGroupToGroupRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:TailscaleGroup)-[:MEMBER_OF]->(:TailscaleGroup)
+class TailscaleGroupToGroupRel(CartographyRelSchema):
+    target_node_label: str = "TailscaleGroup"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("sub_groups", one_to_many=True)},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "MEMBER_OF"
+    properties: TailscaleGroupToGroupRelProperties = (
+        TailscaleGroupToGroupRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class TailscaleGroupSchema(CartographyNodeSchema):
+    label: str = "TailscaleGroup"
+    properties: TailscaleGroupNodeProperties = TailscaleGroupNodeProperties()
+    sub_resource_relationship: TailscaleGroupToTailnetRel = TailscaleGroupToTailnetRel()
+    other_relationships = OtherRelationships(
+        [
+            TailscaleGroupToGroupRel(),
+            TailscaleGroupToUserRel(),
+        ]
+    )

cartography/models/tailscale/postureintegration.py

@@ -0,0 +1,58 @@
+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 TailscalePostureIntegrationNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef("id")
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+    provider: PropertyRef = PropertyRef("provider")
+    cloud_id: PropertyRef = PropertyRef("cloudId")
+    client_id: PropertyRef = PropertyRef("clientId")
+    tenant_id: PropertyRef = PropertyRef("tenantId")
+    config_updated: PropertyRef = PropertyRef("configUpdated")
+    status_last_sync: PropertyRef = PropertyRef("status.lastSync")
+    status_error: PropertyRef = PropertyRef("status.error")
+    status_provider_host_count: PropertyRef = PropertyRef("status.providerHostCount")
+    status_matched_count: PropertyRef = PropertyRef("status.matchedCount")
+    status_possible_matched_count: PropertyRef = PropertyRef(
+        "status.possibleMatchedCount"
+    )
+
+
+@dataclass(frozen=True)
+class TailscalePostureIntegrationToTailnetRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:TailscaleTailnet)-[:RESOURCE]->(:TailscalePostureIntegration)
+class TailscalePostureIntegrationToTailnetRel(CartographyRelSchema):
+    target_node_label: str = "TailscaleTailnet"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("org", set_in_kwargs=True)},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "RESOURCE"
+    properties: TailscalePostureIntegrationToTailnetRelProperties = (
+        TailscalePostureIntegrationToTailnetRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class TailscalePostureIntegrationSchema(CartographyNodeSchema):
+    label: str = "TailscalePostureIntegration"
+    properties: TailscalePostureIntegrationNodeProperties = (
+        TailscalePostureIntegrationNodeProperties()
+    )
+    sub_resource_relationship: TailscalePostureIntegrationToTailnetRel = (
+        TailscalePostureIntegrationToTailnetRel()
+    )

cartography/models/tailscale/tag.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.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 TailscaleTagNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef("id")
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+    name: PropertyRef = PropertyRef("name")
+
+
+@dataclass(frozen=True)
+class TailscaleTagToTailnetRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:TailscaleTailnet)-[:RESOURCE]->(:TailscaleTag)
+class TailscaleTagToTailnetRel(CartographyRelSchema):
+    target_node_label: str = "TailscaleTailnet"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("org", set_in_kwargs=True)},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "RESOURCE"
+    properties: TailscaleTagToTailnetRelProperties = (
+        TailscaleTagToTailnetRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class TailscaleTagToUserRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:TailscaleUser)-[:OWNS]->(:TailscaleTag)
+class TailscaleTagToUserRel(CartographyRelSchema):
+    target_node_label: str = "TailscaleUser"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"login_name": PropertyRef("owners", one_to_many=True)},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "OWNS"
+    properties: TailscaleTagToUserRelProperties = TailscaleTagToUserRelProperties()
+
+
+@dataclass(frozen=True)
+class TailscaleTagToGroupRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:TailscaleGroup)-[:OWNS]->(:TailscaleTag)
+class TailscaleTagToGroupRel(CartographyRelSchema):
+    target_node_label: str = "TailscaleGroup"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("group_owners", one_to_many=True)},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "OWNS"
+    properties: TailscaleTagToGroupRelProperties = TailscaleTagToGroupRelProperties()
+
+
+@dataclass(frozen=True)
+class TailscaleTagToDeviceRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:TailscaleDevice)-[:TAGGED]->(:TailscaleTag)
+class TailscaleTagToDeviceRel(CartographyRelSchema):
+    target_node_label: str = "TailscaleDevice"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("devices", one_to_many=True)},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "TAGGED"
+    properties: TailscaleTagToDeviceRelProperties = TailscaleTagToDeviceRelProperties()
+
+
+@dataclass(frozen=True)
+class TailscaleTagSchema(CartographyNodeSchema):
+    label: str = "TailscaleTag"
+    properties: TailscaleTagNodeProperties = TailscaleTagNodeProperties()
+    sub_resource_relationship: TailscaleTagToTailnetRel = TailscaleTagToTailnetRel()
+    other_relationships = OtherRelationships(
+        [
+            TailscaleTagToGroupRel(),
+            TailscaleTagToUserRel(),
+            TailscaleTagToDeviceRel(),
+        ]
+    )

cartography/models/tailscale/tailnet.py

@@ -0,0 +1,29 @@
+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
+
+
+@dataclass(frozen=True)
+class TailscaleTailnetNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef("org", set_in_kwargs=True)
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+    devices_approval_on: PropertyRef = PropertyRef("devicesApprovalOn")
+    devices_auto_updates_on: PropertyRef = PropertyRef("devicesAutoUpdatesOn")
+    devices_key_duration_days: PropertyRef = PropertyRef("devicesKeyDurationDays")
+    users_approval_on: PropertyRef = PropertyRef("usersApprovalOn")
+    users_role_allowed_to_join_external_tailnets: PropertyRef = PropertyRef(
+        "usersRoleAllowedToJoinExternalTailnets"
+    )
+    network_flow_logging_on: PropertyRef = PropertyRef("networkFlowLoggingOn")
+    regional_routing_on: PropertyRef = PropertyRef("regionalRoutingOn")
+    posture_identity_collection_on: PropertyRef = PropertyRef(
+        "postureIdentityCollectionOn"
+    )
+
+
+@dataclass(frozen=True)
+class TailscaleTailnetSchema(CartographyNodeSchema):
+    label: str = "TailscaleTailnet"
+    properties: TailscaleTailnetNodeProperties = TailscaleTailnetNodeProperties()

cartography/models/tailscale/user.py

@@ -0,0 +1,52 @@
+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 TailscaleUserNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef("id")
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+    display_name: PropertyRef = PropertyRef("displayName")
+    login_name: PropertyRef = PropertyRef("loginName", extra_index=True)
+    profile_pic_url: PropertyRef = PropertyRef("profilePicUrl")
+    created: PropertyRef = PropertyRef("created")
+    type: PropertyRef = PropertyRef("type")
+    role: PropertyRef = PropertyRef("role")
+    status: PropertyRef = PropertyRef("status")
+    device_count: PropertyRef = PropertyRef("deviceCount")
+    last_seen: PropertyRef = PropertyRef("lastSeen")
+    currently_connected: PropertyRef = PropertyRef("currentlyConnected")
+
+
+@dataclass(frozen=True)
+class TailscaleUserToTailnetRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef("lastupdated", set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:TailscaleTailnet)-[:RESOURCE]->(:TailscaleUser)
+class TailscaleUserToTailnetRel(CartographyRelSchema):
+    target_node_label: str = "TailscaleTailnet"
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {"id": PropertyRef("org", set_in_kwargs=True)},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "RESOURCE"
+    properties: TailscaleUserToTailnetRelProperties = (
+        TailscaleUserToTailnetRelProperties()
+    )
+
+
+@dataclass(frozen=True)
+class TailscaleUserSchema(CartographyNodeSchema):
+    label: str = "TailscaleUser"
+    properties: TailscaleUserNodeProperties = TailscaleUserNodeProperties()
+    sub_resource_relationship: TailscaleUserToTailnetRel = TailscaleUserToTailnetRel()

cartography/stats.py

@@ -17,11 +17,11 @@ class ScopedStatsClient:
 
     _client: StatsClient = None
 
-    def __init__(self, prefix: Optional[str], root: 'ScopedStatsClient'):
+    def __init__(self, prefix: Optional[str], root: "ScopedStatsClient"):
         self._scope_prefix = prefix
         self._root = root
 
-    def get_stats_client(self, scope: str) -> 'ScopedStatsClient':
+    def get_stats_client(self, scope: str) -> "ScopedStatsClient":
         """
         This method returns a new proxy to the same client
         which will prefix all calls to underlying methods with the scoped prefix
@@ -35,7 +35,7 @@ class ScopedStatsClient:
         return scoped_stats_client
 
     @staticmethod
-    def get_root_client() -> 'ScopedStatsClient':
+    def get_root_client() -> "ScopedStatsClient":
         client = ScopedStatsClient(prefix=None, root=None)  # type: ignore
         client._root = client
         return client