cartography 0.101.1rc2__py3-none-any.whl → 0.102.0rc2__py3-none-any.whl

cartography/models/aws/ec2/load_balancers.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 LoadBalancerNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef('id')
+    name: PropertyRef = PropertyRef('name')
+    dnsname: PropertyRef = PropertyRef('dnsname', extra_index=True)
+    canonicalhostedzonename: PropertyRef = PropertyRef('canonicalhostedzonename')
+    canonicalhostedzonenameid: PropertyRef = PropertyRef('canonicalhostedzonenameid')
+    scheme: PropertyRef = PropertyRef('scheme')
+    region: PropertyRef = PropertyRef('Region', set_in_kwargs=True)
+    createdtime: PropertyRef = PropertyRef('createdtime')
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class LoadBalancerToAWSAccountRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class LoadBalancerToAWSAccount(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: LoadBalancerToAWSAccountRelProperties = LoadBalancerToAWSAccountRelProperties()
+
+
+@dataclass(frozen=True)
+class LoadBalancerToSecurityGroupRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class LoadBalancerToSourceSecurityGroup(CartographyRelSchema):
+    target_node_label: str = 'EC2SecurityGroup'
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {'name': PropertyRef('GROUP_NAME')},
+    )
+    direction: LinkDirection = LinkDirection.OUTWARD
+    rel_label: str = "SOURCE_SECURITY_GROUP"
+    properties: LoadBalancerToSecurityGroupRelProperties = LoadBalancerToSecurityGroupRelProperties()
+
+
+@dataclass(frozen=True)
+class LoadBalancerToEC2SecurityGroupRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class LoadBalancerToEC2SecurityGroup(CartographyRelSchema):
+    target_node_label: str = 'EC2SecurityGroup'
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {'groupid': PropertyRef('GROUP_IDS', one_to_many=True)},
+    )
+    direction: LinkDirection = LinkDirection.OUTWARD
+    rel_label: str = "MEMBER_OF_EC2_SECURITY_GROUP"
+    properties: LoadBalancerToEC2SecurityGroupRelProperties = LoadBalancerToEC2SecurityGroupRelProperties()
+
+
+@dataclass(frozen=True)
+class LoadBalancerToEC2InstanceRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class LoadBalancerToEC2Instance(CartographyRelSchema):
+    target_node_label: str = 'EC2Instance'
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {'instanceid': PropertyRef('INSTANCE_IDS', one_to_many=True)},
+    )
+    direction: LinkDirection = LinkDirection.OUTWARD
+    rel_label: str = "EXPOSE"
+    properties: LoadBalancerToEC2InstanceRelProperties = LoadBalancerToEC2InstanceRelProperties()
+
+
+@dataclass(frozen=True)
+class LoadBalancerSchema(CartographyNodeSchema):
+    label: str = 'LoadBalancer'
+    properties: LoadBalancerNodeProperties = LoadBalancerNodeProperties()
+    sub_resource_relationship: LoadBalancerToAWSAccount = LoadBalancerToAWSAccount()
+    other_relationships: OtherRelationships = OtherRelationships(
+        [
+            LoadBalancerToSourceSecurityGroup(),
+            LoadBalancerToEC2SecurityGroup(),
+            LoadBalancerToEC2Instance(),
+        ],
+    )

cartography/models/aws/ec2/route_table_associations.py

