> ## 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.

# Sentry

> Connect Sentry to Iru Compliance with an auth token and the correct regional API host to collect projects, issues, releases, and organization audit logs.

### About Sentry

Iru reads **projects**, **issues/events**, **teams**, **releases**, and **audit** data from your **Sentry organization**. Choose the **API host** that matches your deployment (**sentry.io**, **US**, **EU**, or self-hosted). Authentication is a **Bearer** token - either a **personal** auth token or an **organization** token.

### How It Works

```http theme={null}
Authorization: Bearer YOUR_AUTH_TOKEN
```

| Detail             | Value                                                                                       |
| ------------------ | ------------------------------------------------------------------------------------------- |
| **Category**       | Error monitoring                                                                            |
| **Authentication** | Bearer token (personal or org auth token)                                                   |
| **Audit logs**     | Typically **Business** or **Team**; requires **Owner** or **Manager** for full audit access |

**Org-level tokens** (Organization Settings → Auth Tokens) survive user churn; **personal** tokens stop working if the user leaves the org.

Official references: [Auth tokens](https://docs.sentry.io/account/auth-tokens/), [Create a token](https://docs.sentry.io/api/guides/create-auth-token/), [API](https://docs.sentry.io/api/).

### Prerequisites

* Access to the Sentry **organization** you need for compliance.
* **Owner** or **Manager** when audit-log evidence is required.

### Connect Sentry to Iru

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

    <Steps>
      <Step title="Sign in to Sentry">
        Sign in to **sentry.io** (or your self-hosted Sentry URL) with a user who can create **auth tokens** for the target **organization**.
      </Step>

      <Step title="Choose personal vs organization token">
        Decide whether Iru should use a **personal** token (tied to your user) or an **organization** token (survives user churn). Organization tokens require **Owner** or **Manager** in many setups.
      </Step>

      <Step title="Open Personal Tokens (personal path)">
        If you chose a personal token: **Settings** → **Personal Tokens** (for example `https://sentry.io/settings/account/api/auth-tokens/`).
      </Step>

      <Step title="Open Organization Auth Tokens (org path)">
        If you chose an organization token: open your **Organization Settings** → **Auth Tokens** (labels may read **Developer settings** → **Auth tokens**).
      </Step>

      <Step title="Create the token and set read scopes">
        Create a token, name it (for example **Iru Compliance**), and enable read scopes your controls need, commonly **org:read**, **project:read**, **team:read**, and **event:read** (add audit-related scopes if your plan and role allow).
      </Step>

      <Step title="Copy the token once">
        Copy the token value when Sentry shows it. It is shown **once**.
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      Finish the [**Sentry**](#sentry) 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 Sentry">
        Find **Sentry** (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="Select the Sentry API host">
        Select the **server** that matches your account:

        * **`https://sentry.io`**: Default SaaS.
        * **`https://YOUR_REGION.sentry.io`**: Data residency (for example **`us`** or **`de`**).

        Confirm the server before entering credentials.
      </Step>

      <Step title="Paste the Bearer token">
        Paste the **Bearer token** when prompted.
      </Step>

      <Step title="Finish the connection">
        Click **Submit Bearer Token**. 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 **Sentry** 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">
    Token copied fully; not revoked.
  </Accordion>

  <Accordion title="No audit data">
    Confirm plan supports audit logs and your role is **Owner**/**Manager**.
  </Accordion>

  <Accordion title="Wrong region">
    EU orgs must use the EU host - US endpoint calls fail.
  </Accordion>

  <Accordion title="Personal token died">
    User left org - switch to an **org** token or recreate under an active user.
  </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>