taegis-sdk-python 1.2.32__tar.gz → 1.2.34__tar.gz

{taegis_sdk_python-1.2.32/taegis_sdk_python.egg-info → taegis_sdk_python-1.2.34}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: taegis-sdk-python
-Version: 1.2.32
+Version: 1.2.34
 Summary: Taegis Python SDK
 Home-page: https://github.com/secureworks/taegis-sdk-python
 Author: Secureworks

taegis_sdk_python-1.2.34/taegis_sdk_python/_version.py

@@ -0,0 +1 @@
+__version__ = "v1.2.34"

{taegis_sdk_python-1.2.32 → taegis_sdk_python-1.2.34}/taegis_sdk_python/services/assets2/types.py

@@ -25,6 +25,7 @@ class AssetState(str, Enum):
     ARCHIVED = "Archived"
     ACTIVE = "Active"
     UNHEALTHY = "Unhealthy"
+    HEALTHY = "Healthy"
 
 
 class EndpointTypeV2(str, Enum):
@@ -1266,14 +1267,7 @@ class AssetV2:
         default=None, metadata=config(field_name="deletedAt")
     )
     last_seen_at: Optional[str] = field(
-        default=None,
-        metadata=config(
-            metadata={
-                "deprecated": True,
-                "deprecation_reason": "use connectionDetails.LastSeenAt",
-            },
-            field_name="lastSeenAt",
-        ),
+        default=None, metadata=config(field_name="lastSeenAt")
     )
     bios_serial: Optional[str] = field(
         default=None, metadata=config(field_name="biosSerial")

{taegis_sdk_python-1.2.32 → taegis_sdk_python-1.2.34}/taegis_sdk_python/services/endpoint_management_service/mutations.py

@@ -147,6 +147,10 @@ class TaegisSDKEndpointManagementServiceMutation:
         """update agent settings item."""
         endpoint = "updateAgentSetting"
 
+        log.warning(
+            f"GraphQL Mutation `{endpoint}` is deprecated: 'Use V2 api for update functionality'"
+        )
+
         result = self.service.execute_mutation(
             endpoint=endpoint,
             variables={
@@ -159,10 +163,32 @@ class TaegisSDKEndpointManagementServiceMutation:
             return AgentSetting.from_dict(result.get(endpoint))
         raise GraphQLNoRowsInResultSetError("for mutation updateAgentSetting")
 
+    def update_agent_setting_v2(
+        self, id_: str, input_: UpdateAgentSettingsInput
+    ) -> AgentSetting:
+        """update the default agent settings item."""
+        endpoint = "updateAgentSettingV2"
+
+        result = self.service.execute_mutation(
+            endpoint=endpoint,
+            variables={
+                "id": prepare_input(id_),
+                "input": prepare_input(input_),
+            },
+            output=build_output_string(AgentSetting),
+        )
+        if result.get(endpoint) is not None:
+            return AgentSetting.from_dict(result.get(endpoint))
+        raise GraphQLNoRowsInResultSetError("for mutation updateAgentSettingV2")
+
     def update_default_agent_setting(self, input_: AgentSettingsInput) -> AgentSetting:
         """update the default agent settings item."""
         endpoint = "updateDefaultAgentSetting"
 
+        log.warning(
+            f"GraphQL Mutation `{endpoint}` is deprecated: 'Use V2 api for update functionality'"
+        )
+
         result = self.service.execute_mutation(
             endpoint=endpoint,
             variables={
@@ -174,6 +200,23 @@ class TaegisSDKEndpointManagementServiceMutation:
             return AgentSetting.from_dict(result.get(endpoint))
         raise GraphQLNoRowsInResultSetError("for mutation updateDefaultAgentSetting")
 
+    def update_default_agent_setting_v2(
+        self, input_: UpdateAgentSettingsInput
+    ) -> AgentSetting:
+        """delete agent settings item."""
+        endpoint = "updateDefaultAgentSettingV2"
+
+        result = self.service.execute_mutation(
+            endpoint=endpoint,
+            variables={
+                "input": prepare_input(input_),
+            },
+            output=build_output_string(AgentSetting),
+        )
+        if result.get(endpoint) is not None:
+            return AgentSetting.from_dict(result.get(endpoint))
+        raise GraphQLNoRowsInResultSetError("for mutation updateDefaultAgentSettingV2")
+
     def delete_agent_setting(self, id_: str) -> bool:
         """delete agent settings item."""
         endpoint = "deleteAgentSetting"

{taegis_sdk_python-1.2.32 → taegis_sdk_python-1.2.34}/taegis_sdk_python/services/endpoint_management_service/types.py

@@ -65,6 +65,7 @@ class AgentSettingsProfile(str, Enum):
     """AgentSettingsProfile."""
 
     DEFAULT = "DEFAULT"
+    EARLY_ACCESS = "EARLY_ACCESS"
 
 
 @dataclass_json
@@ -740,6 +741,45 @@ class MaintenanceWindowDefaults:
     )
 
 
+@dataclass_json
+@dataclass(order=True, eq=True, frozen=True)
+class UpdateAgentSettingsInput:
+    """UpdateAgentSettingsInput."""
+
+    name: Optional[str] = field(default=None, metadata=config(field_name="name"))
+    description: Optional[str] = field(
+        default=None, metadata=config(field_name="description")
+    )
+    channel: Optional[str] = field(default=None, metadata=config(field_name="channel"))
+    advanced_kernel_telemetry: Optional[AdvancedKernelTelemetryInput] = field(
+        default=None, metadata=config(field_name="advancedKernelTelemetry")
+    )
+    auto_archive: Optional[AutoArchiveInput] = field(
+        default=None, metadata=config(field_name="autoArchive")
+    )
+    file_analysis: Optional[BooleanSettingInput] = field(
+        default=None, metadata=config(field_name="fileAnalysis")
+    )
+    tamper_protection: Optional[BooleanSettingInput] = field(
+        default=None, metadata=config(field_name="tamperProtection")
+    )
+    ngav: Optional[NGAVInput] = field(default=None, metadata=config(field_name="ngav"))
+    policy_type: Optional[Union[PolicyType, TaegisEnum]] = field(
+        default=None,
+        metadata=config(
+            encoder=encode_enum,
+            decoder=lambda x: decode_enum(PolicyType, x),
+            field_name="policyType",
+        ),
+    )
+    maintenance_window: Optional[MaintenanceWindowInput] = field(
+        default=None, metadata=config(field_name="maintenanceWindow")
+    )
+    experimental_settings: Optional[List[ExperimentalSettingsInput]] = field(
+        default=None, metadata=config(field_name="experimentalSettings")
+    )
+
+
 @dataclass_json
 @dataclass(order=True, eq=True, frozen=True)
 class AgentSettingsInput:

{taegis_sdk_python-1.2.32 → taegis_sdk_python-1.2.34}/taegis_sdk_python/services/tenants/mutations.py

@@ -454,3 +454,18 @@ class TaegisSDKTenantsMutation:
         raise GraphQLNoRowsInResultSetError(
             "for mutation cancelTenantDecommissionRequest"
         )
+
+    def register_domain(self, input_: RegisterDomainInput) -> RegisteredDomain:
+        """Register a domain to the tenant."""
+        endpoint = "registerDomain"
+
+        result = self.service.execute_mutation(
+            endpoint=endpoint,
+            variables={
+                "input": prepare_input(input_),
+            },
+            output=build_output_string(RegisteredDomain),
+        )
+        if result.get(endpoint) is not None:
+            return RegisteredDomain.from_dict(result.get(endpoint))
+        raise GraphQLNoRowsInResultSetError("for mutation registerDomain")

{taegis_sdk_python-1.2.32 → taegis_sdk_python-1.2.34}/taegis_sdk_python/services/tenants/types.py

@@ -45,6 +45,7 @@ class AuthzAction(str, Enum):
     DELETE = "Delete"
     APPROVE = "Approve"
     EXECUTE = "Execute"
+    REGISTER_DOMAIN = "RegisterDomain"
 
 
 class TenantType(str, Enum):
@@ -441,6 +442,36 @@ class TenantDecommissionAgentSummary:
     count: Optional[int] = field(default=None, metadata=config(field_name="count"))
 
 
+@dataclass_json
+@dataclass(order=True, eq=True, frozen=True)
+class RegisteredDomain:
+    """RegisteredDomain."""
+
+    id: Optional[str] = field(default=None, metadata=config(field_name="id"))
+    tenant_id: Optional[str] = field(
+        default=None, metadata=config(field_name="tenantID")
+    )
+    domain: Optional[str] = field(default=None, metadata=config(field_name="domain"))
+    verified: Optional[bool] = field(
+        default=None, metadata=config(field_name="verified")
+    )
+    verification_txt: Optional[str] = field(
+        default=None, metadata=config(field_name="verificationTxt")
+    )
+    created_at: Optional[str] = field(
+        default=None, metadata=config(field_name="createdAt")
+    )
+    updated_at: Optional[str] = field(
+        default=None, metadata=config(field_name="updatedAt")
+    )
+    created_by: Optional[str] = field(
+        default=None, metadata=config(field_name="createdBy")
+    )
+    updated_by: Optional[str] = field(
+        default=None, metadata=config(field_name="updatedBy")
+    )
+
+
 @dataclass_json
 @dataclass(order=True, eq=True, frozen=True)
 class NewService:
@@ -598,13 +629,25 @@ class SAMLSSOConfiguration:
         default=None, metadata=config(field_name="metadataFileName")
     )
     signing_cert_name: Optional[str] = field(
-        default=None, metadata=config(field_name="signingCertName")
+        default=None,
+        metadata=config(
+            metadata={"deprecated": True, "deprecation_reason": "No longer supported"},
+            field_name="signingCertName",
+        ),
     )
     signing_cert: Optional[str] = field(
-        default=None, metadata=config(field_name="signingCert")
+        default=None,
+        metadata=config(
+            metadata={"deprecated": True, "deprecation_reason": "No longer supported"},
+            field_name="signingCert",
+        ),
     )
     sign_in_endpoint: Optional[str] = field(
-        default=None, metadata=config(field_name="signInEndpoint")
+        default=None,
+        metadata=config(
+            metadata={"deprecated": True, "deprecation_reason": "No longer supported"},
+            field_name="signInEndpoint",
+        ),
     )
 
 
@@ -682,6 +725,14 @@ class TenantDecommissionTaskDeferInput:
     )
 
 
+@dataclass_json
+@dataclass(order=True, eq=True, frozen=True)
+class RegisterDomainInput:
+    """RegisterDomainInput."""
+
+    domain: Optional[str] = field(default=None, metadata=config(field_name="domain"))
+
+
 @dataclass_json
 @dataclass(order=True, eq=True, frozen=True)
 class AuditResults:
@@ -930,6 +981,7 @@ class InternalSearchInputs:
     environment: Optional[Union[SSOEnvironment, TaegisEnum]] = field(
         default=None,
         metadata=config(
+            metadata={"deprecated": True, "deprecation_reason": "No longer supported"},
             encoder=encode_enum,
             decoder=lambda x: decode_enum(SSOEnvironment, x),
             field_name="environment",
@@ -938,6 +990,7 @@ class InternalSearchInputs:
     with_auth0_domain_type: Optional[Union[Auth0DomainType, TaegisEnum]] = field(
         default=None,
         metadata=config(
+            metadata={"deprecated": True, "deprecation_reason": "No longer supported"},
             encoder=encode_enum,
             decoder=lambda x: decode_enum(Auth0DomainType, x),
             field_name="withAuth0DomainType",
@@ -1134,6 +1187,7 @@ class UpdateSSOConnectionInput:
     auth0_domain_type: Optional[Union[Auth0DomainType, TaegisEnum]] = field(
         default=None,
         metadata=config(
+            metadata={"deprecated": True, "deprecation_reason": "No longer supported"},
             encoder=encode_enum,
             decoder=lambda x: decode_enum(Auth0DomainType, x),
             field_name="auth0DomainType",
@@ -1200,6 +1254,7 @@ class TenantSSOConnectionQueryInput:
     environment: Optional[Union[SSOEnvironment, TaegisEnum]] = field(
         default=None,
         metadata=config(
+            metadata={"deprecated": True, "deprecation_reason": "No longer supported"},
             encoder=encode_enum,
             decoder=lambda x: decode_enum(SSOEnvironment, x),
             field_name="environment",
@@ -1224,6 +1279,7 @@ class TenantSSOConnectionQueryInput:
     with_auth0_domain_type: Optional[Union[Auth0DomainType, TaegisEnum]] = field(
         default=None,
         metadata=config(
+            metadata={"deprecated": True, "deprecation_reason": "No longer supported"},
             encoder=encode_enum,
             decoder=lambda x: decode_enum(Auth0DomainType, x),
             field_name="withAuth0DomainType",
@@ -1265,6 +1321,7 @@ class NewSSOConnectionInput:
     auth0_domain_type: Optional[Union[Auth0DomainType, TaegisEnum]] = field(
         default=None,
         metadata=config(
+            metadata={"deprecated": True, "deprecation_reason": "No longer supported"},
             encoder=encode_enum,
             decoder=lambda x: decode_enum(Auth0DomainType, x),
             field_name="auth0DomainType",
@@ -1454,6 +1511,7 @@ class SSOConnection:
     auth0_domain_type: Optional[Union[Auth0DomainType, TaegisEnum]] = field(
         default=None,
         metadata=config(
+            metadata={"deprecated": True, "deprecation_reason": "No longer supported"},
             encoder=encode_enum,
             decoder=lambda x: decode_enum(Auth0DomainType, x),
             field_name="auth0DomainType",

{taegis_sdk_python-1.2.32 → taegis_sdk_python-1.2.34}/taegis_sdk_python/services/threat/types.py

@@ -469,6 +469,10 @@ class ThreatGroupInput:
     motivation: Optional[List[str]] = field(
         default=None, metadata=config(field_name="Motivation")
     )
+    region: Optional[str] = field(default=None, metadata=config(field_name="Region"))
+    target_geography: Optional[List[str]] = field(
+        default=None, metadata=config(field_name="TargetGeography")
+    )
     intended_effect: Optional[List[str]] = field(
         default=None, metadata=config(field_name="IntendedEffect")
     )
@@ -796,6 +800,21 @@ class ThreatReportInput:
     report_id: Optional[str] = field(
         default=None, metadata=config(field_name="reportID")
     )
+    category: Optional[str] = field(
+        default=None, metadata=config(field_name="category")
+    )
+    threat_type: Optional[str] = field(
+        default=None, metadata=config(field_name="threatType")
+    )
+    threat_actor_type: Optional[List[str]] = field(
+        default=None, metadata=config(field_name="threatActorType")
+    )
+    target_geography: Optional[List[str]] = field(
+        default=None, metadata=config(field_name="targetGeography")
+    )
+    target_sectors: Optional[List[str]] = field(
+        default=None, metadata=config(field_name="targetSectors")
+    )
     name: Optional[str] = field(default=None, metadata=config(field_name="name"))
     description: Optional[str] = field(
         default=None, metadata=config(field_name="description")
@@ -884,6 +903,10 @@ class ThreatGroup:
     thematic_area: Optional[str] = field(
         default=None, metadata=config(field_name="ThematicArea")
     )
+    region: Optional[str] = field(default=None, metadata=config(field_name="Region"))
+    target_geography: Optional[List[str]] = field(
+        default=None, metadata=config(field_name="TargetGeography")
+    )
     objectives: Optional[List[str]] = field(
         default=None, metadata=config(field_name="Objectives")
     )
@@ -1309,6 +1332,21 @@ class ThreatReport:
     published: Optional[str] = field(
         default=None, metadata=config(field_name="published")
     )
+    category: Optional[str] = field(
+        default=None, metadata=config(field_name="category")
+    )
+    threat_type: Optional[str] = field(
+        default=None, metadata=config(field_name="threatType")
+    )
+    threat_actor_type: Optional[List[str]] = field(
+        default=None, metadata=config(field_name="threatActorType")
+    )
+    target_geography: Optional[List[str]] = field(
+        default=None, metadata=config(field_name="targetGeography")
+    )
+    target_sectors: Optional[List[str]] = field(
+        default=None, metadata=config(field_name="targetSectors")
+    )
     object_refs: Optional[List[str]] = field(
         default=None, metadata=config(field_name="object_refs")
     )
@@ -1408,36 +1446,84 @@ class ThreatWhereInput:
     malware_contains: Optional[str] = field(
         default=None, metadata=config(field_name="malware_contains")
     )
-    tips: Optional[str] = field(default=None, metadata=config(field_name="tips"))
-    tips_contains: Optional[str] = field(
-        default=None, metadata=config(field_name="tips_contains")
+    cve: Optional[str] = field(default=None, metadata=config(field_name="cve"))
+    cve_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="cve_contains")
     )
-    ta: Optional[str] = field(default=None, metadata=config(field_name="ta"))
-    ta_contains: Optional[str] = field(
-        default=None, metadata=config(field_name="ta_contains")
+    target_sectors_group: Optional[str] = field(
+        default=None, metadata=config(field_name="targetSectorsGroup")
     )
-    ca: Optional[str] = field(default=None, metadata=config(field_name="ca"))
-    ca_contains: Optional[str] = field(
-        default=None, metadata=config(field_name="ca_contains")
+    target_sectors_group_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="targetSectorsGroup_contains")
+    )
+    target_sectors_report: Optional[str] = field(
+        default=None, metadata=config(field_name="targetSectorsReport")
+    )
+    target_sectors_report_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="targetSectorsReport_contains")
+    )
+    motivation: Optional[str] = field(
+        default=None, metadata=config(field_name="motivation")
+    )
+    motivation_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="motivation_contains")
+    )
+    region: Optional[str] = field(default=None, metadata=config(field_name="region"))
+    region_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="region_contains")
+    )
+    target_geography_group: Optional[str] = field(
+        default=None, metadata=config(field_name="targetGeographyGroup")
+    )
+    target_geography_group_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="targetGeographyGroup_contains")
+    )
+    target_geography_report: Optional[str] = field(
+        default=None, metadata=config(field_name="targetGeographyReport")
+    )
+    target_geography_report_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="targetGeographyReport_contains")
+    )
+    type: Optional[str] = field(default=None, metadata=config(field_name="type"))
+    type_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="type_contains")
+    )
+    category: Optional[str] = field(
+        default=None, metadata=config(field_name="category")
+    )
+    category_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="category_contains")
+    )
+    threat_type: Optional[str] = field(
+        default=None, metadata=config(field_name="threatType")
+    )
+    threat_type_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="threatType_contains")
+    )
+    threat_actor_type: Optional[str] = field(
+        default=None, metadata=config(field_name="threatActorType")
+    )
+    threat_actor_type_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="threatActorType_contains")
+    )
+    status: Optional[str] = field(default=None, metadata=config(field_name="status"))
+    status_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="status_contains")
+    )
+    objectives: Optional[str] = field(
+        default=None, metadata=config(field_name="objectives")
+    )
+    objectives_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="objectives_contains")
     )
     country: Optional[str] = field(default=None, metadata=config(field_name="country"))
     country_contains: Optional[str] = field(
         default=None, metadata=config(field_name="country_contains")
     )