@@ -0,0 +1,87 @@
+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 RouteTableAssociationNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef('id')
+    route_table_association_id: PropertyRef = PropertyRef('id', extra_index=True)
+    target: PropertyRef = PropertyRef('_target')
+    gateway_id: PropertyRef = PropertyRef('gateway_id')
+    main: PropertyRef = PropertyRef('main')
+    route_table_id: PropertyRef = PropertyRef('route_table_id')
+    subnet_id: PropertyRef = PropertyRef('subnet_id')
+    association_state: PropertyRef = PropertyRef('association_state')
+    association_state_message: PropertyRef = PropertyRef('association_state_message')
+    region: PropertyRef = PropertyRef('Region', set_in_kwargs=True)
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class RouteTableAssociationToAwsAccountRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class RouteTableAssociationToAWSAccount(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: RouteTableAssociationToAwsAccountRelProperties = RouteTableAssociationToAwsAccountRelProperties()
+
+
+@dataclass(frozen=True)
+class RouteTableAssociationToSubnetRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class RouteTableAssociationToSubnet(CartographyRelSchema):
+    target_node_label: str = 'EC2Subnet'
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {'subnetid': PropertyRef('subnet_id')},
+    )
+    direction: LinkDirection = LinkDirection.OUTWARD
+    rel_label: str = "ASSOCIATED_SUBNET"
+    properties: RouteTableAssociationToSubnetRelProperties = RouteTableAssociationToSubnetRelProperties()
+
+
+@dataclass(frozen=True)
+class RouteTableAssociationToIgwRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class RouteTableAssociationToIgw(CartographyRelSchema):
+    target_node_label: str = 'AWSInternetGateway'
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {'id': PropertyRef('gateway_id')},
+    )
+    direction: LinkDirection = LinkDirection.OUTWARD
+    rel_label: str = "ASSOCIATED_IGW_FOR_INGRESS"
+    properties: RouteTableAssociationToIgwRelProperties = RouteTableAssociationToIgwRelProperties()
+
+
+@dataclass(frozen=True)
+class RouteTableAssociationSchema(CartographyNodeSchema):
+    label: str = 'EC2RouteTableAssociation'
+    properties: RouteTableAssociationNodeProperties = RouteTableAssociationNodeProperties()
+    sub_resource_relationship: RouteTableAssociationToAWSAccount = RouteTableAssociationToAWSAccount()
+    other_relationships: OtherRelationships = OtherRelationships(
+        [
+            RouteTableAssociationToSubnet(),
+            RouteTableAssociationToIgw(),
+        ],
+    )

cartography/models/aws/ec2/route_tables.py

@@ -0,0 +1,121 @@
+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 RouteTableNodeProperties(CartographyNodeProperties):
+    """
+    Schema describing a RouteTable.
+    """
+    id: PropertyRef = PropertyRef('id')
+    route_table_id: PropertyRef = PropertyRef('route_table_id', extra_index=True)
+    owner_id: PropertyRef = PropertyRef('owner_id')
+    vpc_id: PropertyRef = PropertyRef('VpcId')
+    region: PropertyRef = PropertyRef('Region', set_in_kwargs=True)
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+    main: PropertyRef = PropertyRef('main')
+
+
+@dataclass(frozen=True)
+class RouteTableToAwsAccountRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class RouteTableToAWSAccount(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: RouteTableToAwsAccountRelProperties = RouteTableToAwsAccountRelProperties()
+
+
+@dataclass(frozen=True)
+class RouteTableToVpcRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class RouteTableToVpc(CartographyRelSchema):
+    target_node_label: str = 'AWSVpc'
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {'id': PropertyRef('vpc_id')},
+    )
+    direction: LinkDirection = LinkDirection.OUTWARD
+    rel_label: str = "MEMBER_OF_AWS_VPC"
+    properties: RouteTableToVpcRelProperties = RouteTableToVpcRelProperties()
+
+
+@dataclass(frozen=True)
+class RouteTableToRouteRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class RouteTableToRoute(CartographyRelSchema):
+    target_node_label: str = 'EC2Route'
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {'id': PropertyRef('RouteIds', one_to_many=True)},
+    )
+    direction: LinkDirection = LinkDirection.OUTWARD
+    rel_label: str = "ROUTE"
+    properties: RouteTableToRouteRelProperties = RouteTableToRouteRelProperties()
+
+
+@dataclass(frozen=True)
+class RouteTableToAssociationRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class RouteTableToAssociation(CartographyRelSchema):
+    target_node_label: str = 'EC2RouteTableAssociation'
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {'id': PropertyRef('RouteTableAssociationIds', one_to_many=True)},
+    )
+    direction: LinkDirection = LinkDirection.OUTWARD
+    rel_label: str = "ASSOCIATION"
+    properties: RouteTableToAssociationRelProperties = RouteTableToAssociationRelProperties()
+
+
+@dataclass(frozen=True)
+class RouteTableToVpnGatewayRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+# TODO implement AWSVpnGateways
+@dataclass(frozen=True)
+class RouteTableToVpnGateway(CartographyRelSchema):
+    target_node_label: str = 'AWSVpnGateway'
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {'id': PropertyRef('VpnGatewayIds', one_to_many=True)},
+    )
+    direction: LinkDirection = LinkDirection.OUTWARD
+    rel_label: str = "CONNECTED_TO"
+    properties: RouteTableToVpnGatewayRelProperties = RouteTableToVpnGatewayRelProperties()
+
+
+@dataclass(frozen=True)
+class RouteTableSchema(CartographyNodeSchema):
+    label: str = 'EC2RouteTable'
+    properties: RouteTableNodeProperties = RouteTableNodeProperties()
+    sub_resource_relationship: RouteTableToAWSAccount = RouteTableToAWSAccount()
+    other_relationships: OtherRelationships = OtherRelationships(
+        [
+            RouteTableToVpc(),
+            RouteTableToRoute(),
+            RouteTableToAssociation(),
+            RouteTableToVpnGateway(),
+        ],
+    )

