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

# RingCentral

> Connect RingCentral to Iru Compliance with OAuth 2.0 and the platform host that matches your account to collect user, role, and platform configuration evidence.

### About RingCentral

Iru uses **OAuth 2.0** (**authorization code**) against **RingCentral Platform** APIs. Typical read scopes include **ReadAccounts**, **ReadCallRecording** (metadata), and **ReadAuditTrail** - exact names follow the consent screen. Pick **`https://platform.ringcentral.com`** (or the **media** host if your integration requires it) before authorizing.

### How It Works

Iru uses RingCentral’s **OAuth 2.0 authorization code** flow. After you **confirm the server** / region in the wizard, a **browser popup** opens RingCentral’s authorization server. You sign in, review the requested scopes, and grant access; RingCentral returns a code that Iru exchanges for **access** (and **refresh**) tokens.

| Detail             | Value                  |
| ------------------ | ---------------------- |
| **Category**       | Unified communications |
| **Authentication** | OAuth 2.0              |

Official references: [Auth code flow](https://developers.ringcentral.com/guide/authentication/auth-code-flow), [Permissions](https://developers.ringcentral.com/guide/basics/permissions), [API reference](https://developers.ringcentral.com/api-reference).

### Prerequisites

* **Admin** or **Super Admin** for the RingCentral account.
* Browser **popups** allowed.

### Connect RingCentral to Iru

<Tabs>
  <Tab title="RingCentral">
    <Note>
      Complete this tab before you enable **RingCentral** in **Iru Compliance**, so the right administrator completes OAuth.
    </Note>

    <Steps>
      <Step title="Sign in to RingCentral admin">
        Open the [RingCentral service web](https://service.ringcentral.com) (or your branded login URL) and sign in with **Admin** or **Super Admin** rights.
      </Step>

      <Step title="Confirm API and audit entitlements">
        Confirm your RingCentral plan includes the **ReadAccounts**, **ReadCallRecording** (metadata), and **ReadAuditTrail** capabilities Iru’s consent screen requests. Some scopes are tier-dependent.
      </Step>

      <Step title="Pick the correct platform host">
        Decide whether your tenant uses **`platform.ringcentral.com`** (typical production) or a **media** host, and match what RingCentral documents for your account region.
      </Step>

      <Step title="Allow pop-ups for Iru">
        In the browser profile you will use for Compliance, allow **pop-ups** for your **Iru** hostname so the RingCentral OAuth window is not blocked.
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      Finish the [**RingCentral**](#ringcentral) 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 RingCentral">
        Find **RingCentral** (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="Confirm platform host and start OAuth">
        Confirm **server** / region in the wizard, then start **OAuth** so the consent window can open.
      </Step>

      <Step title="Sign in and authorize">
        Sign in to RingCentral if prompted. Review access and select **Authorize** (or the equivalent approval button).
      </Step>

      <Step title="Finish the connection">
        When the RingCentral popup closes and Iru finishes the token exchange, 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 **RingCentral** 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="Access denied">
    Use an **Admin** account.
  </Accordion>

  <Accordion title="Missing audit">
    Plan may not include **audit** API access.
  </Accordion>

  <Accordion title="Expired session">
    Re-run OAuth from Iru.
  </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>