> ## Documentation Index
> Fetch the complete documentation index at: https://bloodhound.specterops.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrate BloodHound Enterprise with Splunk SOAR

> Learn how to install and configure the BloodHound Enterprise Splunk SOAR app to ingest attack path findings into Splunk SOAR.

<img noZoom src="https://mintcdn.com/specterops/tTIczgde9H07oLXf/assets/enterprise-edition-pill-tag.svg?fit=max&auto=format&n=tTIczgde9H07oLXf&q=85&s=b682a26b342bde12302ec829e265bdb6" alt="Applies to BloodHound Enterprise only" width="225" height="45" data-path="assets/enterprise-edition-pill-tag.svg" />

Splunk SOAR (formerly Phantom) helps security teams orchestrate tools and automate response workflows. This guide focuses on installing and configuring the BloodHound Enterprise app in Splunk SOAR.

<Note>For platform concepts, terminology, and product capabilities, see the [Splunk SOAR documentation](https://help.splunk.com/en/splunk-soar).</Note>

The [BloodHound Enterprise for Splunk SOAR app](https://splunkbase.splunk.com/app/7772) allows you to view attack path findings from BloodHound Enterprise within the Splunk SOAR platform. This integration enables security teams to monitor and respond to potential attack paths in real-time using Splunk SOAR's automation capabilities.

Integrating BloodHound with Splunk SOAR provides the following advantages:

* **Get real-time visibility into attack path findings**: View BloodHound Enterprise findings in Splunk SOAR as they are detected.

* **Automate response playbooks from BloodHound detections**: Trigger investigation and containment workflows automatically when BloodHound Enterprise identifies a risk.

* **Reduce manual triage and improve consistency**: Standardize repeatable response actions across your existing security tooling.

* **Accelerate mitigation of privilege escalation risks**: Use automated tasks to respond to high-impact identity threats faster.

## Prerequisites

Before you begin the installation and configuration process, ensure the following prerequisites are met:

* Admin access to a Splunk SOAR instance
* Access to a BloodHound Enterprise tenant
* BloodHound Enterprise [non-personal API key/ID pair](/integrations/bloodhound-api/working-with-api#create-a-non-personal-api-key%2Fid-pair) with the **Auditor** role

## Install the app

Installing the BloodHound Enterprise for Splunk SOAR app involves the following steps:

<Steps>
  <Step title="Navigate to Splunk SOAR">
    1. Log in to your Splunk SOAR instance as an admin.
    2. Click on the **Home** dropdown in the top-left corner and select **Apps**.

    <Frame>
      <img src="https://mintcdn.com/specterops/HbCgAIdv_OAN1gyR/images/integrations/splunk/soar/image10.jpeg?fit=max&auto=format&n=HbCgAIdv_OAN1gyR&q=85&s=74c9a3298d513e9a7edd653a92e69867" alt="Splunk SOAR home dropdown with Apps option highlighted" width="1600" height="718" data-path="images/integrations/splunk/soar/image10.jpeg" />
    </Frame>
  </Step>

  <Step title="Install the app in Splunk SOAR">
    1. Enter *BloodHound* in the app search box.

           <Frame>
             <img src="https://mintcdn.com/specterops/HbCgAIdv_OAN1gyR/images/integrations/splunk/soar/image11.jpeg?fit=max&auto=format&n=HbCgAIdv_OAN1gyR&q=85&s=76f9b7d479e223e77514175bacf39f7f" alt="Splunk SOAR app search box" width="1600" height="302" data-path="images/integrations/splunk/soar/image11.jpeg" />
           </Frame>

    2. Click **Install**.

           <Frame>
             <img src="https://mintcdn.com/specterops/HbCgAIdv_OAN1gyR/images/integrations/splunk/soar/image12.jpeg?fit=max&auto=format&n=HbCgAIdv_OAN1gyR&q=85&s=3c00dbe73f78008394437d7e31648149" alt="Splunk SOAR install app confirmation" width="1454" height="507" data-path="images/integrations/splunk/soar/image12.jpeg" />
           </Frame>

       After installing the app, you can see it in the **Unconfigured Apps** section.

           <Frame>
             <img src="https://mintcdn.com/specterops/HbCgAIdv_OAN1gyR/images/integrations/splunk/soar/image13.jpeg?fit=max&auto=format&n=HbCgAIdv_OAN1gyR&q=85&s=2e3af708e1c912d915de0bcc31b44f4b" alt="Splunk SOAR unconfigured apps section" width="1600" height="482" data-path="images/integrations/splunk/soar/image13.jpeg" />
           </Frame>
  </Step>
</Steps>

## Configure the app

After installing the BloodHound Enterprise for Splunk SOAR app, you need to configure it to connect to your BloodHound Enterprise tenant and start ingesting attack path findings. The configuration process involves the following steps:

<Steps>
  <Step title="Navigate to app configuration">
    On the **Unconfigured Apps** page, click **Configure New Asset** for the BloodHound Enterprise app.

    <Frame>
      <img src="https://mintcdn.com/specterops/HbCgAIdv_OAN1gyR/images/integrations/splunk/soar/image14.jpeg?fit=max&auto=format&n=HbCgAIdv_OAN1gyR&q=85&s=e32e692bb6963d5ef69f3ecd0c86321b" alt="Splunk SOAR unconfigured apps section with Configure New Asset" width="1600" height="734" data-path="images/integrations/splunk/soar/image14.jpeg" />
    </Frame>
  </Step>

  <Step title="Enter asset details">
    1. Enter the **Asset name** and the **Asset description**.

           <Frame>
             <img src="https://mintcdn.com/specterops/HbCgAIdv_OAN1gyR/images/integrations/splunk/soar/image15.png?fit=max&auto=format&n=HbCgAIdv_OAN1gyR&q=85&s=acd84553c7d0cab54dbc8bb47da6cd72" alt="Splunk SOAR BloodHound Enterprise app details page with Configure button highlighted" width="791" height="546" data-path="images/integrations/splunk/soar/image15.png" />
           </Frame>

    2. Click **Save**.
  </Step>

  <Step title="Configure API credentials">
    1. Click **Asset Settings** to set up the connection to BloodHound Enterprise.

    2. Enter the following details:

       | Field                            | Description                                                                |
       | -------------------------------- | -------------------------------------------------------------------------- |
       | **BloodHound Enterprise Domain** | The URL you use to access your BloodHound Enterprise tenant                |
       | **Token Key**                    | The token key from your BloodHound Enterprise non-personal API key/ID pair |
       | **Token ID**                     | The token ID from your BloodHound Enterprise non-personal API key/ID pair  |

           <Frame>
             <img src="https://mintcdn.com/specterops/HbCgAIdv_OAN1gyR/images/integrations/splunk/soar/image16.jpeg?fit=max&auto=format&n=HbCgAIdv_OAN1gyR&q=85&s=570ea50a329d4384a5cf14c909891d8e" alt="Splunk SOAR BloodHound Enterprise app asset settings page for API credentials configuration with BloodHound Enterprise Domain, Token Key, and Token ID fields" width="1502" height="748" data-path="images/integrations/splunk/soar/image16.jpeg" />
           </Frame>

    3. Click **Save**.
  </Step>

  <Step title="Configure data ingestion">
    1. Click **Ingest Settings** to set up how the app ingests data from BloodHound Enterprise.

    2. Configure the following settings:

       | Field                                                                        | Description                                                                                                                              |
       | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
       | **Label to apply to objects from this source**                               | Select **events** to label ingested data as events in Splunk SOAR                                                                        |
       | **Select a polling interval or schedule to configure polling on this asset** | Choose how often the app should poll BloodHound Enterprise for new findings. For testing, you can select **Off** and use manual polling. |

           <Frame>
             <img src="https://mintcdn.com/specterops/HbCgAIdv_OAN1gyR/images/integrations/splunk/soar/image17.jpeg?fit=max&auto=format&n=HbCgAIdv_OAN1gyR&q=85&s=b2fe39638edee6de2f0a0779f0e82b6b" alt="Splunk SOAR ingest settings page with Label to apply to objects from this source and Select a polling interval or schedule to configure polling on this asset fields highlighted" width="917" height="376" data-path="images/integrations/splunk/soar/image17.jpeg" />
           </Frame>

    3. Click **Save**.
  </Step>

  <Step title="Test connectivity">
    Go back to **Asset Settings** and click **Test Connectivity** to verify the configuration.

    <Frame>
      <img src="https://mintcdn.com/specterops/HbCgAIdv_OAN1gyR/images/integrations/splunk/soar/image18.jpeg?fit=max&auto=format&n=HbCgAIdv_OAN1gyR&q=85&s=d2fda7bc5df73f799dbebee52e02e0a2" alt="Splunk SOAR test connectivity page" width="1289" height="714" data-path="images/integrations/splunk/soar/image18.jpeg" />
    </Frame>

    If the configuration is correct, Splunk SOAR confirms that the app is connected successfully, as shown in the following image.

    <Frame>
      <img src="https://mintcdn.com/specterops/HbCgAIdv_OAN1gyR/images/integrations/splunk/soar/image19.jpeg?fit=max&auto=format&n=HbCgAIdv_OAN1gyR&q=85&s=b0a7867d939e384d8b233a61708bed93" alt="Splunk SOAR successful connectivity confirmation" width="782" height="417" data-path="images/integrations/splunk/soar/image19.jpeg" />
    </Frame>
  </Step>

  <Step title="Ingest data">
    If you set the polling interval to **Off** for testing, you can manually poll for events to start ingesting data from BloodHound Enterprise.

    1. Click **Ingest Settings**.

    2. Enter the following values:

       | Field                  | Description                                                                          |
       | ---------------------- | ------------------------------------------------------------------------------------ |
       | **Maximum containers** | The maximum number of containers (event groupings) to ingest per polling cycle.      |
       | **Maximum artifacts**  | The maximum number of artifacts (individual data items) to ingest per polling cycle. |

       <Note>See the [Splunk SOAR documentation](https://help.splunk.com/en/splunk-soar) for more information about these settings.</Note>

    3. Click **Poll Now**.

           <Frame>
             <img src="https://mintcdn.com/specterops/HbCgAIdv_OAN1gyR/images/integrations/splunk/soar/image20.png?fit=max&auto=format&n=HbCgAIdv_OAN1gyR&q=85&s=6c8a409ea83b370cddb19e8d22d4c74e" alt="Splunk SOAR poll now option" width="757" height="184" data-path="images/integrations/splunk/soar/image20.png" />
           </Frame>

       After polling completes, confirm that containers and artifacts were added successfully, as shown below.

           <Frame>
             <img src="https://mintcdn.com/specterops/HbCgAIdv_OAN1gyR/images/integrations/splunk/soar/image21.jpeg?fit=max&auto=format&n=HbCgAIdv_OAN1gyR&q=85&s=09749064c0a45f14da4c0284935b048b" alt="Splunk SOAR successful data ingestion confirmation" width="763" height="508" data-path="images/integrations/splunk/soar/image21.jpeg" />
           </Frame>

    4. Click **Close**.
  </Step>
</Steps>

## Next steps

The configuration is now complete. You can [view attack path findings](/integrations/splunk/soar/use) from BloodHound Enterprise in Splunk SOAR and use them to trigger automated response playbooks.
