Office365-REST-Python-Client 3.1.0__py3-none-any.whl → 3.3.0__py3-none-any.whl

office365/security/datasecurity/label_content_right.py

@@ -0,0 +1,44 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Optional
+
+from office365.entity import Entity
+from office365.runtime.paths.resource_path import ResourcePath
+
+if TYPE_CHECKING:
+    from office365.onedrive.sensitivitylabels.usagerights import UsageRights
+    from office365.security.datasecurity.sensitivity_label import (
+        SensitivityLabel,
+    )
+
+
+class LabelContentRight(Entity):
+    @property
+    def cid(self) -> Optional[str]:
+        """Gets the cid property"""
+        return self.properties.get("cid", None)
+
+    @property
+    def format(self) -> Optional[str]:
+        """Gets the format property"""
+        return self.properties.get("format", None)
+
+    @property
+    def rights(self) -> UsageRights:
+        """Gets the rights property"""
+        from office365.onedrive.sensitivitylabels.usagerights import UsageRights
+
+        return self.properties.get("rights", UsageRights.unknown)
+
+    @property
+    def label(self) -> SensitivityLabel:
+        """Gets the label property"""
+        from office365.security.datasecurity.sensitivity_label import (
+            SensitivityLabel,
+        )
+
+        return self.properties.get("label", SensitivityLabel(self.context, ResourcePath("label", self.resource_path)))
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.LabelContentRight"

office365/security/datasecurity/policy_scope_base.py

@@ -0,0 +1,26 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from office365.directory.policies.executionmode import ExecutionMode
+from office365.runtime.client_value import ClientValue
+from office365.runtime.client_value_collection import ClientValueCollection
+from office365.security.datasecurity.dlp_action_info import DlpActionInfo
+from office365.security.datasecurity.policy_location import PolicyLocation
+from office365.security.useractivitytypes import UserActivityTypes
+
+
+@dataclass
+class PolicyScopeBase(ClientValue):
+    activities: UserActivityTypes = UserActivityTypes.none
+    executionMode: ExecutionMode = ExecutionMode.evaluateInline
+    locations: ClientValueCollection[PolicyLocation] = field(
+        default_factory=lambda: ClientValueCollection(PolicyLocation)
+    )
+    policyActions: ClientValueCollection[DlpActionInfo] = field(
+        default_factory=lambda: ClientValueCollection(DlpActionInfo)
+    )
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.PolicyScopeBase"

office365/security/datasecurity/policy_tenant_scope.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from office365.runtime.client_value import ClientValue
+from office365.security.datasecurity.policy_binding import PolicyBinding
+
+
+@dataclass
+class PolicyTenantScope(ClientValue):
+    policyScope: PolicyBinding = field(default_factory=PolicyBinding)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.PolicyTenantScope"

office365/security/datasecurity/policy_tip_action.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from office365.security.datasecurity.dlp_action_info import DlpActionInfo
+
+
+@dataclass
+class PolicyTipAction(DlpActionInfo):
+    complianceUrl: str | None = None
+    matchedConditionsDescription: str | None = None
+    policyTip: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.PolicyTipAction"

office365/security/datasecurity/process_content_batch_request.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from office365.runtime.client_value import ClientValue
+from office365.security.datasecurity.process_content_request import ProcessContentRequest
+
+
+@dataclass
+class ProcessContentBatchRequest(ClientValue):
+    contentToProcess: ProcessContentRequest = field(default_factory=ProcessContentRequest)
+    requestId: str | None = None
+    userId: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.ProcessContentBatchRequest"

