AWS Audit Manager is no longer open to new customers. Existing customers can continue to use the service as normal. For more information, see AWS Audit Manager availability change.
Troubleshooting assessment and evidence collection issues
You can use the information on this page to resolve common assessment and evidence collection issues in Audit Manager.
Evidence collection issues
-
My assessment isn’t collecting compliance check evidence from AWS Security Hub CSPM
-
My assessment isn’t collecting compliance check evidence from AWS Config
-
My assessment isn’t collecting user activity evidence from AWS CloudTrail
-
My assessment isn’t collecting configuration data evidence for an AWS API call
-
My evidence is generated at different intervals, and I'm not sure how often it’s being collected
-
On my assessment details page, I’m prompted to recreate my assessment
-
What’s the difference between a data source and an evidence source?
Assessment issues
I created an assessment but I can’t see any evidence yet
If you can't see any evidence, it's likely that you either didn't wait at least 24 hours after you created the assessment or that there's a configuration error.
We recommend that you check the following:
-
Make sure that 24 hours passed since you created the assessment. Automated evidence becomes available 24 hours after you create the assessment.
-
Make sure that you’re using Audit Manager in the same AWS Region as the AWS service that you’re expecting to see evidence for.
-
If you expect to see compliance check evidence from AWS Config and AWS Security Hub CSPM, make sure that both the AWS Config and Security Hub CSPM consoles display results for these checks. The AWS Config and Security Hub CSPM results should display in the same AWS Region that you use Audit Manager in.
If you still can't see evidence in your assessment and it's not due to one of these issues, check the other potential causes that are described on this page.
My assessment isn’t collecting compliance check evidence from AWS Security Hub CSPM
If you don't see compliance check evidence for an AWS Security Hub CSPM control, this could be due to one of the following issues.
- Missing configuration in AWS Security Hub CSPM
-
This issue can be caused if you missed some configuration steps when you enabled AWS Security Hub CSPM.
To fix this issue, make sure that you enabled Security Hub CSPM with the required settings for Audit Manager. For instructions, see Enable and set up AWS Security Hub CSPM.
- A Security Hub CSPM control name was entered incorrectly in your
ControlMappingSource -
When you use the Audit Manager API to create a custom control, you can specify a Security Hub CSPM control as a data source mapping for evidence collection. To do this, you enter a control ID as the
keywordValue.If you don't see compliance check evidence for a Security Hub CSPM control, it could be that the
keywordValuewas entered incorrectly in yourControlMappingSource. ThekeywordValueis case sensitive. If you enter it incorrectly, Audit Manager might not recognize that rule. As a result, you might not collect compliance check evidence for that control as expected.To fix this issue, update the custom control and revise the
keywordValue. The correct format of a Security Hub CSPM keyword varies. For accuracy, reference the list of Supported Security Hub CSPM controls. AuditManagerSecurityHubFindingsReceiverAmazon EventBridge rule is missing-
When you enable Audit Manager, a rule named
AuditManagerSecurityHubFindingsReceiveris automatically created and enabled in Amazon EventBridge. This rule enables Audit Manager to collect Security Hub CSPM findings as evidence.If this rule isn't listed and enabled in the AWS Region where you use Security Hub CSPM, Audit Manager can't collect Security Hub CSPM findings for that Region.
To resolve this issue, go to the EventBridge console
and confirm that the AuditManagerSecurityHubFindingsReceiverrule exists in your AWS account. If the rule doesn't exist, we recommend that you disable Audit Manager and then re-enable the service. If this action doesn’t resolve the issue, or if disabling Audit Manager isn’t an option, contact Supportfor assistance. - Service-linked AWS Config rules created by Security Hub CSPM
-
Keep in mind that Audit Manager doesn’t collect evidence from the service-linked AWS Config rules that Security Hub CSPM creates. This is a specific type of managed AWS Config rule that's enabled and controlled by the Security Hub CSPM service. Security Hub CSPM creates instances of these service-linked rules in your AWS environment, even if other instances of the same rules already exist. As a result, to prevent evidence duplication, Audit Manager doesn’t support evidence collection from the service-linked rules.
I disabled a security control in Security Hub CSPM. Does Audit Manager collect compliance check evidence for that security control?
Audit Manager doesn't collect evidence for disabled security controls.
If you set the status of a security control to disabled in Security Hub CSPM, no security checks are performed for that control in the current account and Region. As a result, no security findings are available in Security Hub CSPM, and no related evidence is collected by Audit Manager.
By respecting the disabled status that you set in Security Hub CSPM, Audit Manager ensures that your assessment accurately reflects the active security controls and findings that are relevant to your environment, excluding any controls that you intentionally disabled.
I set the status of a finding to Suppressed in Security Hub CSPM. Does Audit Manager collect compliance check evidence about that finding?
Audit Manager collects evidence for security controls that have suppressed findings.
If you set the workflow status of a finding to suppressed
in Security Hub CSPM, this means that you reviewed the finding and do not believe that
any action is needed. In Audit Manager, these suppressed findings are collected as evidence
and attached to your assessment. The evidence details show the evaluation status of
SUPPRESSED reported directly from Security Hub CSPM.
This approach ensures that your Audit Manager assessment accurately represents the findings from Security Hub CSPM, while also providing visibility into any suppressed findings that may require further review or consideration in an audit.
My assessment isn’t collecting compliance check evidence from AWS Config
If you don't see compliance check evidence for an AWS Config rule, this could be due to one of the following issues.
- The rule identifier was entered incorrectly in your
ControlMappingSource -
When you use the Audit Manager API to create a custom control, you can specify an AWS Config rule as a data source mapping for evidence collection. The
keywordValuethat you specify depends on the type of rule.If you don't see compliance check evidence for an AWS Config rule, it could be that the
keywordValuewas entered incorrectly in yourControlMappingSource. ThekeywordValueis case sensitive. If you enter it incorrectly, Audit Manager might not recognize the rule. As a result, you might not collect compliance check evidence for that rule as intended.To fix this issue, update the custom control and revise the
keywordValue.-
For custom rules, make sure that the
keywordValuehas theCustom_prefix followed by the custom rule name. The format of the custom rule name may vary. For accuracy, visit the AWS Config consoleto verify your custom rule names. -
For managed rules, make sure that the
keywordValueis the rule identifier inALL_CAPS_WITH_UNDERSCORES. For example,CLOUDWATCH_LOG_GROUP_ENCRYPTED. For accuracy, reference the list of supported managed rule keywords.Note
For some managed rules, the rule identifier is different from the rule name. For example, the rule identifier for restricted-ssh is
INCOMING_SSH_DISABLED. Make sure to use the rule identifier, not the rule name. To find a rule identifier, choose a rule from the list of managed rules and look for its Identifier value.
-
- The rule is a service-linked AWS Config rule
-
You can use managed rules and custom rules as a data source mapping for evidence collection. However, Audit Manager doesn’t collect evidence from most service-linked rules.
There are only two types of service-linked rule that Audit Manager collects evidence from:
-
Service-linked rules from Conformance Packs
-
Service-linked rules from AWS Organizations
Audit Manager doesn't collect evidence from other service-linked rules, specifically any rules with an Amazon Resource Name (ARN) that contains the following prefix:
arn:aws:config:*:*:config-rule/aws-service-rule/...The reason that Audit Manager doesn't collect evidence from most service-linked AWS Config rules is to prevent duplicate evidence in your assessments. A service-linked rule is a specific type of managed rule that enables other AWS services to create AWS Config rules in your account. For example, some Security Hub CSPM controls use an AWS Config service-linked rule to run security checks. For each Security Hub CSPM control that uses a service-linked AWS Config rule, Security Hub CSPM creates an instance of the required AWS Config rule in your AWS environment. This happens even if the original rule already exists in your account. Therefore, to avoid collecting the same evidence from the same rule twice, Audit Manager ignores the service-linked rule and doesn't collect evidence from it.
-
- AWS Config isn't enabled
-
AWS Config must be enabled in your AWS account. After you've set up AWS Config in this way, Audit Manager collects evidence each time the evaluation of an AWS Config rule occurs. Make sure that you enabled AWS Config in your AWS account. For instructions, see Enable and set up AWS Config.
- The AWS Config rule evaluated a resource configuration before you set up your assessment
-
If your AWS Config rule is set up to evaluate configuration changes for a specific resource, you might see a mismatch between the evaluation in AWS Config and the evidence in Audit Manager. This happens if the rule evaluation occurred before you set up the control in your Audit Manager assessment. In this case, Audit Manager doesn't generate evidence until the underlying resource changes state again and triggers a re-evaluation of the rule.
As a workaround, you can navigate to the rule in the AWS Config console and manually re-evaluate the rule. This invokes a new evaluation of all of the resources that pertain to that rule.
My assessment isn’t collecting user activity evidence from AWS CloudTrail
When you use the Audit Manager API to create a custom control, you can specify a CloudTrail event
name as a data
source mapping for evidence collection. To do so, you enter the event
name as the keywordValue.
If you don't see user activity evidence for a CloudTrail event, it could be that the
keywordValue was entered incorrectly in your
ControlMappingSource. The keywordValue is case
sensitive. If you enter it incorrectly, Audit Manager might not recognize the event name. As
a result, you might not collect user activity evidence for that event as
intended.
To fix this issue, update the custom
control and revise the keywordValue. Make sure that the
event is written as serviceprefix_ActionName. For example,
cloudtrail_StartLogging. For accuracy, review the AWS service
prefix and action names in the Service Authorization Reference.
My assessment isn’t collecting configuration data evidence for an AWS API call
When you use the Audit Manager API to create a custom control, you can specify an AWS API
call as a data
source mapping for evidence collection. To do so, you enter the API
call as the keywordValue.
If you don't see configuration data evidence for an AWS API call, it could be
that the keywordValue was entered incorrectly in your
ControlMappingSource. The keywordValue case sensitive.
If you enter it incorrectly, Audit Manager might not recognize the API call. As a result, you
might not collect configuration data evidence for that API call as intended.
To fix this issue, update the custom
control and revise the keywordValue. Make sure that the API
call is written as serviceprefix_ActionName. For example,
iam_ListGroups. For accuracy, reference the list of AWS API calls supported by AWS Audit Manager.
A common control isn’t collecting any automated evidence
When you review a common control, you might see the following message: This common control doesn’t collect automated evidence from core controls.
This means that no AWS managed evidence sources can currently support this common control. As a result, the Evidence sources tab is empty and no core controls are displayed.
When a common control doesn’t collect automated evidence, it’s referred to as a manual common control. Manual common controls typically require the provision of physical records and signatures, or details about events that occur outside of your AWS environment. For this reason, there are often no AWS data sources that can produce evidence to support the control’s requirements.
If a common control is manual, you can still use it as an evidence source for a custom control. The only difference is that the common control won’t collect any evidence automatically. Instead, you’ll need to manually upload your own evidence to support the requirements of the common control.
To add evidence to a manual common control
-
Create a custom control
-
Create a custom framework
-
Create an assessment
-
Follow the steps to create an assessment from your custom framework.
-
At this point, the manual common control is now an evidence source in an active assessment control.
-
-
Upload manual evidence
-
Follow the steps to add manual evidence to the control in your assessment.
-
Note
As more AWS data sources become available in the future, it’s possible that AWS might update the common control to include core controls as evidence sources. In this case, if the common control is an evidence source in one or more of your active assessment controls, you’ll benefit from these updates automatically. No further set up is needed from your side, and you’ll start to collect automated evidence that supports the common control.
My evidence is generated at different intervals, and I'm not sure how often it’s being collected
The controls in Audit Manager assessments are mapped to various data sources. Each data source has a different evidence collection frequency. As a result, there’s no one-size-fits-all answer for how often evidence is collected. Some data sources evaluate compliance, whereas others only capture resource state and change data without a compliance determination.
The following is a summary of the different data source types and how often they collect evidence.