cartography/models/aws/ec2/routes.py

@@ -0,0 +1,77 @@
+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 RouteNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef('id')
+    carrier_gateway_id: PropertyRef = PropertyRef('carrier_gateway_id')
+    core_network_arn: PropertyRef = PropertyRef('core_network_arn')
+    destination_cidr_block: PropertyRef = PropertyRef('destination_cidr_block')
+    destination_ipv6_cidr_block: PropertyRef = PropertyRef('destination_ipv6_cidr_block')
+    destination_prefix_list_id: PropertyRef = PropertyRef('destination_prefix_list_id')
+    egress_only_internet_gateway_id: PropertyRef = PropertyRef('egress_only_internet_gateway_id')
+    gateway_id: PropertyRef = PropertyRef('gateway_id')
+    instance_id: PropertyRef = PropertyRef('instance_id')
+    instance_owner_id: PropertyRef = PropertyRef('instance_owner_id')
+    local_gateway_id: PropertyRef = PropertyRef('local_gateway_id')
+    nat_gateway_id: PropertyRef = PropertyRef('nat_gateway_id')
+    network_interface_id: PropertyRef = PropertyRef('network_interface_id')
+    origin: PropertyRef = PropertyRef('origin')
+    state: PropertyRef = PropertyRef('state')
+    transit_gateway_id: PropertyRef = PropertyRef('transit_gateway_id')
+    vpc_peering_connection_id: PropertyRef = PropertyRef('vpc_peering_connection_id')
+    region: PropertyRef = PropertyRef('Region', set_in_kwargs=True)
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+    target: PropertyRef = PropertyRef('_target')
+
+
+@dataclass(frozen=True)
+class RouteToAwsAccountRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class RouteToAWSAccount(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: RouteToAwsAccountRelProperties = RouteToAwsAccountRelProperties()
+
+
+@dataclass(frozen=True)
+class RouteToInternetGatewayRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class RouteToInternetGateway(CartographyRelSchema):
+    target_node_label: str = 'AWSInternetGateway'
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {'id': PropertyRef('gateway_id')},
+    )
+    direction: LinkDirection = LinkDirection.OUTWARD
+    rel_label: str = "ROUTES_TO_GATEWAY"
+    properties: RouteToInternetGatewayRelProperties = RouteToInternetGatewayRelProperties()
+
+
+@dataclass(frozen=True)
+class RouteSchema(CartographyNodeSchema):
+    label: str = 'EC2Route'
+    properties: RouteNodeProperties = RouteNodeProperties()
+    sub_resource_relationship: RouteToAWSAccount = RouteToAWSAccount()
+    other_relationships: OtherRelationships = OtherRelationships([
+        RouteToInternetGateway(),
+    ])

cartography/models/entra/tenant.py

@@ -0,0 +1,33 @@
+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
+
+
+@dataclass(frozen=True)
+class EntraTenantNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef('id')
+    created_date_time: PropertyRef = PropertyRef('created_date_time')
+    default_usage_location: PropertyRef = PropertyRef('default_usage_location')
+    deleted_date_time: PropertyRef = PropertyRef('deleted_date_time')
+    display_name: PropertyRef = PropertyRef('display_name')
+    marketing_notification_emails: PropertyRef = PropertyRef('marketing_notification_emails')
+    mobile_device_management_authority: PropertyRef = PropertyRef('mobile_device_management_authority')
+    on_premises_last_sync_date_time: PropertyRef = PropertyRef('on_premises_last_sync_date_time')
+    on_premises_sync_enabled: PropertyRef = PropertyRef('on_premises_sync_enabled')
+    partner_tenant_type: PropertyRef = PropertyRef('partner_tenant_type')
+    postal_code: PropertyRef = PropertyRef('postal_code')
+    preferred_language: PropertyRef = PropertyRef('preferred_language')
+    state: PropertyRef = PropertyRef('state')
+    street: PropertyRef = PropertyRef('street')
+    tenant_type: PropertyRef = PropertyRef('tenant_type')
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class EntraTenantSchema(CartographyNodeSchema):
+    label: str = 'AzureTenant'
+    properties: EntraTenantNodeProperties = EntraTenantNodeProperties()
+    extra_node_labels: ExtraNodeLabels = ExtraNodeLabels(['EntraTenant'])

