Vault root token

Documentos > Datadog Security > OOTB Rules > Vault root token

Set up the vault integration.

This page is not yet available in Spanish. We are working on its translation.
If you have any questions or feedback about our current translation project, feel free to reach out to us!

Goal

Detect when a vault root token is used. Root tokens can perform any activity and have the highest level of privileges in Vault and should only be used in emergencies.

Strategy

This rule monitors Vault Audit Logs (source:vault) to detect when root is seen in:

auth policy (@auth.policies)

This rule also monitors the API endpoint /sys/generate-root which is used to create new root keys.

Triage & Response

Determine who created the root token and when. You can get token creation time using the token accessor with vault token lookup -accessor <accessor>.
Inspect the requests made with the root token and ensure that its usage is valid.
Ensure that after the root token is no longer needed, it is revoked (vault token revoke -accessor <token>).

Change Log

29 June 2022 - Updated queries to reduce noise levels. Replaced initial query with token creation detection.
17 October 2022 - Updated queries and cases.
13 December 2023 - Updated group by values.
23 September 2024 - Reduce severity of cases to Medium.