office365/security/datasecurity/process_content_request.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from office365.directory.identitygovernance.process_content_metadata_base import (
+    ProcessContentMetadataBase,
+)
+from office365.directory.policies.protected_application_metadata import (
+    ProtectedApplicationMetadata,
+)
+from office365.intune.devices.device_metadata import DeviceMetadata
+from office365.runtime.client_value import ClientValue
+from office365.runtime.client_value_collection import ClientValueCollection
+from office365.security.activity_metadata import ActivityMetadata
+from office365.security.datasecurity.integrated_application_metadata import (
+    IntegratedApplicationMetadata,
+)
+
+
+@dataclass
+class ProcessContentRequest(ClientValue):
+    contentEntries: ClientValueCollection[ProcessContentMetadataBase] = field(
+        default_factory=lambda: ClientValueCollection(ProcessContentMetadataBase)
+    )
+    deviceMetadata: DeviceMetadata = field(default_factory=DeviceMetadata)
+    integratedAppMetadata: IntegratedApplicationMetadata = field(default_factory=IntegratedApplicationMetadata)
+    protectedAppMetadata: ProtectedApplicationMetadata = field(default_factory=ProtectedApplicationMetadata)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.ProcessContentRequest"
+
+    activityMetadata: ActivityMetadata = field(default_factory=ActivityMetadata)

office365/security/datasecurity/process_content_response.py

@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from office365.runtime.client_value import ClientValue
+from office365.runtime.client_value_collection import ClientValueCollection
+from office365.security.datasecurity.dlp_action_info import DlpActionInfo
+from office365.security.processing_error import ProcessingError
+from office365.security.protectionscopestate import ProtectionScopeState
+
+
+@dataclass
+class ProcessContentResponse(ClientValue):
+    policyActions: ClientValueCollection[DlpActionInfo] = field(
+        default_factory=lambda: ClientValueCollection(DlpActionInfo)
+    )
+    processingErrors: ClientValueCollection[ProcessingError] = field(
+        default_factory=lambda: ClientValueCollection(ProcessingError)
+    )
+    protectionScopeState: ProtectionScopeState = ProtectionScopeState.notModified
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.ProcessContentResponse"

office365/security/datasecurity/process_content_responses.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from office365.runtime.client_value import ClientValue
+from office365.security.datasecurity.process_content_response import ProcessContentResponse
+
+
+@dataclass
+class ProcessContentResponses(ClientValue):
+    requestId: str | None = None
+    results: ProcessContentResponse = field(default_factory=ProcessContentResponse)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.ProcessContentResponses"

office365/security/datasecurity/process_file_metadata.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from office365.runtime.client_value import ClientValue
+from office365.security.datasecurity.custom_metadata_dictionary import CustomMetadataDictionary
+
+
+@dataclass
+class ProcessFileMetadata(ClientValue):
+    customProperties: CustomMetadataDictionary = field(default_factory=CustomMetadataDictionary)
+    ownerId: str | None = None
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.ProcessFileMetadata"

office365/security/datasecurity/sensitivity_label.py

