# BigID

Euno's BigID integration supports auto-discovery of tables and columns with BigID attributes and classification metadata.

## Setting up BigID integration

### Overview

BigID is a data security and privacy platform that discovers, classifies, and protects sensitive data across your data stores. The BigID integration connects to BigID's API to observe tables and columns that BigID has scanned, enriching them in Euno with BigID attributes.

To discover BigID-enriched resources, Euno authenticates to the BigID API using a system user token and streams data object metadata from BigID's view of your datastores. Euno observes tables and columns that have BigID attributes, adding BigID-specific properties to the corresponding table and column resources in the Euno data model.

### Step 1: Create a BigID System User and Obtain the Token

1. Log in to your BigID instance as an administrator.
2. Follow the instructions in BigID's documentation to create or edit a **system user**: [System Users](https://docs.bigid.com/docs/system-users).\
   \&#xNAN;*(You'll need to authenticate using your BigID credentials to access the docs)*
3. Create a system user (or use an existing one). Assign it the following permissions:

* Catalog -> Read
* Catalog -> Manual Fields -> Read (optional, allows Euno to observe manual fields)
* Catalog -> Business Attributes -> Read (optional, allows Euno to observe business attributes)

4. Copy the **token value** for that system user — you will need this value to connect Euno to your BigID instance.

{% hint style="warning" %}
**Important**: Store the token securely. Treat it like a password.
{% endhint %}

### Step 2: Configure New BigID Source in Euno

#### Access the Sources Page

1. Go to the **Sources** page in Euno.
2. Click on **Add New Source** and select **BigID** from the list of supported platforms.

#### General Configuration

Asterisk (\*) means a mandatory field.

| Configuration | Description                                                                       |
| ------------- | --------------------------------------------------------------------------------- |
| Name\*        | Enter a name for your BigID source (e.g., "BigID - Data Security")                |
| Token\*       | The BigID system user token value from Step 1                                     |
| Base URL\*    | The base URL of your BigID server (e.g., `https://your-bigid-instance.bigid.com`) |

### Step 3: Schedule

* Enable the Schedule option.
* Choose:
  1. **Weekly**: Set specific days and times.
  2. **Hourly**: Define the interval in hours (e.g., every 8 hours).

{% hint style="info" %}
**Recommended**: Schedule the BigID integration to run daily or every 12 hours to keep attribute and classification metadata in sync with BigID.
{% endhint %}

### Step 4: Resource Cleanup

To keep your data relevant and free of outdated resources, Euno provides automatic **resource cleanup** options. For a detailed explanation on Euno's cleanup strategies, see: [Resource Sponsorship in Euno](/developer-reference/technical-concepts/resource-sponsorship-and-cleanup-in-euno.md).

* **Immediate Cleanup**: Remove resources not detected in the most recent successful source integration run.
* **No Cleanup**: Keep all resources indefinitely, even if they are no longer detected.

### Step 5: Advanced Settings (Optional)

Click on the **Advanced** section to display these additional configurations.

| Configuration                   | Description                                                                                                                                 |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Data Objects Pattern            | Use a regular expression to include or exclude specific data objects (e.g., tables). For example, `.*` will include or exclude all objects. |
| Attributes Pattern              | Use a regular expression to include or exclude specific attributes. For example, `.*` will include or exclude all attributes.               |
| Attribute Confidence Threadhold | Only attributes with confidence higher than this number will be observed as `bigid_attributes`                                              |

### Step 6: Save Configuration

Click the **Test & Save** button to complete the setup. Euno will:

1. Authenticate using the provided token and base URL.
2. Verify access to the BigID API.
3. Save the configuration if validation passes.

If the test fails, review the error message and verify your token and base URL.

## Discovered Resources

The BigID integration augments warehouse table and column resources with BigID attribute properties. For detailed information about discovered resources and their indexed properties, see [bigid-integration-discovered-resources](/sources/data-security/bigid-integration/bigid-integration-discovered-resources.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.euno.ai/sources/data-security/bigid-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
