API calls supported by AWS Audit Manager
AWS Audit Manager makes API calls to AWS services to collect a snapshot of the configuration details for your AWS resources. You can specify these API calls as a data source when you configure a custom control in Audit Manager.
For every resource that's in the scope of an API call, Audit Manager captures a configuration snapshot and converts it into evidence. This results in one piece of evidence per resource, as opposed to one piece of evidence per API call.
For example, if the ec2_DescribeRouteTables
API call captures configuration
snapshots from five route tables, then you'll get five pieces of evidence in total for the
single API call. Each piece of evidence is a snapshot of the configuration of an individual
route table.
Supported API calls for custom control data sources
The following list of API calls are supported in Audit Manager.
API calls used in the AWS License Manager standard framework
In the AWS License Manager standard
framework, Audit Manager uses a custom activity called GetLicenseManagerSummary
to
collect evidence. This activity calls the following three License Manager APIs:
The data that’s returned is then converted into evidence and attached to the relevant controls in your assessment.
Example
Let's say that you use two licensed products (SQL
Service 2017 and Oracle Database Enterprise
Edition). First, the GetLicenseManagerSummary
activity calls the
ListLicenseConfigurations API, which provides details of license configurations
in your account. Next, it adds additional contextual data for each license configuration by
calling ListUsageForLicenseConfiguration and ListAssociationsForLicenseConfiguration. Finally, it converts the license
configuration data into evidence and attaches it to the respective controls in the framework
(4.5 - Customer managed license for SQL Server 2017 and
3.0.4 - Customer managed license for Oracle Database Enterprise
Edition).
If you’re using a licensed product that isn’t covered by any of the controls in the framework, that license configuration data is attached as evidence to the following control: 5.0 - Customer managed license for other licenses.