cartography/models/entra/user.py

@@ -0,0 +1,83 @@
+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 EntraUserNodeProperties(CartographyNodeProperties):
+    id: PropertyRef = PropertyRef('id')
+    user_principal_name: PropertyRef = PropertyRef('user_principal_name')
+    display_name: PropertyRef = PropertyRef('display_name')
+    given_name: PropertyRef = PropertyRef('given_name')
+    surname: PropertyRef = PropertyRef('surname')
+    # The underlying datatype calls this 'mail' but everything else in cartography uses 'email'
+    email: PropertyRef = PropertyRef('mail', extra_index=True)
+    other_mails: PropertyRef = PropertyRef('other_mails')
+    preferred_language: PropertyRef = PropertyRef('preferred_language')
+    preferred_name: PropertyRef = PropertyRef('preferred_name')
+    state: PropertyRef = PropertyRef('state')
+    usage_location: PropertyRef = PropertyRef('usage_location')
+    user_type: PropertyRef = PropertyRef('user_type')
+    show_in_address_list: PropertyRef = PropertyRef('show_in_address_list')
+    sign_in_sessions_valid_from_date_time: PropertyRef = PropertyRef('sign_in_sessions_valid_from_date_time')
+    security_identifier: PropertyRef = PropertyRef('security_identifier')
+    account_enabled: PropertyRef = PropertyRef('account_enabled')
+    city: PropertyRef = PropertyRef('city')
+    company_name: PropertyRef = PropertyRef('company_name')
+    consent_provided_for_minor: PropertyRef = PropertyRef('consent_provided_for_minor')
+    country: PropertyRef = PropertyRef('country')
+    created_date_time: PropertyRef = PropertyRef('created_date_time')
+    creation_type: PropertyRef = PropertyRef('creation_type')
+    deleted_date_time: PropertyRef = PropertyRef('deleted_date_time')
+    department: PropertyRef = PropertyRef('department')
+    employee_id: PropertyRef = PropertyRef('employee_id')
+    employee_type: PropertyRef = PropertyRef('employee_type')
+    external_user_state: PropertyRef = PropertyRef('external_user_state')
+    external_user_state_change_date_time: PropertyRef = PropertyRef('external_user_state_change_date_time')
+    hire_date: PropertyRef = PropertyRef('hire_date')
+    is_management_restricted: PropertyRef = PropertyRef('is_management_restricted')
+    is_resource_account: PropertyRef = PropertyRef('is_resource_account')
+    job_title: PropertyRef = PropertyRef('job_title')
+    last_password_change_date_time: PropertyRef = PropertyRef('last_password_change_date_time')
+    mail_nickname: PropertyRef = PropertyRef('mail_nickname')
+    office_location: PropertyRef = PropertyRef('office_location')
+    on_premises_distinguished_name: PropertyRef = PropertyRef('on_premises_distinguished_name')
+    on_premises_domain_name: PropertyRef = PropertyRef('on_premises_domain_name')
+    on_premises_immutable_id: PropertyRef = PropertyRef('on_premises_immutable_id')
+    on_premises_last_sync_date_time: PropertyRef = PropertyRef('on_premises_last_sync_date_time')
+    on_premises_sam_account_name: PropertyRef = PropertyRef('on_premises_sam_account_name')
+    on_premises_security_identifier: PropertyRef = PropertyRef('on_premises_security_identifier')
+    on_premises_sync_enabled: PropertyRef = PropertyRef('on_premises_sync_enabled')
+    on_premises_user_principal_name: PropertyRef = PropertyRef('on_premises_user_principal_name')
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+class EntraTenantToUserRelProperties(CartographyRelProperties):
+    lastupdated: PropertyRef = PropertyRef('lastupdated', set_in_kwargs=True)
+
+
+@dataclass(frozen=True)
+# (:EntraUser)<-[:RESOURCE]-(:AzureTenant)
+class EntraUserToTenantRel(CartographyRelSchema):
+    target_node_label: str = 'AzureTenant'
+    target_node_matcher: TargetNodeMatcher = make_target_node_matcher(
+        {'id': PropertyRef('TENANT_ID', set_in_kwargs=True)},
+    )
+    direction: LinkDirection = LinkDirection.INWARD
+    rel_label: str = "RESOURCE"
+    properties: EntraTenantToUserRelProperties = EntraTenantToUserRelProperties()
+
+
+@dataclass(frozen=True)
+class EntraUserSchema(CartographyNodeSchema):
+    label: str = 'EntraUser'
+    properties: EntraUserNodeProperties = EntraUserNodeProperties()
+    sub_resource_relationship: EntraUserToTenantRel = EntraUserToTenantRel()

