SecurityAssessment¶

class oci.data_safe.models.SecurityAssessment(**kwargs)¶

Bases: object

A security assessment that provides an overall insight into your database security posture. The security assessment results are based on the analysis of your database configurations, user accounts, and security controls. For more information, see Security Assessment Overview.

Attributes

`LIFECYCLE_STATE_CREATING`	A constant which can be used with the lifecycle_state property of a SecurityAssessment.
`LIFECYCLE_STATE_DELETED`	A constant which can be used with the lifecycle_state property of a SecurityAssessment.
`LIFECYCLE_STATE_DELETING`	A constant which can be used with the lifecycle_state property of a SecurityAssessment.
`LIFECYCLE_STATE_FAILED`	A constant which can be used with the lifecycle_state property of a SecurityAssessment.
`LIFECYCLE_STATE_SUCCEEDED`	A constant which can be used with the lifecycle_state property of a SecurityAssessment.
`LIFECYCLE_STATE_UPDATING`	A constant which can be used with the lifecycle_state property of a SecurityAssessment.
`TRIGGERED_BY_SYSTEM`	A constant which can be used with the triggered_by property of a SecurityAssessment.
`TRIGGERED_BY_USER`	A constant which can be used with the triggered_by property of a SecurityAssessment.
`TYPE_COMPARTMENT`	A constant which can be used with the type property of a SecurityAssessment.
`TYPE_LATEST`	A constant which can be used with the type property of a SecurityAssessment.
`TYPE_SAVED`	A constant which can be used with the type property of a SecurityAssessment.
`TYPE_SAVE_SCHEDULE`	A constant which can be used with the type property of a SecurityAssessment.
`compartment_id`	[Required] Gets the compartment_id of this SecurityAssessment.
`defined_tags`	Gets the defined_tags of this SecurityAssessment.
`description`	Gets the description of this SecurityAssessment.
`display_name`	[Required] Gets the display_name of this SecurityAssessment.
`freeform_tags`	Gets the freeform_tags of this SecurityAssessment.
`id`	[Required] Gets the id of this SecurityAssessment.
`ignored_assessment_ids`	Gets the ignored_assessment_ids of this SecurityAssessment.
`ignored_targets`	Gets the ignored_targets of this SecurityAssessment.
`is_baseline`	Gets the is_baseline of this SecurityAssessment.
`is_deviated_from_baseline`	Gets the is_deviated_from_baseline of this SecurityAssessment.
`last_compared_baseline_id`	Gets the last_compared_baseline_id of this SecurityAssessment.
`lifecycle_details`	Gets the lifecycle_details of this SecurityAssessment.
`lifecycle_state`	[Required] Gets the lifecycle_state of this SecurityAssessment.
`link`	Gets the link of this SecurityAssessment.
`schedule`	Gets the schedule of this SecurityAssessment.
`schedule_security_assessment_id`	Gets the schedule_security_assessment_id of this SecurityAssessment.
`statistics`	Gets the statistics of this SecurityAssessment.
`system_tags`	Gets the system_tags of this SecurityAssessment.
`target_ids`	[Required] Gets the target_ids of this SecurityAssessment.
`target_version`	Gets the target_version of this SecurityAssessment.
`time_created`	[Required] Gets the time_created of this SecurityAssessment.
`time_last_assessed`	Gets the time_last_assessed of this SecurityAssessment.
`time_updated`	[Required] Gets the time_updated of this SecurityAssessment.
`triggered_by`	Gets the triggered_by of this SecurityAssessment.
`type`	[Required] Gets the type of this SecurityAssessment.

Methods

__init__(**kwargs) Initializes a new SecurityAssessment object with values from keyword arguments.

LIFECYCLE_STATE_CREATING = 'CREATING'¶: A constant which can be used with the lifecycle_state property of a SecurityAssessment. This constant has a value of “CREATING”

