> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-docs-baton-kubernetes.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up a Honeybadger connector

> C1 provides identity governance for Honeybadger. Integrate your Honeybadger instance with C1 for unified visibility and governance over user access.

C1 provides identity governance for Honeybadger. Integrate your Honeybadger
account with C1 for unified visibility and governance over user access.

## Capabilities

| Resource | Sync                                                          | Provision |
| -------- | ------------------------------------------------------------- | --------- |
| Users    | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |
| Teams    | <Icon icon="square-check" iconType="solid" color="#c937ae" /> |           |

## Gather Honeybadger credentials

<Warning>
  Use a token from a user that can read the account's users and teams. The token
  inherits the access of the user that created it, and one connector reads a
  single account.
</Warning>

<Steps>
  <Step>
    In Honeybadger, open your user settings and find the authentication token
    section.
  </Step>

  <Step>
    Create or copy a personal authentication token.
  </Step>

  <Step>
    Note the numeric ID of the account you want to read. You can find it in
    your Honeybadger account settings or by calling the accounts endpoint with
    your token.
  </Step>
</Steps>

## Configuration fields

| Field        | Required | Description                                                                                                                                   |
| ------------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `base-url`   | Yes      | The base URL of the Honeybadger API, with no trailing slash and no `/v2` suffix. For the hosted service this is `https://app.honeybadger.io`. |
| `account-id` | Yes      | The numeric ID of the Honeybadger account to read users and teams from. One connector reads one account.                                      |
| `auth-token` | Yes      | A personal authentication token from your Honeybadger user settings. It is sent as the HTTP Basic username with an empty password.            |

## Synced resource types

* **Users**: Honeybadger account users from `/v2/accounts/{id}/users`.
* **Teams**: Honeybadger teams from `/v2/teams`, each with a `member`
  entitlement.
* **Team membership**: team-member grants from
  `/v2/teams/{team_id}/team_members`.

## Special notes

* Provisioning is not supported in the current build.
* The connector authenticates with the token as the HTTP Basic username and an
  empty password.
* Use an account-scoped token. One connector reads the single account named by
  `account-id`; teams and team membership are scoped to that account.

## Configure the Honeybadger connector

<Tabs>
  <Tab title="Cloud-hosted">
    Follow these instructions to use a built-in, no-code connector hosted by C1.

    <Steps>
      <Step>
        In C1, navigate to **Integrations** > **Connectors** and click **Add connector**.
      </Step>

      <Step>
        Search for **Honeybadger** and click **Add**.
      </Step>

      <Step>
        Choose how to set up the new Honeybadger connector.
      </Step>

      <Step>
        Set the owner for this connector.
      </Step>

      <Step>
        Click **Next**.
      </Step>

      <Step>
        Find the **Settings** area of the page and click **Edit**.
      </Step>

      <Step>
        Enter the Honeybadger credentials:

        * **Honeybadger API URL**: The API base URL, usually `https://app.honeybadger.io`.
        * **Account ID**: The numeric ID of the account to read.
        * **API token**: The personal authentication token.
      </Step>

      <Step>
        Click **Save**.
      </Step>

      <Step>
        The connector's label changes to **Syncing**, followed by **Connected**. You can view the logs to ensure that information is syncing.
      </Step>
    </Steps>

    **Done.** Your Honeybadger connector is now pulling access data into C1.
  </Tab>

  <Tab title="Self-hosted">
    Follow these instructions to run the Honeybadger connector in your own
    environment.

    <Steps>
      <Step>
        Create secrets for the Honeybadger credentials.
      </Step>

      <Step>
        Configure the connector environment variables:

        * **BATON\_BASE\_URL**: The API base URL, usually `https://app.honeybadger.io`.
        * **BATON\_ACCOUNT\_ID**: The numeric ID of the account to read.
        * **BATON\_AUTH\_TOKEN**: The personal authentication token.
      </Step>

      <Step>
        Deploy the connector using your standard self-hosted connector process.
      </Step>
    </Steps>

    **Done.** Your Honeybadger connector is now pulling access data into C1.
  </Tab>
</Tabs>