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

# Set up an ilert connector

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

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

## Capabilities

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

The connector syncs every user in the ilert organization along with their
organization role, every team, and each team's membership. Membership grants
record the per-team role (Admin, User, Responder, or Stakeholder) that each
member holds on the team.

## Gather ilert credentials

<Warning>
  To configure the ilert connector, you need an ilert API token that can read
  users and teams. An organization-wide API key is recommended so the token can
  see every user and team in the account.
</Warning>

<Steps>
  <Step>
    Sign in to ilert as an administrator.
  </Step>

  <Step>
    Open **User Settings -> API Keys** to create a personal API key, or create
    an organization-wide API key under your account's API settings.
  </Step>

  <Step>
    Copy the API token. The connector sends it to ilert in the `Authorization`
    header using the `Bearer` scheme.
  </Step>
</Steps>

## Configure the ilert 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 **Apps** > **Connectors** and click **Add connector**.
      </Step>

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

      <Step>
        Choose where to add the connector: **Create a new app**, or **Add to an existing app** (then select the app).

        If you're creating a new app, choose whether to link it to an application discovered from your identity provider: select **Yes** and pick the IdP application, or **No** to continue with just the connector.
      </Step>

      <Step>
        Set the connector's **Name** and, optionally, a **Description**.
      </Step>

      <Step>
        Click the pencil icon next to **Owners** to choose who can configure and manage this connector.
      </Step>

      <Step>
        Click **Add**. The connector is created and its configuration page opens.
      </Step>

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

      <Step>
        Enter the ilert credentials:

        * **API token**: The ilert API token you copied.
        * **Base URL override** (optional): Only needed for self-hosted or EU-region instances. Leave blank to use `https://api.ilert.com/api`.
      </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 ilert connector is now pulling access data into C1.
  </Tab>

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

    <Steps>
      <Step>
        Create a secret for the ilert API token.
      </Step>

      <Step>
        Configure the connector with:

        * **API token** (`ilert-api-token`): Your ilert API token.
        * **Base URL override** (`ilert-base-url`, optional): Your ilert API base URL for self-hosted or EU-region instances. Defaults to `https://api.ilert.com/api`.
      </Step>

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

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