googleSecurityScannerScanConfig
A ScanConfig resource contains the configurations to launch a scan.
\~> Warning: This resource is in beta, and should be used with the terraform-provider-google-beta provider. See Provider Versions for more details on beta resources.
To get more information about ScanConfig, see:
- API documentation
- How-to Guides
- Using Cloud Security Scanner
\~> Warning: All arguments including authenticationGoogleAccountPassword
and authenticationCustomAccountPassword
will be stored in the raw state as plain-text. Read more about sensitive data in state.
Example Usage - Scan Config Basic
/*Provider bindings are generated by running cdktf get.
See https://cdk.tf/provider-generation for more details.*/
import * as google from "./.gen/providers/google";
/*The following providers are missing schema information and might need manual adjustments to synthesize correctly: google.
For a more precise conversion please use the --provider flag in convert.*/
const googleComputeAddressScannerStaticIp =
new google.computeAddress.ComputeAddress(this, "scanner_static_ip", {
name: "scan-basic-static-ip",
provider: "${google-beta}",
});
new google.securityScannerScanConfig.SecurityScannerScanConfig(
this,
"scan-config",
{
display_name: "terraform-scan-config",
provider: "${google-beta}",
starting_urls: [
`http://\${${googleComputeAddressScannerStaticIp.address}}`,
],
target_platforms: ["COMPUTE"],
}
);
Argument Reference
The following arguments are supported:
-
displayName
- (Required) The user provider display name of the ScanConfig. -
startingUrls
- (Required) The starting URLs from which the scanner finds site pages.
-
maxQps
- (Optional) The maximum QPS during scanning. A valid value ranges from 5 to 20 inclusively. Defaults to 15. -
authentication
- (Optional) The authentication configuration. If specified, service will use the authentication configuration during scanning. Structure is documented below. -
userAgent
- (Optional) Type of the user agents used for scanning Default value ischromeLinux
. Possible values areuserAgentUnspecified
,chromeLinux
,chromeAndroid
, andsafariIphone
. -
blacklistPatterns
- (Optional) The blacklist URL patterns as described in https://cloud.google.com/security-scanner/docs/excluded-urls -
schedule
- (Optional) The schedule of the ScanConfig Structure is documented below. -
targetPlatforms
- (Optional) Set of Cloud Platforms targeted by the scan. If empty, APP_ENGINE will be used as a default. Each value may be one ofappEngine
andcompute
. -
exportToSecurityCommandCenter
- (Optional) Controls export of scan configurations and results to Cloud Security Command Center. Default value isenabled
. Possible values areenabled
anddisabled
. -
project
- (Optional) The ID of the project in which the resource belongs. If it is not provided, the provider project is used.
The authentication
block supports:
-
googleAccount
- (Optional) Describes authentication configuration that uses a Google account. Structure is documented below. -
customAccount
- (Optional) Describes authentication configuration that uses a custom account. Structure is documented below.
The googleAccount
block supports:
-
username
- (Required) The user name of the Google account. -
password
- (Required) The password of the Google account. The credential is stored encrypted in GCP. Note: This property is sensitive and will not be displayed in the plan.
The customAccount
block supports:
-
username
- (Required) The user name of the custom account. -
password
- (Required) The password of the custom account. The credential is stored encrypted in GCP. Note: This property is sensitive and will not be displayed in the plan. -
loginUrl
- (Required) The login form URL of the website.
-
scheduleTime
- (Optional) A timestamp indicates when the next run will be scheduled. The value is refreshed by the server after each run. If unspecified, it will default to current server time, which means the scan will be scheduled to start immediately. -
intervalDurationDays
- (Required) The duration of time between executions in days
Attributes Reference
In addition to the arguments listed above, the following computed attributes are exported:
-
id
- an identifier for the resource with format{{name}}
-
name
- A server defined name for this index. Format:projects/{{project}}/scanConfigs/{{serverGeneratedId}}
Timeouts
This resource provides the following Timeouts configuration options:
create
- Default is 20 minutes.update
- Default is 20 minutes.delete
- Default is 20 minutes.
Import
ScanConfig can be imported using any of these accepted formats:
$ terraform import google_security_scanner_scan_config.default projects/{{project}}/scanConfigs/{{name}}
$ terraform import google_security_scanner_scan_config.default {{project}}/{{name}}
$ terraform import google_security_scanner_scan_config.default {{name}}
User Project Overrides
This resource supports User Project Overrides.