Finding

class oci.data_safe.models.Finding(**kwargs)

Bases: object

The particular finding reported by the security assessment.

Attributes:

LIFECYCLE_STATE_ACTIVE

A constant which can be used with the lifecycle_state property of a Finding.

LIFECYCLE_STATE_FAILED

A constant which can be used with the lifecycle_state property of a Finding.

LIFECYCLE_STATE_NEEDS_ATTENTION

A constant which can be used with the lifecycle_state property of a Finding.

LIFECYCLE_STATE_UPDATING

A constant which can be used with the lifecycle_state property of a Finding.

SEVERITY_ADVISORY

A constant which can be used with the severity property of a Finding.

SEVERITY_DEFERRED

A constant which can be used with the severity property of a Finding.

SEVERITY_EVALUATE

A constant which can be used with the severity property of a Finding.

SEVERITY_HIGH

A constant which can be used with the severity property of a Finding.

SEVERITY_LOW

A constant which can be used with the severity property of a Finding.

SEVERITY_MEDIUM

A constant which can be used with the severity property of a Finding.

SEVERITY_PASS

A constant which can be used with the severity property of a Finding.

assessment_id

Gets the assessment_id of this Finding.

details

Gets the details of this Finding.

has_target_db_risk_level_changed

Gets the has_target_db_risk_level_changed of this Finding.

is_risk_modified

Gets the is_risk_modified of this Finding.

justification

Gets the justification of this Finding.

key

Gets the key of this Finding.

lifecycle_details

Gets the lifecycle_details of this Finding.

lifecycle_state

Gets the lifecycle_state of this Finding.

oracle_defined_severity

Gets the oracle_defined_severity of this Finding.

references

Gets the references of this Finding.

remarks

Gets the remarks of this Finding.

severity

Gets the severity of this Finding.

summary

Gets the summary of this Finding.

target_id

Gets the target_id of this Finding.

time_updated

Gets the time_updated of this Finding.

time_valid_until

Gets the time_valid_until of this Finding.

title

Gets the title of this Finding.

Methods:

__init__(**kwargs)

Initializes a new Finding object with values from keyword arguments.

LIFECYCLE_STATE_ACTIVE = 'ACTIVE'

A constant which can be used with the lifecycle_state property of a Finding. This constant has a value of “ACTIVE”

LIFECYCLE_STATE_FAILED = 'FAILED'

A constant which can be used with the lifecycle_state property of a Finding. This constant has a value of “FAILED”

LIFECYCLE_STATE_NEEDS_ATTENTION = 'NEEDS_ATTENTION'

A constant which can be used with the lifecycle_state property of a Finding. This constant has a value of “NEEDS_ATTENTION”

LIFECYCLE_STATE_UPDATING = 'UPDATING'

A constant which can be used with the lifecycle_state property of a Finding. This constant has a value of “UPDATING”

SEVERITY_ADVISORY = 'ADVISORY'

A constant which can be used with the severity property of a Finding. This constant has a value of “ADVISORY”

SEVERITY_DEFERRED = 'DEFERRED'

A constant which can be used with the severity property of a Finding. This constant has a value of “DEFERRED”

SEVERITY_EVALUATE = 'EVALUATE'

A constant which can be used with the severity property of a Finding. This constant has a value of “EVALUATE”

SEVERITY_HIGH = 'HIGH'

A constant which can be used with the severity property of a Finding. This constant has a value of “HIGH”

SEVERITY_LOW = 'LOW'

A constant which can be used with the severity property of a Finding. This constant has a value of “LOW”

SEVERITY_MEDIUM = 'MEDIUM'

A constant which can be used with the severity property of a Finding. This constant has a value of “MEDIUM”

SEVERITY_PASS = 'PASS'

A constant which can be used with the severity property of a Finding. This constant has a value of “PASS”

__init__(**kwargs)

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

