Configure HCP Vault Audit Logs Streaming to Splunk

2min
HCP
Vault

This tutorial covers configuration of HCP Vault audit logs streaming to your existing Splunk environment.

Availability: HCP Vault audit logs streaming is available for all production grade clusters. The feature is not available for Development tier clusters.

Prerequisites

To configure audit logs streaming to Splunk, you will need to have:

Have access to a paid Splunk Cloud or Enterprise account.
Note: Splunk Cloud Trial account would not work with HCP Vault as its HEC (HTTP Event Collector ) listener is hosted using a self signed certificate that HCP won't trust.
Your Splunk HEC and token.
Note: HEC endpoint should be created using events and not metrics index in Splunk.
An account with Admin or Contributor role assigned in HCP
A production grade HCP Vault cluster

If you don't have a cluster running, refer to the Create a Vault Cluster on HCP tutorial to create an HCP Vault cluster through HCP Portal. Or, refer to the Deploy HCP Vault with Terraform tutorial to provision an HCP Vault cluster using Terraform.

Enable audit logs streaming

From the HCP Vault cluster Overview page, select the Audit Logs view.
Click Enable Streaming.
From the Enable audit logs streaming view, select Splunk as the provider.
Under Splunk configuration, enter your HTTP Event Collector (HEC) Endpoint URL and event collector Token.
Click Save.
NOTE: At this time HCP Vault only supports audit log streaming to one log endpoint at a time.

Refer to the Splunk documentation for instructions on log querying.

Edit the audit log streaming configuration

To edit a audit log streaming integration, perform the following steps.

From the Audit Logs page, click on the Manage drop-down, then Edit configuration.
Edit the configuration, then click Save.

Disable audit log streaming

To disable a audit log streaming integration, from the Audit Logs page, click on the Manage drop-down, then Disable streaming.

Next Collection