waft.actions.dashboard_actions.device_posture_actions module

class waft.actions.dashboard_actions.device_posture_actions.DevicePostureActions(dashboard: DashboardActions)

Bases: Actions

Class to define interactions with Zero Trust device posture checks over Cloudflare Python SDK

create_file_rule(name: str, description: str | None = None, expiration: str | None = None, schedule: str | None = None, **rule_input: Unpack[FileInputParam]) → DevicePostureRule

Creates and returns a file-based device posture rule.

Parameters:

  • name (str) – The name of the device posture rule.

  • description (Optional[str]) – The description of the device posture rule. Defaults to None.

  • expiration (Optional[str]) – Sets the expiration time for a posture check result. If empty, the result remains valid until it is overwritten by new data from the WARP client. Defaults to None.

  • schedule (Optional[str]) – Polling frequency for the WARP client posture check. Default: 5m (poll every five minutes). Minimum: 1m. Defaults to None.

  • rule_input (FileInputParam) – The following keyword arguments…

  • operating_system (Required[Literal["windows", "linux", "mac"]]) – Operating system.

  • path (Required[str]) – File path.

  • exists (bool) – Whether or not file exists.

  • sha256 (str) – SHA-256.

  • thumbprint (str) – Signing certificate thumbprint.

Returns:

Device posture rule object

Return type:

DevicePostureRule

create_rule(name: str, type: str, description: str | None = None, expiration: str | None = None, input: FileInputParam | UniqueClientIDInputParam | DomainJoinedInputParam | OSVersionInputParam | FirewallInputParam | SentineloneInputParam | TeamsDevicesCarbonblackInputRequest | TeamsDevicesAccessSerialNumberListInputRequest | DiskEncryptionInputParam | TeamsDevicesApplicationInputRequest | ClientCertificateInputParam | TeamsDevicesClientCertificateV2InputRequest | WorkspaceOneInputParam | CrowdstrikeInputParam | IntuneInputParam | KolideInputParam | TaniumInputParam | SentineloneS2sInputParam | TeamsDevicesCustomS2sInputRequest | None = None, match: Iterable[DeviceMatchParam] | None = None, schedule: str | None = None) → DevicePostureRule

Creates and returns a device posture rule.

Parameters:

  • name (str) – The name of the device posture rule.

  • type (str) – The type of device posture rule.

  • description (Optional[str]) – The description of the device posture rule. Defaults to None.

  • expiration (Optional[str]) – Sets the expiration time for a posture check result. If empty, the result remains valid until it is overwritten by new data from the WARP client. Defaults to None.

  • input (Optional[DeviceInputParam]) – The value to be checked against. Defaults to None.

  • match (Optional[Iterable[DeviceMatchParam]]) – The conditions that the client must match to run the rule. Defaults to None.

  • schedule (Optional[str]) – Polling frequency for the WARP client posture check. Default: 5m (poll every five minutes). Minimum: 1m. Defaults to None.

Returns:

Device posture rule object

Return type:

DevicePostureRule

get_result(device_id: str, posture_rule_id: str, timeout: int = 330) → DevicePostureRuleResult

Returns the result of a specific device posture rule.

Parameters:

  • device_id – registered device ID

  • posture_rule_id – device posture rule ID

  • timeout – Timeout in seconds to wait for rule to evaluate. Default is 330 seconds to allow for 5m scheduled rules to run

Returns:

Device posture rule result object

Return type:

DevicePostureRuleResult

get_rule(posture_rule_id: str) → DevicePostureRule

Fetches a single device posture rule.

Parameters:

posture_rule_id – device posture rule ID

Returns:

Device posture rule object

Return type:

DevicePostureRule