-    cve: Optional[str] = field(default=None, metadata=config(field_name="cve"))
-    cve_contains: Optional[str] = field(
-        default=None, metadata=config(field_name="cve_contains")
-    )
     vid: Optional[str] = field(default=None, metadata=config(field_name="vid"))
     vid_contains: Optional[str] = field(
         default=None, metadata=config(field_name="vid_contains")
     )
-    target_sectors: Optional[str] = field(
-        default=None, metadata=config(field_name="targetSectors")
-    )
-    target_sectors_contains: Optional[str] = field(
-        default=None, metadata=config(field_name="targetSectors_contains")
-    )
     aliases: Optional[str] = field(default=None, metadata=config(field_name="aliases"))
     aliases_contains: Optional[str] = field(
         default=None, metadata=config(field_name="aliases_contains")
@@ -1448,15 +1534,17 @@ class ThreatWhereInput:
     thematic_area_contains: Optional[str] = field(
         default=None, metadata=config(field_name="thematicArea_contains")
     )
-    status: Optional[str] = field(default=None, metadata=config(field_name="status"))
-    status_contains: Optional[str] = field(
-        default=None, metadata=config(field_name="status_contains")
+    tips: Optional[str] = field(default=None, metadata=config(field_name="tips"))
+    tips_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="tips_contains")
     )
-    objectives: Optional[str] = field(
-        default=None, metadata=config(field_name="objectives")
+    ta: Optional[str] = field(default=None, metadata=config(field_name="ta"))
+    ta_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="ta_contains")
     )
-    objectives_contains: Optional[str] = field(
-        default=None, metadata=config(field_name="objectives_contains")
+    ca: Optional[str] = field(default=None, metadata=config(field_name="ca"))
+    ca_contains: Optional[str] = field(
+        default=None, metadata=config(field_name="ca_contains")
     )
     tools: Optional[str] = field(default=None, metadata=config(field_name="tools"))
     tools_contains: Optional[str] = field(

{taegis_sdk_python-1.2.32 → taegis_sdk_python-1.2.34/taegis_sdk_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: taegis-sdk-python
-Version: 1.2.32
+Version: 1.2.34
 Summary: Taegis Python SDK
 Home-page: https://github.com/secureworks/taegis-sdk-python
 Author: Secureworks

taegis_sdk_python-1.2.32/taegis_sdk_python/_version.py

@@ -1 +0,0 @@
-__version__ = "v1.2.32"