> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkr

> Connect Checkr to Iru Compliance using HTTP Basic Auth with your secret API key to collect background check report status and candidate workflow evidence.

### About Checkr

Iru reads **candidate**, **report**, and **package** metadata from Checkr’s REST API using **HTTP Basic**: **username** = **Secret API key**, **password** empty - effectively **`base64(api_key:)`**.

### How It Works

Checkr’s REST API uses **HTTP Basic** over HTTPS: the **Secret API key** is the **username** and the **password** is left **empty**, so the header is **`Authorization: Basic base64(api_key:)`**.

| Detail             | Value                            |
| ------------------ | -------------------------------- |
| **Category**       | Background screening             |
| **Authentication** | Basic (API key + empty password) |

Official references: [Checkr API docs](https://docs.checkr.com/), [API keys](https://help.checkr.com/s/article/14966447719703-Manage-API-keys-and-webhooks).

### Prerequisites

* **Dashboard** access to copy **production** vs **staging** keys as appropriate.

### Connect Checkr to Iru

<Tabs>
  <Tab title="Checkr">
    <Note>
      Complete this tab before you connect the source in Compliance.
    </Note>

    <Steps>
      <Step title="Open the Checkr Dashboard">
        Sign in to the [Checkr Dashboard](https://dashboard.checkr.com) with an account that can view API credentials.
      </Step>

      <Step title="Open Account Settings">
        From the Dashboard, go to **Account Settings** (or the gear **Settings** entry your tenant uses for organization-wide configuration).
      </Step>

      <Step title="Open Developer Settings">
        Select **Developer Settings** (or **API** / **Developers**, depending on Checkr UI labels).
      </Step>

      <Step title="Pick the right environment">
        Confirm whether Iru should use **production** or **staging** data, then locate the **Secret Key** (or **Secret API key**) for that same environment.
      </Step>

      <Step title="Copy the Secret Key">
        Copy the **Secret Key** and store it like a password. In Iru you will paste it as the **Username** for HTTP Basic auth and leave **Password** blank, as on the [**Iru Compliance**](#iru-compliance) tab.
      </Step>
    </Steps>

    <Note>
      Continue on the [**Iru Compliance**](#iru-compliance) tab.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Finish the [**Checkr**](#checkr) tab first.
    </Note>

    <Steps>
      <Step title="Open Sources">
        In Iru Compliance, on the left navigation bar, expand **Compliance** and select **Sources**.

        <Frame>
          <img src="https://mintcdn.com/iru/7HsGH7lnQ8GpVmI0/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=7HsGH7lnQ8GpVmI0&q=85&s=595982441fd777b333b3ecfea24adc24" alt="Left navigation: Compliance expanded, Sources selected" width="424" height="1056" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Turn on Checkr">
        Find **Checkr** (use **Category** or **Search by name or description**). On that card, turn on the **toggle**. A browser tab or window may open for the connector wizard.
      </Step>

      <Step title="Enter Basic authentication">
        Enter the Secret Key in the **Username** field. Leave **Password** **blank**.
      </Step>

      <Step title="Finish the connection">
        Click **Submit Credentials**. When the connection succeeds, the wizard shows **Connection Configured**.
      </Step>

      <Step title="Confirm the source is Active">
        Close the **Iru is requesting access to external services** browser tab, then return to **Compliance** → **Sources** and confirm the **Checkr** card is **Active**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Troubleshooting

<AccordionGroup>
  <Accordion title="Nothing opens when you turn the source on">
    Check **pop-up blocker** settings for the Iru site and try again.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Correct environment key; no stray spaces.
  </Accordion>
</AccordionGroup>

### Related Articles

<CardGroup cols={2}>
  <Card title="Sources Management" icon="plug" href="/en/compliance/sources-management">
    Browse and manage every Compliance source.
  </Card>

  <Card title="Getting Started With Compliance" icon="rocket" href="/en/compliance/getting-started-with-compliance">
    Frameworks, actions, and **Artifacts**.
  </Card>

  <Card title="Iru Overview" icon="layer-group" href="/en/iru/platform-overview/iru-overview">
    How Endpoint, Compliance, and Identity fit together.
  </Card>

  <Card title="Artifacts Management" icon="folder-open" href="/en/compliance/artifacts-management">
    Upload, review, and organize evidence from sources and actions.
  </Card>
</CardGroup>