Overview

A CloudWatch Alarm that triggers on changes to customer created CMKs: Key creation, deletion, or enabling/disabling operations, imported key material operations, as well as updates to CMK Key policies.

Prerequisites: This Alarm requires CloudTrail enabled, with events sent to a CloudWatch Log Group. See Related Configuration Items for configuration to enable CloudTrail/CloudWatch, or enter the CloudWatch Log Group name under the Metric Filter Configuration section.

Configuration Templates

Items
3
Size
1.5 KB
Missing Parameters
AWSTemplateFormatVersion: '2010-09-09'
Description: ''
Resources:
  SnsTopic:
    Type: 'AWS::SNS::Topic'
    Properties:
      Subscription:
        - Endpoint: email@example.com
          Protocol: email
      TopicName: alarm-action
  CloudWatchAlarm:
    Type: 'AWS::CloudWatch::Alarm'
    Properties:
      AlarmName: kms_key_operations
      AlarmDescription: >-
        A CloudWatch Alarm that triggers on changes to customer created CMKs:
        Key creation, deletion, or enabling/disabling operations, imported key
        material operations, as well as updates to CMK Key policies.
      MetricName: KMSCustomerKeyUpdates
      Namespace: CloudTrailMetrics
      Statistic: Sum
      Period: '60'
      EvaluationPeriods: '1'
      Threshold: '1'
      ComparisonOperator: GreaterThanOrEqualToThreshold
      AlarmActions:
        - Ref: SnsTopic
      TreatMissingData: notBreaching
  MetricFilter:
    Type: 'AWS::Logs::MetricFilter'
    Properties:
      LogGroupName: ''
      FilterPattern: >-
        { ($.eventSource = kms.amazonaws.com) &&  (($.eventName=DisableKey) ||
        ($.eventName=ScheduleKeyDeletion) || ($.eventName=CancelKeyDeletion) ||
        ($.eventName=CreateKey) || ($.eventName=CreateAlias) ||
        ($.eventName=EnableKey) || ($.eventName=PutKeyPolicy) ||
        ($.eventName=ImportKeyMaterial) ||
        ($.eventName=DeleteImportedKeyMaterial)) }
      MetricTransformations:
        - MetricValue: '1'
          MetricNamespace: CloudTrailMetrics
          MetricName: KMSCustomerKeyUpdates
Parameters: {}
Metadata: {}
Conditions: {}

Actions



Configure Action

Metric Filter Configuration


Alarm Configuration

* Required field

Sources and Documentation

Configuration Source: AWS Documentation

Additional Documentation: