Add ability to configure timeout for Scans

Through the scan configuration a maximum number of seconds
(timeoutSeconds) can be configured.

When a scan is triggered from a configuration this number of seconds
will be added to the start time and saved as timeoutTime on the Scan
object.

If while the Scan is running the current time exceeds the timeoutTime
then the scan is automatically failed and any remaining AssetScans will
be terminated.

If no timeoutTime is provided on a scan it will be automatically timed
out 48 hours after the start time of the scan.

api/models/scan.go

@@ -15,6 +15,8 @@
 
 package models
 
+import "time"
+
 func (s *Scan) GetState() (ScanState, bool) {
 	var state ScanState
 	var ok bool
@@ -47,3 +49,25 @@ func (s *Scan) GetScanConfigScope() (ScanScopeType, bool) {
 
 	return scope, ok
 }
+
+func (s *Scan) GetTimeoutTime() (time.Time, bool) {
+	var timeoutTime time.Time
+	var ok bool
+
+	if s.TimeoutTime != nil {
+		timeoutTime, ok = *s.TimeoutTime, true
+	}
+
+	return timeoutTime, ok
+}
+
+func (s *Scan) GetTimeoutSeconds() (int, bool) {
+	var timeoutSec int
+	var ok bool
+
+	if s.ScanConfigSnapshot != nil {
+		timeoutSec, ok = s.ScanConfigSnapshot.GetTimeoutSeconds()
+	}
+
+	return timeoutSec, ok
+}

api/models/scanconfigsnapshot.go

@@ -32,3 +32,14 @@ func (s *ScanConfigSnapshot) GetMaxParallelScanners() int {
 
 	return DefaultMaxParallelScanners
 }
+
+func (s *ScanConfigSnapshot) GetTimeoutSeconds() (int, bool) {
+	var timeoutSec int
+	var ok bool
+
+	if s.TimeoutSeconds != nil {
+		timeoutSec, ok = *s.TimeoutSeconds, true
+	}
+
+	return timeoutSec, ok
+}

api/openapi.yaml

@@ -1056,10 +1056,18 @@ components:
         endTime:
           type: string
           format: date-time
+        timeoutTime:
+          description: |
+            A time in the future when this Scan will be automatically aborted
+            if it is still in progress.
+          type: string
+          format: date-time
         scanConfig:
           $ref: '#/components/schemas/ScanConfigRelationship'
+          readOnly: true
         scanConfigSnapshot:
           $ref: '#/components/schemas/ScanConfigSnapshot'
+          readOnly: true
         targetIDs:
           description: List of target IDs that are targeted for scanning as part of this scan
           type: array
@@ -1237,6 +1245,11 @@ components:
           $ref: '#/components/schemas/ScanFamiliesConfig'
         scope:
           $ref: '#/components/schemas/ScanScopeType'
+        timeoutSeconds:
+          type: integer
+          description: |
+            The maximum time in seconds that a scan started from this config
+            should run for before being automatically aborted.
         scheduled:
           $ref: '#/components/schemas/RuntimeScheduleScanConfig'
         maxParallelScanners:
@@ -1281,6 +1294,12 @@ components:
         scope:
           $ref: '#/components/schemas/ScanScopeType'
           readOnly: true
+        timeoutSeconds:
+          type: integer
+          description: |
+            The maximum time in seconds that a scan started from this config
+            should run for before being automatically aborted.
+          readOnly: true
         scheduled:
           $ref: '#/components/schemas/RuntimeScheduleScanConfig'
           readOnly: true
@@ -1315,6 +1334,11 @@ components:
           $ref: '#/components/schemas/ScanFamiliesConfig'
         scope:
           $ref: '#/components/schemas/ScanScopeType'
+        timeoutSeconds:
+          type: integer
+          description: |
+            The maximum time in seconds that a scan started from this config
+            should run for before being automatically aborted.
         scheduled:
           $ref: '#/components/schemas/RuntimeScheduleScanConfig'
         maxParallelScanners: