Detection rules › YARA-L
AWS API Gateway Keys Accessed
Detects when AWS API Gateway keys are accessed.
MITRE ATT&CK coverage
| Tactic | Techniques |
|---|---|
| Credential Access | T1555 Credentials from Password Stores |
Event coverage
| Provider | Event |
|---|---|
| AWS-apigateway | GetApiKey |
| AWS-apigateway | GetApiKeys |
Rule body yaral
/*
* Copyright 2024 Google LLC
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* https://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
rule aws_api_gateway_get_keys {
meta:
author = "Google Cloud Security"
description = "Detects when AWS API Gateway keys are accessed."
rule_id = "mr_1d8ffb2e-ca26-4f8f-8ca1-3dd4694776f5"
rule_name = "AWS API Gateway Keys Accessed"
mitre_attack_tactic = "Credential Access"
mitre_attack_technique = "Credentials from Password Stores"
mitre_attack_url = "https://attack.mitre.org/techniques/T1555/"
mitre_attack_version = "v15.1"
type = "Alert"
data_source = "AWS CloudTrail"
platform = "AWS"
severity = "Low"
priority = "Low"
events:
$cloudtrail.metadata.vendor_name = "AMAZON"
$cloudtrail.metadata.product_name = "AWS CloudTrail"
(
($cloudtrail.metadata.product_event_type = "GetApiKey" and $cloudtrail.target.resource.attribute.labels["requestParameters.includeValue"] = "true") or
($cloudtrail.metadata.product_event_type = "GetApiKeys" and $cloudtrail.target.resource.attribute.labels["requestParameters.includeValues"] = "true")
)
$cloudtrail.security_result.action = "ALLOW"
$cloudtrail.principal.ip = $ip
match:
$ip over 1h
outcome:
$risk_score = max(35)
$mitre_attack_tactic = "Credential Access"
$mitre_attack_technique = "Credentials from Password Stores"
$mitre_attack_technique_id = "T1555"
$event_count = count_distinct($cloudtrail.metadata.id)
$network_http_user_agent = array_distinct($cloudtrail.network.http.user_agent)
$principal_ip = array_distinct($cloudtrail.principal.ip)
$principal_ip_country = array_distinct($cloudtrail.principal.ip_geo_artifact.location.country_or_region)
$principal_ip_state = array_distinct($cloudtrail.principal.ip_geo_artifact.location.state)
$principal_user_display_name = array_distinct($cloudtrail.principal.user.user_display_name)
$recipient_aws_account_id = array_distinct($cloudtrail.additional.fields["recipientAccountId"])
$aws_region = array_distinct($cloudtrail.principal.location.name)
$target_api_key = array_distinct($cloudtrail.target.resource.attribute.labels["requestParameters.apiKey"])
$accessed_via_console = array_distinct($cloudtrail.target.resource.attribute.labels["sessionCredentialFromConsole"])
condition:
$cloudtrail
}
Detection logic
Fires when at least one $cloudtrail event in the 1h window.
Events
$cloudtrail
metadata.product_event_type = "GetApiKey"target.resource.attribute.labels["requestParameters.includeValue"] = "true"metadata.product_event_type = "GetApiKeys"target.resource.attribute.labels["requestParameters.includeValues"] = "true"security_result.action = "ALLOW"
Correlation
Outcome
Fields the detection emits on a match. $risk_score drives alerting; Chronicle surfaces the rest on the detection.
| Field | Expression |
|---|---|
risk_score | max(35) |
event_count | count_distinct($cloudtrail.metadata.id) |
network_http_user_agent | array_distinct($cloudtrail.network.http.user_agent) |
principal_ip | array_distinct($cloudtrail.principal.ip) |
principal_ip_country | array_distinct($cloudtrail.principal.ip_geo_artifact.location.country_or_region) |
principal_ip_state | array_distinct($cloudtrail.principal.ip_geo_artifact.location.state) |
principal_user_display_name | array_distinct($cloudtrail.principal.user.user_display_name) |
recipient_aws_account_id | array_distinct($cloudtrail.additional.fields["recipientAccountId"]) |
aws_region | array_distinct($cloudtrail.principal.location.name) |
target_api_key | array_distinct($cloudtrail.target.resource.attribute.labels["requestParameters.apiKey"]) |
accessed_via_console | array_distinct($cloudtrail.target.resource.attribute.labels["sessionCredentialFromConsole"]) |