---
title: GreyNoise
 
 Introduction
slug: authentication-guides/greynoise-introduction
docTags: 
createdAt: 2026-10-05T04:45:45.593Z
---

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

You will obtain an API key from GreyNoise and configure the connector in Swimlane. The connector uses the GreyNoise API to retrieve context and threat intelligence for IP addresses.

## Prerequisites

### GreyNoise Access Requirements

You must have:

- A GreyNoise account.
- Access to the GreyNoise API.
- A valid GreyNoise API key.
- Appropriate GreyNoise subscription or API access for the actions you want to use.

### Required Credentials

During setup, you will collect:

- **URL**
- **API Key**

## GreyNoise Setup

Take the following steps to obtain your API key:

1. Go to the **GreyNoise** website and log in with your existing account. If you do not have an account, create one.
2. Click your profile.
3. Select **My API Key**.
4. Click **View API Key** to display your API key.
5. Copy and securely save the API key. You will use this value when configuring the GreyNoise connector in Swimlane.

:::hint{type="info"}
Keep your API key secure and do not expose it in playbooks, documentation, or other locations accessible to unauthorised users.
:::

## 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 **GreyNoise** from the **Asset type** list.
6. Fill in the **Asset Settings** and **Asset Input** as shown:

| **Field**   | **Description**                                          | **Required/Optional** |
| ----------- | -------------------------------------------------------- | --------------------- |
| url         | URL of the target GreyNoise API host.                    | Required              |
| key         | GreyNoise API key used to authenticate API requests.     | Required              |
| verify\_ssl | Enable or disable SSL certificate verification.          | Optional              |
| http\_proxy | Proxy configuration used to route requests, if required. | Optional              |

Fields with \* marks are required.

7. Click **Create**.

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

## Troubleshooting

- If authentication fails, verify that the API key entered in the key field is correct and active.
- If you receive an authorization error, verify that your GreyNoise account and API key have access to the API endpoint you are trying to use.
- If an action is unavailable or returns a permission-related response, verify that your GreyNoise subscription provides access to that endpoint.
- If you receive an SSL certificate error, verify the verify\_ssl configuration.
- If your environment uses a proxy, verify that the http\_proxy value is configured correctly.

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

## Sources

- **GreyNoise API Documentation**
  [https://docs.greynoise.io/](https://docs.greynoise.io/)
- **GreyNoise API Reference - Community IP Lookup**
  [https://docs.greynoise.io/reference/get\_v3-community-ip](https://docs.greynoise.io/reference/get_v3-community-ip)
- **GreyNoise**
  [https://www.greynoise.io/](https://www.greynoise.io/)
- **GreyNoise Authentication Guide**
  [https://explained.tines.com/en/articles/8484293-greynoise-authentication-guide](https://explained.tines.com/en/articles/8484293-greynoise-authentication-guide)