@@ -0,0 +1,117 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Optional
+
+from office365.entity import Entity
+from office365.entity_collection import EntityCollection
+from office365.runtime.paths.resource_path import ResourcePath
+
+if TYPE_CHECKING:
+    from office365.onedrive.sensitivitylabels.labelactionsource import LabelActionSource
+    from office365.security.datasecurity.sensitivity_label import (
+        SensitivityLabel,
+    )
+    from office365.security.datasecurity.usage_rights_included import (
+        UsageRightsIncluded,
+    )
+
+
+class SensitivityLabel(Entity):
+    """Represents a sensitivity label that defines how to protect and handle content."""
+
+    @property
+    def name(self) -> Optional[str]:
+        return self.properties.get("name", None)
+
+    @property
+    def display_name(self) -> Optional[str]:
+        return self.properties.get("displayName", None)
+
+    @property
+    def description(self) -> Optional[str]:
+        return self.properties.get("description", None)
+
+    @property
+    def priority(self) -> Optional[int]:
+        return self.properties.get("priority", None)
+
+    @property
+    def sensitivity(self) -> Optional[int]:
+        return self.properties.get("sensitivity", None)
+
+    @property
+    def enabled(self) -> Optional[bool]:
+        return self.properties.get("enabled", None)
+
+    @property
+    def action_source(self) -> LabelActionSource:
+        """Gets the actionSource property"""
+        from office365.onedrive.sensitivitylabels.labelactionsource import (
+            LabelActionSource,
+        )
+
+        return self.properties.get("actionSource", LabelActionSource.manual)
+
+    @property
+    def auto_tooltip(self) -> Optional[str]:
+        """Gets the autoTooltip property"""
+        return self.properties.get("autoTooltip", None)
+
+    @property
+    def has_protection(self) -> Optional[bool]:
+        """Gets the hasProtection property"""
+        return self.properties.get("hasProtection", None)
+
+    @property
+    def is_default(self) -> Optional[bool]:
+        """Gets the isDefault property"""
+        return self.properties.get("isDefault", None)
+
+    @property
+    def is_endpoint_protection_enabled(self) -> Optional[bool]:
+        """Gets the isEndpointProtectionEnabled property"""
+        return self.properties.get("isEndpointProtectionEnabled", None)
+
+    @property
+    def is_scoped_to_user(self) -> Optional[bool]:
+        """Gets the isScopedToUser property"""
+        return self.properties.get("isScopedToUser", None)
+
+    @property
+    def locale(self) -> Optional[str]:
+        """Gets the locale property"""
+        return self.properties.get("locale", None)
+
+    @property
+    def tool_tip(self) -> Optional[str]:
+        """Gets the toolTip property"""
+        return self.properties.get("toolTip", None)
+
+    @property
+    def rights(self) -> UsageRightsIncluded:
+        """Gets the rights property"""
+        from office365.security.datasecurity.usage_rights_included import (
+            UsageRightsIncluded,
+        )
+
+        return self.properties.get(
+            "rights", UsageRightsIncluded(self.context, ResourcePath("rights", self.resource_path))
+        )
+
+    @property
+    def sublabels(self) -> EntityCollection[SensitivityLabel]:
+        """Gets the sublabels property"""
+        from office365.security.datasecurity.sensitivity_label import (
+            SensitivityLabel,
+        )
+
+        return self.properties.get(
+            "sublabels",
+            EntityCollection[SensitivityLabel](
+                self.context, SensitivityLabel, ResourcePath("sublabels", self.resource_path)
+            ),
+        )
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.SensitivityLabel"

office365/security/datasecurity/tenant_protection_scope_container.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+from office365.entity import Entity
+
+
+class TenantProtectionScopeContainer(Entity):
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.TenantProtectionScopeContainer"

office365/security/datasecurity/usage_rights_included.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Optional
+
+from office365.entity import Entity
+
+if TYPE_CHECKING:
+    from office365.onedrive.sensitivitylabels.usagerights import UsageRights
+
+
+class UsageRightsIncluded(Entity):
+    @property
+    def owner_email(self) -> Optional[str]:
+        """Gets the ownerEmail property"""
+        return self.properties.get("ownerEmail", None)
+
+    @property
+    def user_email(self) -> Optional[str]:
+        """Gets the userEmail property"""
+        return self.properties.get("userEmail", None)
+
+    @property
+    def value(self) -> UsageRights:
+        """Gets the value property"""
+        from office365.onedrive.sensitivitylabels.usagerights import UsageRights
+
+        return self.properties.get("value", UsageRights.unknown)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.UsageRightsIncluded"

office365/security/detonation_details.py

@@ -0,0 +1,34 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from datetime import datetime
+
+from office365.runtime.client_value import ClientValue
+from office365.runtime.client_value_collection import ClientValueCollection
+from office365.security.compromise_indicator import CompromiseIndicator
+from office365.security.detonation_behaviour_details import DetonationBehaviourDetails
+from office365.security.detonation_chain import DetonationChain
+from office365.security.detonation_observables import DetonationObservables
+
+
+@dataclass
+class DetonationDetails(ClientValue):
+    analysisDateTime: datetime | None = field(default_factory=lambda: datetime.min)
+    detonationBehaviourDetailsV2: str | None = None
+    detonationScreenshotUri: str | None = None
+    detonationVerdict: str | None = None
+    detonationVerdictReason: str | None = None
+    entityMetadata: str | None = None
+    mitreTechniques: str | None = None
+    staticAnalysis: str | None = None
+    submissionSource: str | None = None
+    compromiseIndicators: ClientValueCollection[CompromiseIndicator] = field(
+        default_factory=lambda: ClientValueCollection(CompromiseIndicator)
+    )
+    detonationBehaviourDetails: DetonationBehaviourDetails = field(default_factory=DetonationBehaviourDetails)
+    detonationChain: DetonationChain = field(default_factory=DetonationChain)
+    detonationObservables: DetonationObservables = field(default_factory=DetonationObservables)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.security.DetonationDetails"

