--- title: "DNS Filter" slug: "dns-filter" updated: 2026-09-16T13:44:23Z published: 2026-09-16T13:44:23Z canonical: "docs.databee.buzz/dns-filter" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.databee.buzz/llms.txt > Use this file to discover all available pages before exploring further. # DNS Filter DNS Filter is a cloud-based DNS security and content filtering platform that protects organizations from malware, phishing, ransomware, and other web-based threats by analysing and filtering DNS queries in real time. It provides comprehensive visibility into all DNS traffic across networks, remote users, and deployed agents, enabling security teams to enforce policies, detect threats, and investigate suspicious activity. For more information on DNS Filter, see the official documentation [here](https://www.dnsfilter.com/). **Integration Method:** API **Tables**: User Inventory Info (5003), DNS Activity (4003) This integration supports the following events. | **Event** | **Description** | | --- | --- | | Users | User account inventory records from the DNS Filter users API | | DNS Query Logs | DNS query and response events from the DNS Filter query logs API | This integration supports the following versions. | DNS Filter API version | V1 | | --- | --- | > [!NOTE] > **Note:** > > DNS Filter is a continuously updated service. As for this document preparation, the latest release was in Aug 4, 2026. More information can be found [here](https://dnsfilter.canny.io/changelog). ## Prerequisites - An active DNS Filter account with Admin access to create API Keys. - The user should have access to the DataBee console. ## Configuration Overview 1. Generate an API Key in DNS Filter. 2. Add the DNS Filter in the DataBee console with the below parameters | **DataBee Parameter** | **DNS Filter Parameter** | | --- | --- | | API Base URL | This is the Base URL that databee will interact with | | Token | [API Key](/docs/dns-filter#api_key) | ## DNS Filter Configuration 1. Log in to your DNS Filter account at [https://app.dnsfilter.com](https://app.dnsfilter.com). 2. In the left navigation panel, expand the **Account** section and click **Account Settings**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dns-filter-image-jc3uz57h.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A32%3A37Z&se=2026-10-30T12%3A32%3A37Z&sr=c&sp=r&sig=9QET9rtbstUfrmPJrGIbYomkfxUP9KTl3dQxRpBEeKQ%3D) 3. Within Account Settings, go to the **Security** section. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dns-filter-image-9sjfwdo6.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A32%3A37Z&se=2026-10-30T12%3A32%3A37Z&sr=c&sp=r&sig=9QET9rtbstUfrmPJrGIbYomkfxUP9KTl3dQxRpBEeKQ%3D) 4. Scroll down to **API Keys** section and click on **Create Key.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dns-filter-image-7je9o381.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A32%3A37Z&se=2026-10-30T12%3A32%3A37Z&sr=c&sp=r&sig=9QET9rtbstUfrmPJrGIbYomkfxUP9KTl3dQxRpBEeKQ%3D) 5. A **Create API Key** panel slides open on the right. In the **Name** field, enter a descriptive name for the key, In the **Expiration** dropdown, select the desired validity period (for example, 1 Year). ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dns-filter-image-bo8a2t88.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A32%3A37Z&se=2026-10-30T12%3A32%3A37Z&sr=c&sp=r&sig=9QET9rtbstUfrmPJrGIbYomkfxUP9KTl3dQxRpBEeKQ%3D) 6. Once details are filled, click on **Generate Key**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dns-filter-image-wa083uvr.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A32%3A37Z&se=2026-10-30T12%3A32%3A37Z&sr=c&sp=r&sig=9QET9rtbstUfrmPJrGIbYomkfxUP9KTl3dQxRpBEeKQ%3D) 7. Once the key is generated, click the **Copy** icon to copy the API Key. This will be required while configuring feed in DataBee. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dns-filter-image-6qqj0ikl.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A32%3A37Z&se=2026-10-30T12%3A32%3A37Z&sr=c&sp=r&sig=9QET9rtbstUfrmPJrGIbYomkfxUP9KTl3dQxRpBEeKQ%3D) > [!NOTE] > **Note:** > > This is the only time the full API key is displayed. Store it in a secure location as you will not be able to retrieve it again. Once the API Key is expired, it needs to be generated again and updated in DataBee to continue data ingestion. 8. Click on **Save** to finalize key creation. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dns-filter-image-l6tw2dbv.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A32%3A37Z&se=2026-10-30T12%3A32%3A37Z&sr=c&sp=r&sig=9QET9rtbstUfrmPJrGIbYomkfxUP9KTl3dQxRpBEeKQ%3D) ## DataBee Configuration 1. Login to the DataBee UI, navigate to **Data** > **Data Feeds** and click the **Add New Data Feed** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dns-filter-image-j59vrubg.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A32%3A37Z&se=2026-10-30T12%3A32%3A37Z&sr=c&sp=r&sig=9QET9rtbstUfrmPJrGIbYomkfxUP9KTl3dQxRpBEeKQ%3D) 2. Search for the **DNS Filter** and click it as shown below. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dns-filter-image-v8d70z3k.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A32%3A37Z&se=2026-10-30T12%3A32%3A37Z&sr=c&sp=r&sig=9QET9rtbstUfrmPJrGIbYomkfxUP9KTl3dQxRpBEeKQ%3D) 3. Click on the **API Ingest** option for collection method. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dns-filter-image-21c18pwf.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A32%3A37Z&se=2026-10-30T12%3A32%3A37Z&sr=c&sp=r&sig=9QET9rtbstUfrmPJrGIbYomkfxUP9KTl3dQxRpBEeKQ%3D) 4. Enter **feed contact information** and scroll down. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dns-filter-image-f5be6nu6.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A32%3A37Z&se=2026-10-30T12%3A32%3A37Z&sr=c&sp=r&sig=9QET9rtbstUfrmPJrGIbYomkfxUP9KTl3dQxRpBEeKQ%3D) 5. In the configuration page, confirm the following: - **API Base URL:** This is the base URL that DataBee will interact with. - **Authorization Method**: Bearer Token - **Token**: Paste the [API Key](/docs/dns-filter#api_key) created. - **Event Types**: Preselected for all the event types that integration pulls. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/dns-filter-image-4tq7u3xy.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A32%3A37Z&se=2026-10-30T12%3A32%3A37Z&sr=c&sp=r&sig=9QET9rtbstUfrmPJrGIbYomkfxUP9KTl3dQxRpBEeKQ%3D) 6. Click **Submit.** ## Troubleshooting Tips - Ensure the API Key is pasted correctly. Since you cannot view the Key after the 1st time, re-create the API Key, paste it on a text editor to ensure no spaces or unexpected characters are included and reconfigure the DataBee feed - If the API Key expires, create a new API Key using same steps and update it in DataBee to continue ingestion.