AWS FAQ and Troubleshooting
This article contains:
- A list of frequently asked questions related to onboarding AWS to Tenable One AI Exposure.
- Account status and troubleshooting information.
Access to Us-East-1 Region
Even though you may have granted Tenable all required permissions within regions that your organization is using, since some AWS services are global, Tenable must have permissions to query the global endpoint (us-east-1). For more information, refer to relevant AWS documentation here{target=_blank} and here{target=_blank}.
If you use service control policies (SCPs) in your AWS organization, make sure to add exclusions to any existing SCP to ensure that the dedicated IAM role you create for Tenable is not included.
AWS Console Access to Account
Generally speaking, AI Exposure only pulls information via the API. However, some data (for example, Lambda triggers and AWS SSO) is not available using Amazon’s publicly documented API. To get this information, Tenable uses API calls that are typically used by the AWS console, resulting in the alerts that you're seeing. These are essentially undocumented APIs. The alerts are completely normal, and are in fact the expected behavior. Tenable never accesses your console manually at any point. All access is strictly via the API.
Exclude an OU or Account from Organization
To modify your organization's scope and remove specific entities:
- In the Console, navigate to Settings > Integrations.
- Click on the three dots menu next to the organization, and click Edit.
- Click Next to navigate to the last step in the wizard (Scopes).
- Select Exclude specific OUs and accounts and then select the relevant OU or account.
- Click Finish. It will be removed from the Console the next time Tenable syncs data in your environment.
GetObject Permission for Elastic Beanstalk Buckets
The Elastic Beanstalk configuration is stored in an S3 bucket. As a result, there is no alternative way of accessing configuration for this service other than via this permission.
Need for Both Custom Policy and SecurityAudit Policy
Tenable continuously adds new features and functionality to its offering. To support this, the custom inline policy is updated by Tenable from time to time. The SecurityAudit policy contains an even broader permission set, and, together with the inline policy, ensures support for the rapidly expanding set of features that are added to AI Exposure. To ensure complete and ongoing support for all current and future functionality in Tenable, and to give you the flexibility of not having to constantly track/update the permission set, both policies are needed. For step-by-step guidance on resolving AWS role and permission errors, see Resolve Cloud Onboarding Permission and Role Errors (AWS, Azure, GCP).
New AWS Services and Permissions
As soon as the new services or permissions become available, but it may take up to one week before they are displayed in the AI Exposure Console. The process of detecting such changes is done programmatically, and not manually.
Update the Integration Name for the Organization
Yes. This is useful if you have multiple organizations and want clearer identification.
To update the name:
- In the AI Exposure Console, navigate to Settings > Integrations.
- Next to the relevant integration, click the three dots menu, and then Edit.
- Navigate to step 2 in the wizard and update the Organization Name field.
- Click Next to navigate to the last step in the wizard and then click Update.
ECS Task Definitions in Inventory
To keep your inventory focused and up to date, Tenable only synchronizes Task Definitions that meet at least one of the following criteria:
- The status is Active.
- The definition is Inactive but is currently referenced by an active ECS service or task.
Inactive and unused Task Definitions are automatically excluded from the inventory to ensure your data reflects your actual attack surface. Any findings associated with these excluded resources are automatically closed.
Multi-Region CloudTrail
AI Exposure requires the continuous auditing of management events in all regions for, among other reasons, the ability to recommend removing unused permissions. To provide such recommendations with complete confidence, Tenable needs visibility into the full range of logs, across the entire environment, to ensure that such actions/permissions aren't being used.
Account Status and Troubleshooting
AI Exposure displays a Status for each account on the Accounts > AWS page, indicating, for example, whether Tenable can connect to the account, and helping you troubleshoot potential onboarding issues.
| Status | Description |
|---|---|
| Access denied | AI Exposure wasn't able to synchronize one or more resource types. Although there are various reasons why this might happen, it is likely because you need to update the AI Exposure read-only policy (added during account onboarding) in AWS. |
| Account not found | |
| Connected | AI Exposure successfully connected to the account, and the account is up and running. |
| Connected with issues |
The cluster is connected, but there are specific issues that need to be addressed:
|
| Deleting... this may take up to an hour | You deleted the account in AI Exposure, and the process hasn't completed yet. |
| Disconnected | There is an issue with the IAM role that you created during account onboarding to delegate permissions to AI Exposure. It may have been deleted, or there was a change in the trust policy that prevents Tenable from assuming the role. |
| Invalid permissions | There is an issue with the IAM role that you created during account onboarding to delegate permissions to AI Exposure. Some permissions are missing. Please add the required permissions to the IAM role. |
| Failed to query regions | AI Exposure was unable to query the active regions that you selected in account onboarding. One or more of the regions may be disabled. Modify the region list or add an exclusion for the IAM Role from your SCPs and RCPs. Refer to the relevant AWS documentation for more information. |
| Pending deletion | The account is pending closure in AWS. It will eventually be deleted. Resources and findings associated with accounts pending deletion are hidden in AI Exposure. |
| Read-only policy is incorrect |
The AI Exposure read-only policy is missing one or more of the following actions:
|
| Suspended | The account is suspended in AWS. It will eventually be deleted. Resources and findings of suspended accounts are hidden in AI Exposure. |
CloudTrail Status
See AWS CloudTrail for more information about CloudTrail-related issues.
| Status | Description |
|---|---|
| Connected | Analyzing CloudTrail logs |
| Duplicate events | CloudTrail contains duplicate events. Please ensure the trail is configured correctly. This can happen if you configure multiple trails for the same account that cover overlapping event types. |
| Invalid CloudTrail configured | Invalid CloudTrail configured. Please select a valid trail or modify its configuration. |
| Missing permissions | Missing permissions to the CloudTrail service (cannot fetch list of trails). |
| Missing permissions to bucket | Missing permissions to read CloudTrail events from the target S3 bucket (may belong to a different account). |
| Not configured | CloudTrail logs aren't being analyzed. Please configure a valid trail. |