---
title: DomainTools
DomainTools
slug: authentication-guides/domaintools-domaintools
docTags: 
createdAt: 2026-10-05T04:42:30.038Z
---

This guide tells you how to authenticate the **DomainTools** connector in Swimlane using API Key authentication.

You will obtain your DomainTools API credentials and configure the connector in Swimlane. The DomainTools connector enables Turbine to retrieve domain and DNS-based threat intelligence for domain enrichment and investigation.

## Prerequisites

### DomainTools Access Requirements

You must have:

- An active DomainTools account with access to the APIs required for the connector actions.
- A valid DomainTools API key.
- Your DomainTools API username, if required by your DomainTools account.
- Network access from Swimlane Turbine to the DomainTools API endpoint.

The Swimlane connector uses API Key authentication.

### Required Credentials

During setup, you will collect:

- **API URL**
- **API Key**
- **API Username**, if applicable

## DomainTools Setup

Take the following steps to obtain your DomainTools API credentials:

1. Log in to your **DomainTools** account.
2. Navigate to your account or API settings.
3. Locate your **API Username** and **API Key**.
4. Copy and securely save the **API Key**. You will use this value when configuring the connector in Swimlane.
5. Note your **API Username** if your DomainTools account requires it for API authentication.

:::hint{type="info"}
Access to individual DomainTools APIs depends on your DomainTools subscription and API entitlements. Ensure your account has access to the APIs required for the actions you intend to use.
:::

## Connector configuration in Swimlane

1. Log in to Turbine.
2. From the left-hand navigation pane, click **ORCHESTRATION** and click **Assets**.
3. Asset homepage opens.
4. Click the plus icon to open the **Configure your Connector Asset** window.
5. Select **DomainTools** from the **Asset type** list.
6. Fill in the **Asset Settings** and **Asset Input** as shown:

| **Field**     | **Description**                                       | **Required/Optional** |
| ------------- | ----------------------------------------------------- | --------------------- |
| url           | URL of the DomainTools API host.                      | Required              |
| api\_username | Username associated with the DomainTools API account. | Optional              |
| api\_key      | API key used to authenticate with DomainTools.        | Required              |
| verify\_ssl   | Enable or disable SSL certificate verification.       | Optional              |
| http\_proxy   | Proxy used to route requests, if required.            | Optional              |

The current DomainTools connector configuration requires url and api\_key, while api\_username, verify\_ssl, and http\_proxy are optional.

Fields with \* marks are required.

7. Click **Create**.

::Image[]{src="https://api.archbee.com/api/optimize/n8uUzk0MM4uC57-zlHNtY/0c7NK3tV7RFuGu0afga8x_image.png" size="200" isUploading="false" width="2048" height="1028" darkWidth="2048" darkHeight="1028" showCaption="false"}

## Troubleshooting

- If authentication fails, verify that the **API Key** was copied correctly and entered correctly in the Swimlane asset.
- If your DomainTools account uses an API username, verify that the correct username is entered in api\_username.
- If an action returns an authorization or access error, verify that your DomainTools subscription provides access to the API used by that action.
- Verify that the url field contains the correct DomainTools API host.
- If a previously working connection stops authenticating, verify that the API credentials are still valid and have not been changed or revoked.
- If requests fail because of certificate validation, verify the verify\_ssl configuration and the SSL certificate used by the target environment.
- If your environment requires a proxy, verify that the http\_proxy field contains the correct proxy configuration.

**Result:** You have successfully authenticated the DomainTools connector in Swimlane.

## Sources

- [DomainTools Connector Documentation](https://docs.swimlane.com/connectors/domaintools)
- DomainTools API Documentation