cartography/sync.py

@@ -20,6 +20,7 @@ import cartography.intel.crowdstrike
 import cartography.intel.cve
 import cartography.intel.digitalocean
 import cartography.intel.duo
+import cartography.intel.entra
 import cartography.intel.gcp
 import cartography.intel.github
 import cartography.intel.gsuite
@@ -42,6 +43,7 @@ TOP_LEVEL_MODULES = OrderedDict({  # preserve order so that the default sync alw
     'create-indexes': cartography.intel.create_indexes.run,
     'aws': cartography.intel.aws.start_aws_ingestion,
     'azure': cartography.intel.azure.start_azure_ingestion,
+    'entra': cartography.intel.entra.start_entra_ingestion,
     'crowdstrike': cartography.intel.crowdstrike.start_crowdstrike_ingestion,
     'gcp': cartography.intel.gcp.start_gcp_ingestion,
     'gsuite': cartography.intel.gsuite.start_gsuite_ingestion,

{cartography-0.101.1rc2.dist-info → cartography-0.102.0rc2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cartography
-Version: 0.101.1rc2
+Version: 0.102.0rc2
 Summary: Explore assets and their relationships across your technical infrastructure.
 Maintainer: Cartography Contributors
 License: apache2
@@ -47,6 +47,7 @@ Requires-Dist: msrestazure>=0.6.4
 Requires-Dist: azure-mgmt-storage>=16.0.0
 Requires-Dist: azure-mgmt-sql<=1.0.0
 Requires-Dist: azure-identity>=1.5.0
+Requires-Dist: msgraph-sdk
 Requires-Dist: kubernetes>=22.6.0
 Requires-Dist: pdpyras>=4.3.0
 Requires-Dist: crowdstrike-falconpy>=0.5.1
@@ -61,6 +62,7 @@ Requires-Dist: pytest>=6.2.4; extra == "dev"
 Requires-Dist: pytest-mock; extra == "dev"
 Requires-Dist: pytest-cov==6.1.1; extra == "dev"
 Requires-Dist: pytest-rerunfailures; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
 Requires-Dist: types-PyYAML; extra == "dev"
 Requires-Dist: types-requests<2.32.0.20250329; extra == "dev"
 Dynamic: license-file
@@ -97,6 +99,7 @@ You can learn more about the story behind Cartography in our [presentation at BS
 - [GitHub](https://cartography-cncf.github.io/cartography/modules/github/index.html) - repos, branches, users, teams
 - [DigitalOcean](https://cartography-cncf.github.io/cartography/modules/digitalocean/index.html)
 - [Microsoft Azure](https://cartography-cncf.github.io/cartography/modules/azure/index.html) -  CosmosDB, SQL, Storage, Virtual Machine
+- [Microsoft Entra ID](https://cartography-cncf.github.io/cartography/modules/entra/index.html) -  Users
 - [Kubernetes](https://cartography-cncf.github.io/cartography/modules/kubernetes/index.html) - Cluster, Namespace, Service, Pod, Container
 - [PagerDuty](https://cartography-cncf.github.io/cartography/modules/pagerduty/index.html) - Users, teams, services, schedules, escalation policies, integrations, vendors
 - [Crowdstrike Falcon](https://cartography-cncf.github.io/cartography/modules/crowdstrike/index.html) - Hosts, Spotlight vulnerabilities, CVEs