[New Rule] Azure Key Vault Secret Key Usage by Unusual Identity

detection_rules/etc/non-ecs-schema.json

@@ -203,6 +203,9 @@
     "azure.auditlogs.properties.target_resources.0.modified_properties.3.new_value": "keyword",
     "azure.auditlogs.properties.target_resources.0.modified_properties.2.new_value": "keyword",
     "azure.auditlogs.properties.additional_details.value": "keyword"
+  },
+  "logs-azure.platformlogs-*": {
+    "azure.platformlogs.identity.claim.upn": "keyword"
   },
    "logs-o365.audit-*": {
      "o365.audit.ExtendedProperties.ResultStatusDetail": "keyword",

rules/integrations/azure/credential_access_azure_key_vault_retrieval_from_rare_identity.toml

@@ -0,0 +1,141 @@
+[metadata]
+creation_date = "2025/07/10"
+integration = ["azure"]
+maturity = "production"
+updated_date = "2025/07/10"
+
+[rule]
+author = ["Elastic"]
+description = """
+Identifies secrets, keys, or certificates retrieval operations from Azure Key Vault by a user principal that has not
+been seen doing so in the last 10 days. Azure Key Vault is a cloud service for securely storing and accessing secrets,
+keys, and certificates. Unauthorized or excessive retrievals may indicate potential abuse or unauthorized access
+attempts.
+"""
+false_positives = [
+    """
+    Service accounts or applications that frequently access Azure Key Vault for configuration or operational purposes
+    may trigger this rule.
+    """,
+    """
+    Automated scripts or processes that retrieve secrets or keys for legitimate purposes, such as secret rotation or
+    application configuration, may also lead to false positives.
+    """,
+    """
+    Security teams performing routine audits or assessments that involve retrieving keys or secrets from Key Vaults may
+    trigger this rule if they perform multiple retrievals in a short time frame.
+    """,
+]
+from = "now-9m"
+index = ["filebeat-*", "logs-azure.platformlogs-*"]
+language = "esql"
+license = "Elastic License v2"
+name = "Azure Key Vault Secret Key Usage by Unusual Identity"
+note = """## Triage and analysis
+
+### Investigating Azure Key Vault Secret Key Usage by Unusual Identity
+
+Azure Key Vault is a cloud service that safeguards encryption keys and secrets like certificates, connection strings, and passwords. It is crucial for managing sensitive data in Azure environments. Unauthorized modifications to Key Vaults can lead to data breaches or service disruptions. This rule detects excessive secret or key retrieval operations from Azure Key Vault, which may indicate potential abuse or unauthorized access attempts.
+
+### Possible investigation steps
+- Review the `azure.platformlogs.identity.claim.upn` field to identify the user principal making the retrieval requests. This can help determine if the activity is legitimate or suspicious.
+- Check the `azure.platformlogs.identity.claim.appid` or `azure.platformlogs.identity.claim.appid_display_name` to identify the application or service making the requests. If the application is not recognized or authorized, it may indicate a potential security incident. It is plausible that the application is a FOCI compliant application, which are commonly abused by adversaries to evade security controls or conditional access policies.
+- Analyze the `azure.platformlogs.resource.name` field to determine which Key Vault is being accessed. This can help assess the impact of the retrieval operations and whether they target sensitive resources.
+- Review the `event.action` field to confirm the specific actions being performed, such as `KeyGet`, `SecretGet`, or `CertificateGet`. These actions indicate retrieval of keys, secrets, or certificates from the Key Vault.
+- Check the `source.ip` or `geo.*` fields to identify the source of the retrieval requests. Look for unusual or unexpected IP addresses, especially those associated with known malicious activity or geographic locations that do not align with the user's typical behavior.
+- Use the `time_window` field to analyze the frequency of retrieval operations. If multiple retrievals occur within a short time frame (e.g., within a few minutes), it may indicate excessive or suspicious activity.
+- Correlate the retrieval operations with other security events or alerts in the environment to identify any patterns or related incidents.
+- Triage the user with Entra ID sign-in logs to gather more context about their authentication behavior and any potential anomalies.
+
+### False positive analysis
+- Routine administrative tasks or automated scripts may trigger excessive retrievals, especially in environments where Key Vaults are heavily utilized for application configurations or secrets management. If this is expected behavior, consider adjusting the rule or adding exceptions for specific applications or user principals.
+- Legitimate applications or services may perform frequent retrievals of keys or secrets for operational purposes, such as configuration updates or secret rotation. If this is expected behavior, consider adjusting the rule or adding exceptions for specific applications or user principals.
+- Security teams may perform periodic audits or assessments that involve retrieving keys or secrets from Key Vaults. If this is expected behavior, consider adjusting the rule or adding exceptions for specific user principals or applications.
+- Some applications may require frequent access to keys or secrets for normal operation, leading to high retrieval counts. If this is expected behavior, consider adjusting the rule or adding exceptions for specific applications or user principals.
+
+### Response and remediation
+- Investigate the user principal making the excessive retrieval requests to determine if they are authorized to access the Key Vault and its contents. If the user is not authorized, take appropriate actions to block their access and prevent further unauthorized retrievals.
+- Review the application or service making the requests to ensure it is legitimate and authorized to access the Key Vault. If the application is unauthorized or suspicious, consider blocking it and revoking its permissions to access the Key Vault.
+- Assess the impact of the excessive retrieval operations on the Key Vault and its contents. Determine if any sensitive data was accessed or compromised during the retrievals.
+- Implement additional monitoring and alerting for the Key Vault to detect any further suspicious activity or unauthorized access attempts.
+- Consider implementing stricter access controls or policies for Key Vaults to limit excessive retrievals and ensure that only authorized users and applications can access sensitive keys and secrets.
+- Educate users and administrators about the risks associated with excessive retrievals from Key Vaults and encourage them to follow best practices for managing keys and secrets in Azure environments.
+"""
+references = ["https://www.inversecos.com/2022/05/detection-and-compromise-azure-key.html"]
+risk_score = 43
+rule_id = "75c53838-5dcd-11f0-829c-f661ea17fbcd"
+setup = """#### Required Azure Key Vault Diagnostic Logs
+
+To ensure this rule functions correctly, the following diagnostic logs must be enabled for Azure Key Vault:
+- AuditEvent: This log captures all read and write operations performed on the Key Vault, including secret, key, and certificate retrievals. These logs should be streamed to the Event Hub used for the Azure integration configuration.
+"""
+severity = "medium"
+tags = [
+    "Domain: Cloud",
+    "Domain: Storage",
+    "Domain: Identity",
+    "Data Source: Azure",
+    "Data Source: Azure Platform Logs",
+    "Data Source: Azure Key Vault",
+    "Use Case: Threat Detection",
+    "Use Case: Identity and Access Audit",
+    "Tactic: Credential Access",
+    "Resources: Investigation Guide",
+]
+timestamp_override = "event.ingested"
+type = "new_terms"
+
+query = '''
+event.dataset : "azure.platformlogs" and
+event.outcome: "success" and
+event.action : (
+    "VaultGet" or
+    "KeyGet" or
+    "KeyList" or
+    "KeyListVersions" or
+    "KeyGetDeleted" or
+    "KeyListDeleted" or
+    "SecretGet" or
+    "SecretList" or
+    "SecretListVersions" or
+    "SecretGetDeleted" or
+    "SecretListDeleted" or
+    "CertificateGet" or
+    "CertificateList" or
+    "CertificateListVersions" or
+    "CertificateGetDeleted" or
+    "CertificateListDeleted" or
+    "CertificatePolicyGet" or
+    "CertificateContactsGet" or
+    "CertificateIssuerGet" or
+    "CertificateIssuersList"
+) and azure.platformlogs.identity.claim.upn: *
+'''
+
+
+[[rule.threat]]
+framework = "MITRE ATT&CK"
+[[rule.threat.technique]]
+id = "T1555"
+name = "Credentials from Password Stores"
+reference = "https://attack.mitre.org/techniques/T1555/"
+[[rule.threat.technique.subtechnique]]
+id = "T1555.006"
+name = "Cloud Secrets Management Stores"
+reference = "https://attack.mitre.org/techniques/T1555/006/"
+
+
+
+[rule.threat.tactic]
+id = "TA0006"
+name = "Credential Access"
+reference = "https://attack.mitre.org/tactics/TA0006/"
+
+[rule.new_terms]
+field = "new_terms_fields"
+value = ["azure.platformlogs.identity.claim.upn"]
+[[rule.new_terms.history_window_start]]
+field = "history_window_start"
+value = "now-14d"
+
+