Parameters
  • key (str) – The value to assign to the key property of this Finding.

  • severity (str) – The value to assign to the severity property of this Finding. Allowed values for this property are: “HIGH”, “MEDIUM”, “LOW”, “EVALUATE”, “ADVISORY”, “PASS”, “DEFERRED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

  • assessment_id (str) – The value to assign to the assessment_id property of this Finding.

  • target_id (str) – The value to assign to the target_id property of this Finding.

  • title (str) – The value to assign to the title property of this Finding.

  • remarks (str) – The value to assign to the remarks property of this Finding.

  • details (object) – The value to assign to the details property of this Finding.

  • summary (str) – The value to assign to the summary property of this Finding.

  • references (oci.data_safe.models.References) – The value to assign to the references property of this Finding.

  • oracle_defined_severity (str) – The value to assign to the oracle_defined_severity property of this Finding.

  • is_risk_modified (bool) – The value to assign to the is_risk_modified property of this Finding.

  • has_target_db_risk_level_changed (bool) – The value to assign to the has_target_db_risk_level_changed property of this Finding.

  • justification (str) – The value to assign to the justification property of this Finding.

  • time_valid_until (datetime) – The value to assign to the time_valid_until property of this Finding.

  • time_updated (datetime) – The value to assign to the time_updated property of this Finding.

  • lifecycle_state (str) – The value to assign to the lifecycle_state property of this Finding. Allowed values for this property are: “ACTIVE”, “UPDATING”, “NEEDS_ATTENTION”, “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 Finding.

property assessment_id

Gets the assessment_id of this Finding. The OCID of the assessment that generated this finding.

Returns

The assessment_id of this Finding.

Return type

str

property details

Gets the details of this Finding. The details of the finding. Provides detailed information to explain the finding summary, typically results from the assessed database, followed by any recommendations for changes.

Returns

The details of this Finding.

Return type

object

property has_target_db_risk_level_changed

Gets the has_target_db_risk_level_changed of this Finding. Determines if this risk level has changed on the target database since the last time ‘severity’ was modified by user.

Returns

The has_target_db_risk_level_changed of this Finding.

Return type

bool

property is_risk_modified

Gets the is_risk_modified of this Finding. Determines if this risk level was modified by user.

Returns

The is_risk_modified of this Finding.

Return type

bool

property justification

Gets the justification of this Finding. User provided reason for accepting or modifying this finding if they choose to do so.

Returns

The justification of this Finding.

Return type

str

property key

Gets the key of this Finding. A unique identifier for the finding. This is common for the finding across targets.

Returns

The key of this Finding.

Return type

str

property lifecycle_details

Gets the lifecycle_details of this Finding. Details about the current state of the finding.

Returns

The lifecycle_details of this Finding.

Return type

str

property lifecycle_state

Gets the lifecycle_state of this Finding. The current state of the finding.

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

Returns

The lifecycle_state of this Finding.

Return type

str

property oracle_defined_severity

Gets the oracle_defined_severity of this Finding. The severity of the finding as determined by security assessment. This cannot be modified by user.

Returns

The oracle_defined_severity of this Finding.

Return type

str

property references

Gets the references of this Finding. Provides information on whether the finding is related to a CIS Oracle Database Benchmark recommendation, STIG rule, or related to a GDPR Article/Recital.

Returns

The references of this Finding.

Return type

oci.data_safe.models.References

property remarks

Gets the remarks of this Finding. The explanation of the issue in this finding. It explains the reason for the rule and, if a risk is reported, it may also explain the recommended actions for remediation.

Returns

The remarks of this Finding.

Return type

str

property severity

Gets the severity of this Finding. The severity of the finding.

Allowed values for this property are: “HIGH”, “MEDIUM”, “LOW”, “EVALUATE”, “ADVISORY”, “PASS”, “DEFERRED”, ‘UNKNOWN_ENUM_VALUE’. Any unrecognized values returned by a service will be mapped to ‘UNKNOWN_ENUM_VALUE’.

Returns

The severity of this Finding.

Return type

str

property summary

Gets the summary of this Finding. The brief summary of the finding. When the finding is informational, the summary typically reports only the number of data elements that were examined.

Returns

The summary of this Finding.

Return type

str

property target_id

Gets the target_id of this Finding. The OCID of the target database.

Returns

The target_id of this Finding.

Return type

str

property time_updated

Gets the time_updated of this Finding. The date and time the risk level of finding was last updated, in the format defined by RFC3339.

Returns

The time_updated of this Finding.

Return type

datetime

property time_valid_until

Gets the time_valid_until of this Finding. The time until which the change in severity(deferred/modified) of this finding is valid.

Returns

The time_valid_until of this Finding.

Return type

datetime

property title

Gets the title of this Finding. The short title for the finding.

Returns

The title of this Finding.

Return type

str