office365/security/device_evidence.py

@@ -0,0 +1,50 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from datetime import datetime
+
+from office365.intune.devices.healthstatus import DeviceHealthStatus
+from office365.runtime.client_value import ClientValue
+from office365.runtime.client_value_collection import ClientValueCollection
+from office365.runtime.types.collections import StringCollection
+from office365.security.alerts.defenderavstatus import DefenderAvStatus
+from office365.security.logged_on_user import LoggedOnUser
+from office365.security.onboarding_status import OnboardingStatus
+from office365.security.resource_access_event import ResourceAccessEvent
+from office365.security.riskscore import DeviceRiskScore
+from office365.security.vm_metadata import VmMetadata
+
+
+@dataclass
+class DeviceEvidence(ClientValue):
+    azureAdDeviceId: str | None = None
+    defenderAvStatus: DefenderAvStatus = DefenderAvStatus.notReporting
+    deviceDnsName: str | None = None
+    dnsDomain: str | None = None
+    firstSeenDateTime: datetime | None = field(default_factory=lambda: datetime.min)
+    healthStatus: DeviceHealthStatus = DeviceHealthStatus.active
+    hostName: str | None = None
+    ipInterfaces: StringCollection = field(default_factory=StringCollection)
+    lastExternalIpAddress: str | None = None
+    lastIpAddress: str | None = None
+    mdeDeviceId: str | None = None
+    ntDomain: str | None = None
+    osBuild: int | None = None
+    osPlatform: str | None = None
+    rbacGroupId: int | None = None
+    rbacGroupName: str | None = None
+    riskScore: DeviceRiskScore = DeviceRiskScore.none
+    version: str | None = None
+    loggedOnUsers: ClientValueCollection[LoggedOnUser] = field(
+        default_factory=lambda: ClientValueCollection(LoggedOnUser)
+    )
+    resourceAccessEvents: ClientValueCollection[ResourceAccessEvent] = field(
+        default_factory=lambda: ClientValueCollection(ResourceAccessEvent)
+    )
+    vmMetadata: VmMetadata = field(default_factory=VmMetadata)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.security.DeviceEvidence"
+
+    onboardingStatus: OnboardingStatus = OnboardingStatus.insufficientInfo

office365/security/dns_evidence.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+
+from office365.runtime.client_value import ClientValue
+from office365.runtime.client_value_collection import ClientValueCollection
+from office365.security.ip_evidence import IpEvidence
+
+
+@dataclass
+class DnsEvidence(ClientValue):
+    domainName: str | None = None
+    dnsServerIp: IpEvidence = field(default_factory=IpEvidence)
+    hostIpAddress: IpEvidence = field(default_factory=IpEvidence)
+    ipAddresses: ClientValueCollection[IpEvidence] = field(default_factory=lambda: ClientValueCollection(IpEvidence))
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.security.DnsEvidence"

office365/security/ediscovery/case_member.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Optional
+
+from office365.entity import Entity
+
+if TYPE_CHECKING:
+    from office365.security.recipient_type import RecipientType
+
+
+class EdiscoveryCaseMember(Entity):
+    @property
+    def display_name(self) -> Optional[str]:
+        """Gets the displayName property"""
+        return self.properties.get("displayName", None)
+
+    @property
+    def smtp_address(self) -> Optional[str]:
+        """Gets the smtpAddress property"""
+        return self.properties.get("smtpAddress", None)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.security.EdiscoveryCaseMember"
+
+    @property
+    def recipient_type(self) -> RecipientType:
+        """Gets the recipientType property"""
+        from office365.security.recipient_type import RecipientType
+
+        return self.properties.get("recipientType", RecipientType.user)

office365/security/ediscovery/custodian.py

