# HashiCorp Consul

Firefly integrates with HashiCorp Consul to pull in key-value pairs from Consul. This integration allows Firefly to analyze your Consul key-value pairs, providing comprehensive visibility into your infrastructure resources managed through Consul.

## Prerequisites

* A HashiCorp Consul cluster.
* A token with read permissions on the Consul cluster.

## Network Requirements

If your Consul is deployed on-prem, allow the following IP addresses to connect to the cluster:

* 3.224.145.192
* 54.83.245.177
* 3.213.167.195
* 54.146.252.237
* 34.226.97.113
* 54.166.221.160
* 52.22.128.83
* 52.86.171.233
* 34.200.154.87
* 100.25.162.125
* 18.209.82.232
* 98.83.246.85
* 54.144.58.153

## Setup Procedure

1. In Firefly, click **Settings > Integrations**.
2. Click **Add New > HashiCorp Consul**.
3. Go to [HCP](https://portal.cloud.hashicorp.com/) (for HCP Consul), or your on-prem Consul UI (for self-hosted Consul), to create a Consul access token.
4. Copy the token.
5. In Firefly, enter a descriptive name into the **Nickname** field.
6. Enter the **Public cluster address** of your Consul cluster.
7. Paste the Consul access token into the **Token** field.
8. Click **Next**.
9. Click **Done**.

## Configuration Details

* Firefly scans your Consul key-value store by default every 4 hours.
* Your Consul key-value pairs state files list will stay updated automatically.