mirror of
https://github.com/aquasecurity/trivy.git
synced 2025-12-22 15:16:33 -08:00
52 lines
2.2 KiB
Markdown
52 lines
2.2 KiB
Markdown
# AWS Security Hub
|
|
|
|
## Upload findings to Security Hub
|
|
|
|
In the following example using the template `asff.tpl`, [ASFF](https://docs.aws.amazon.com/securityhub/latest/userguide/securityhub-findings-format.html) file can be generated.
|
|
|
|
```
|
|
$ AWS_REGION=us-west-1 AWS_ACCOUNT_ID=123456789012 trivy image --format template --template "@contrib/asff.tpl" -o report.asff golang:1.12-alpine
|
|
```
|
|
|
|
ASFF template needs AWS_REGION and AWS_ACCOUNT_ID from environment variables.
|
|
|
|
The Product [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) field follows the pattern below to match what AWS requires for the [product resource type](https://github.com/awsdocs/aws-security-hub-user-guide/blob/master/doc_source/securityhub-partner-providers.md#aqua-security--aqua-cloud-native-security-platform-sends-findings).
|
|
|
|
{% raw %}
|
|
```
|
|
"ProductArn": "arn:aws:securityhub:{{ env "AWS_REGION" }}::product/aquasecurity/aquasecurity",
|
|
```
|
|
{% endraw %}
|
|
|
|
In order to upload results you must first run [enable-import-findings-for-product](https://docs.aws.amazon.com/cli/latest/reference/securityhub/enable-import-findings-for-product.html) like:
|
|
|
|
```
|
|
aws securityhub enable-import-findings-for-product --product-arn arn:aws:securityhub:<AWS_REGION>::product/aquasecurity/aquasecurity
|
|
```
|
|
|
|
Then, you can upload it with AWS CLI.
|
|
|
|
```
|
|
$ aws securityhub batch-import-findings --findings file://report.asff
|
|
```
|
|
|
|
### Note
|
|
|
|
The [batch-import-findings](https://docs.aws.amazon.com/cli/latest/reference/securityhub/batch-import-findings.html#options) command limits the number of findings uploaded to 100 per request. The best known workaround to this problem is using [jq](https://stedolan.github.io/jq/) to run the following command
|
|
|
|
```
|
|
jq '.[:100]' report.asff 1> short_report.asff
|
|
```
|
|
|
|
## Customize
|
|
You can customize [asff.tpl](https://github.com/aquasecurity/trivy/blob/main/contrib/asff.tpl)
|
|
|
|
```
|
|
$ export AWS_REGION=us-west-1
|
|
$ export AWS_ACCOUNT_ID=123456789012
|
|
$ trivy image --format template --template "@your-asff.tpl" -o report.asff golang:1.12-alpine
|
|
```
|
|
|
|
## Reference
|
|
https://aws.amazon.com/blogs/security/how-to-build-ci-cd-pipeline-container-vulnerability-scanning-trivy-and-aws-security-hub/
|