LIFECYCLE_STATE_DELETED = 'DELETED'¶: A constant which can be used with the lifecycle_state property of a SecurityAssessment. This constant has a value of “DELETED”

LIFECYCLE_STATE_DELETING = 'DELETING'¶: A constant which can be used with the lifecycle_state property of a SecurityAssessment. This constant has a value of “DELETING”

LIFECYCLE_STATE_FAILED = 'FAILED'¶: A constant which can be used with the lifecycle_state property of a SecurityAssessment. This constant has a value of “FAILED”

LIFECYCLE_STATE_SUCCEEDED = 'SUCCEEDED'¶: A constant which can be used with the lifecycle_state property of a SecurityAssessment. This constant has a value of “SUCCEEDED”

LIFECYCLE_STATE_UPDATING = 'UPDATING'¶: A constant which can be used with the lifecycle_state property of a SecurityAssessment. This constant has a value of “UPDATING”

TRIGGERED_BY_SYSTEM = 'SYSTEM'¶: A constant which can be used with the triggered_by property of a SecurityAssessment. This constant has a value of “SYSTEM”

TRIGGERED_BY_USER = 'USER'¶: A constant which can be used with the triggered_by property of a SecurityAssessment. This constant has a value of “USER”

TYPE_COMPARTMENT = 'COMPARTMENT'¶: A constant which can be used with the type property of a SecurityAssessment. This constant has a value of “COMPARTMENT”

TYPE_LATEST = 'LATEST'¶: A constant which can be used with the type property of a SecurityAssessment. This constant has a value of “LATEST”

TYPE_SAVED = 'SAVED'¶: A constant which can be used with the type property of a SecurityAssessment. This constant has a value of “SAVED”

TYPE_SAVE_SCHEDULE = 'SAVE_SCHEDULE'¶: A constant which can be used with the type property of a SecurityAssessment. This constant has a value of “SAVE_SCHEDULE”

__init__(**kwargs)¶

Initializes a new SecurityAssessment object with values from keyword arguments. The following keyword arguments are supported (corresponding to the getters/setters of this class):

Parameters:

id (str) – The value to assign to the id property of this SecurityAssessment.
time_created (datetime) – The value to assign to the time_created property of this SecurityAssessment.
time_updated (datetime) – The value to assign to the time_updated property of this SecurityAssessment.
time_last_assessed (datetime) – The value to assign to the time_last_assessed property of this SecurityAssessment.
compartment_id (str) – The value to assign to the compartment_id property of this SecurityAssessment.
display_name (str) – The value to assign to the display_name property of this SecurityAssessment.
target_ids (list[str]) – The value to assign to the target_ids property of this SecurityAssessment.
ignored_targets (list[object]) – The value to assign to the ignored_targets property of this SecurityAssessment.
ignored_assessment_ids (list[object]) – The value to assign to the ignored_assessment_ids property of this SecurityAssessment.
target_version (str) – The value to assign to the target_version property of this SecurityAssessment.
is_baseline (bool) – The value to assign to the is_baseline property of this SecurityAssessment.
is_deviated_from_baseline (bool) – The value to assign to the is_deviated_from_baseline property of this SecurityAssessment.
last_compared_baseline_id (str) – The value to assign to the last_compared_baseline_id property of this SecurityAssessment.
lifecycle_state (str) – The value to assign to the lifecycle_state property of this SecurityAssessment. Allowed values for this property are: “CREATING”, “SUCCEEDED”, “UPDATING”, “DELETING”, “DELETED”, “FAILED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
lifecycle_details (str) – The value to assign to the lifecycle_details property of this SecurityAssessment.
schedule_security_assessment_id (str) – The value to assign to the schedule_security_assessment_id property of this SecurityAssessment.
triggered_by (str) – The value to assign to the triggered_by property of this SecurityAssessment. Allowed values for this property are: “USER”, “SYSTEM”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
description (str) – The value to assign to the description property of this SecurityAssessment.
schedule (str) – The value to assign to the schedule property of this SecurityAssessment.
link (str) – The value to assign to the link property of this SecurityAssessment.
type (str) – The value to assign to the type property of this SecurityAssessment. Allowed values for this property are: “LATEST”, “SAVED”, “SAVE_SCHEDULE”, “COMPARTMENT”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.
statistics (oci.data_safe.models.SecurityAssessmentStatistics) – The value to assign to the statistics property of this SecurityAssessment.
freeform_tags (dict(str, str)) – The value to assign to the freeform_tags property of this SecurityAssessment.
defined_tags (dict(str, dict(str, object))) – The value to assign to the defined_tags property of this SecurityAssessment.
system_tags (dict(str, dict(str, object))) – The value to assign to the system_tags property of this SecurityAssessment.

compartment_id¶

[Required] Gets the compartment_id of this SecurityAssessment. The OCID of the compartment that contains the security assessment.

Returns:	The compartment_id of this SecurityAssessment.
Return type:	str

defined_tags¶

Gets the defined_tags of this SecurityAssessment. Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags

Example: {“Operations”: {“CostCenter”: “42”}}

Returns:	The defined_tags of this SecurityAssessment.
Return type:	dict(str, dict(str, object))

description¶

Gets the description of this SecurityAssessment. The description of the security assessment.

Returns:	The description of this SecurityAssessment.
Return type:	str

display_name¶

[Required] Gets the display_name of this SecurityAssessment. The display name of the security assessment.

Returns:	The display_name of this SecurityAssessment.
Return type:	str

freeform_tags¶

Gets the freeform_tags of this SecurityAssessment. Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags

Example: {“Department”: “Finance”}

Returns:	The freeform_tags of this SecurityAssessment.
Return type:	dict(str, str)

id¶

[Required] Gets the id of this SecurityAssessment. The OCID of the security assessment.

Returns:	The id of this SecurityAssessment.
Return type:	str

ignored_assessment_ids¶

Gets the ignored_assessment_ids of this SecurityAssessment. List containing maps as values. Example: {“Operations”: [ {“CostCenter”: “42”} ] }

Returns:	The ignored_assessment_ids of this SecurityAssessment.
Return type:	list[object]

ignored_targets¶

Gets the ignored_targets of this SecurityAssessment. List containing maps as values. Example: {“Operations”: [ {“CostCenter”: “42”} ] }

Returns:	The ignored_targets of this SecurityAssessment.
Return type:	list[object]

is_baseline¶

Gets the is_baseline of this SecurityAssessment. Indicates whether or not the security assessment is set as a baseline. This is applicable only for saved security assessments.

Returns:	The is_baseline of this SecurityAssessment.
Return type:	bool

is_deviated_from_baseline¶

Gets the is_deviated_from_baseline of this SecurityAssessment. Indicates if the assessment has deviated from the baseline.

Returns:	The is_deviated_from_baseline of this SecurityAssessment.
Return type:	bool

last_compared_baseline_id¶

Gets the last_compared_baseline_id of this SecurityAssessment. The OCID of the baseline against which the latest security assessment was compared.

Returns:	The last_compared_baseline_id of this SecurityAssessment.
Return type:	str

lifecycle_details¶

Gets the lifecycle_details of this SecurityAssessment. Details about the current state of the security assessment.

Returns:	The lifecycle_details of this SecurityAssessment.
Return type:	str

lifecycle_state¶

[Required] Gets the lifecycle_state of this SecurityAssessment. The current state of the security assessment.

Allowed values for this property are: “CREATING”, “SUCCEEDED”, “UPDATING”, “DELETING”, “DELETED”, “FAILED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns:	The lifecycle_state of this SecurityAssessment.
Return type:	str

link¶

Gets the link of this SecurityAssessment. The summary of findings for the security assessment

Returns:	The link of this SecurityAssessment.
Return type:	str

schedule¶

Gets the schedule of this SecurityAssessment. Schedule to save the assessment periodically in the specified format: <version-string>;<version-specific-schedule>

Allowed version strings - “v1” v1’s version specific schedule -<ss> <mm> <hh> <day-of-week> <day-of-month> Each of the above fields potentially introduce constraints. A workrequest is created only when clock time satisfies all the constraints. Constraints introduced: 1. seconds = <ss> (So, the allowed range for <ss> is [0, 59]) 2. minutes = <mm> (So, the allowed range for <mm> is [0, 59]) 3. hours = <hh> (So, the allowed range for <hh> is [0, 23]) <day-of-week> can be either ‘*’ (without quotes or a number between 1(Monday) and 7(Sunday)) 4. No constraint introduced when it is ‘*’. When not, day of week must equal the given value <day-of-month> can be either ‘*’ (without quotes or a number between 1 and 28) 5. No constraint introduced when it is ‘*’. When not, day of month must equal the given value

Returns:	The schedule of this SecurityAssessment.
Return type:	str

schedule_security_assessment_id¶

Gets the schedule_security_assessment_id of this SecurityAssessment. The OCID of the security assessment that is responsible for creating this scheduled save assessment.

Returns:	The schedule_security_assessment_id of this SecurityAssessment.
Return type:	str

statistics¶

Gets the statistics of this SecurityAssessment.

Returns:	The statistics of this SecurityAssessment.
Return type:	oci.data_safe.models.SecurityAssessmentStatistics

system_tags¶

Gets the system_tags of this SecurityAssessment. System tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {“orcl-cloud”: {“free-tier-retained”: “true”}}

Returns:	The system_tags of this SecurityAssessment.
Return type:	dict(str, dict(str, object))

target_ids¶

[Required] Gets the target_ids of this SecurityAssessment. Array of database target OCIDs.

Returns:	The target_ids of this SecurityAssessment.
Return type:	list[str]

target_version¶

Gets the target_version of this SecurityAssessment. The version of the target database.

Returns:	The target_version of this SecurityAssessment.
Return type:	str

time_created¶

[Required] Gets the time_created of this SecurityAssessment. The date and time the security assessment was created, in the format defined by RFC3339.

Returns:	The time_created of this SecurityAssessment.
Return type:	datetime

time_last_assessed¶

Gets the time_last_assessed of this SecurityAssessment. The date and time the security assessment was last executed, in the format defined by RFC3339.

Returns:	The time_last_assessed of this SecurityAssessment.
Return type:	datetime

time_updated¶

[Required] Gets the time_updated of this SecurityAssessment. The date and time the security assessment was last updated, in the format defined by RFC3339.

Returns:	The time_updated of this SecurityAssessment.
Return type:	datetime

triggered_by¶

Gets the triggered_by of this SecurityAssessment. Indicates whether the security assessment was created by system or by a user.

Allowed values for this property are: “USER”, “SYSTEM”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns:	The triggered_by of this SecurityAssessment.
Return type:	str

type¶

[Required] Gets the type of this SecurityAssessment. The type of this security assessment. The possible types are:

LATEST: The most up-to-date assessment that is running automatically for a target. It is system generated. SAVED: A saved security assessment. LATEST assessments are always saved in order to maintain the history of runs. A SAVED assessment is also generated by a ‘refresh’ action (triggered by the user). SAVE_SCHEDULE: The schedule for periodic saves of LATEST assessments. COMPARTMENT: An automatically managed assessment type that stores all details of targets in one compartment.

This type keeps an up-to-date assessment of all database risks in one compartment. It is automatically updated when the latest assessment or refresh action is executed. It is also automatically updated when a target is deleted or move to a different compartment.

Allowed values for this property are: “LATEST”, “SAVED”, “SAVE_SCHEDULE”, “COMPARTMENT”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns:	The type of this SecurityAssessment.
Return type:	str