@@ -0,0 +1,76 @@
+from __future__ import annotations
+
+from datetime import datetime
+from typing import TYPE_CHECKING, Optional
+
+from office365.entity import Entity
+from office365.entity_collection import EntityCollection
+from office365.runtime.paths.resource_path import ResourcePath
+
+if TYPE_CHECKING:
+    from office365.security.ediscovery.ediscovery_index_operation import (
+        EdiscoveryIndexOperation,
+    )
+    from office365.security.site_source import SiteSource
+    from office365.security.unified_group_source import UnifiedGroupSource
+    from office365.security.user_source import UserSource
+
+
+class EdiscoveryCustodian(Entity):
+    @property
+    def acknowledged_date_time(self) -> Optional[datetime]:
+        """Gets the acknowledgedDateTime property"""
+        return self.properties.get("acknowledgedDateTime", datetime.min)
+
+    @property
+    def email(self) -> Optional[str]:
+        """Gets the email property"""
+        return self.properties.get("email", None)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.security.EdiscoveryCustodian"
+
+    @property
+    def last_index_operation(self) -> EdiscoveryIndexOperation:
+        """Gets the lastIndexOperation property"""
+        from office365.security.ediscovery.ediscovery_index_operation import (
+            EdiscoveryIndexOperation,
+        )
+
+        return self.properties.get(
+            "lastIndexOperation",
+            EdiscoveryIndexOperation(self.context, ResourcePath("lastIndexOperation", self.resource_path)),
+        )
+
+    @property
+    def site_sources(self) -> EntityCollection[SiteSource]:
+        """Gets the siteSources property"""
+        from office365.security.site_source import SiteSource
+
+        return self.properties.get(
+            "siteSources",
+            EntityCollection[SiteSource](self.context, SiteSource, ResourcePath("siteSources", self.resource_path)),
+        )
+
+    @property
+    def unified_group_sources(self) -> EntityCollection[UnifiedGroupSource]:
+        """Gets the unifiedGroupSources property"""
+        from office365.security.unified_group_source import UnifiedGroupSource
+
+        return self.properties.get(
+            "unifiedGroupSources",
+            EntityCollection[UnifiedGroupSource](
+                self.context, UnifiedGroupSource, ResourcePath("unifiedGroupSources", self.resource_path)
+            ),
+        )
+
+    @property
+    def user_sources(self) -> EntityCollection[UserSource]:
+        """Gets the userSources property"""
+        from office365.security.user_source import UserSource
+
+        return self.properties.get(
+            "userSources",
+            EntityCollection[UserSource](self.context, UserSource, ResourcePath("userSources", self.resource_path)),
+        )

office365/security/ediscovery/ediscovery_case_settings.py

@@ -0,0 +1,57 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from office365.entity import Entity
+from office365.security.cases.reviewsetsettings import ReviewSetSettings
+from office365.security.cases.type import CaseType
+
+if TYPE_CHECKING:
+    from office365.security.ocr_settings import OcrSettings
+    from office365.security.redundancy_detection_settings import (
+        RedundancyDetectionSettings,
+    )
+    from office365.security.topic_modeling_settings import (
+        TopicModelingSettings,
+    )
+
+
+class EdiscoveryCaseSettings(Entity):
+    @property
+    def case_type(self) -> CaseType:
+        """Gets the caseType property"""
+        return self.properties.get("caseType", CaseType.standard)
+
+    @property
+    def review_set_settings(self) -> ReviewSetSettings:
+        """Gets the reviewSetSettings property"""
+        return self.properties.get("reviewSetSettings", ReviewSetSettings.none)
+
+    @property
+    def entity_type_name(self) -> str:
+        return "microsoft.graph.security.EdiscoveryCaseSettings"
+
+    @property
+    def ocr(self) -> OcrSettings:
+        """Gets the ocr property"""
+        from office365.security.ocr_settings import OcrSettings
+
+        return self.properties.get("ocr", OcrSettings())
+
+    @property
+    def redundancy_detection(self) -> RedundancyDetectionSettings:
+        """Gets the redundancyDetection property"""
+        from office365.security.redundancy_detection_settings import (
+            RedundancyDetectionSettings,
+        )
+
+        return self.properties.get("redundancyDetection", RedundancyDetectionSettings())
+
+    @property
+    def topic_modeling(self) -> TopicModelingSettings:
+        """Gets the topicModeling property"""
+        from office365.security.topic_modeling_settings import (
+            TopicModelingSettings,
+        )
+
+        return self.properties.get("topicModeling", TopicModelingSettings())