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

> OAuth 2.0 と、アカウントに一致するプラットフォームホストを使用して RingCentral を Iru Compliance に接続し、ユーザー、ロール、プラットフォーム構成のエビデンスを収集します。

### RingCentral について

Iru は **RingCentral Platform** API に対して **OAuth 2.0** (**認可コード**) を使用します。一般的な読み取りスコープには **ReadAccounts**、**ReadCallRecording** (メタデータ)、**ReadAuditTrail** があります。正確な名前は同意画面の表示に従います。承認する前に **`https://platform.ringcentral.com`** (またはインテグレーションで必要な場合は **media** ホスト) を選択してください。

### 仕組み

Iru は RingCentral の **OAuth 2.0 認可コード**フローを使用します。ウィザードで**サーバー** / リージョンを**確認**すると、RingCentral の認可サーバーを表示する**ブラウザのポップアップ**が開きます。サインインして要求されたスコープを確認し、アクセスを許可すると、RingCentral からコードが返され、Iru はそれを**アクセス** (および**リフレッシュ**) トークンと交換します。

| 詳細 | 値 |
| - | - |
| **カテゴリ** | コミュニケーション |
| **認証** | OAuth 2.0 |

公式リファレンス: [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)。

### 前提条件

* RingCentral アカウントの **管理者** または **Super Admin** 権限。
* ブラウザの**ポップアップ**が許可されていること。

### RingCentral を Iru に接続する

<Tabs>
  <Tab title="RingCentral">
    <Note>
      適切な管理者が OAuth を完了できるように、**Iru Compliance** で **RingCentral** を有効にする前に、このタブの手順を完了してください。
    </Note>

    <Steps>
      <Step title="RingCentral の管理画面にサインインする">
        [RingCentral service web](https://service.ringcentral.com) (またはブランド化されたログイン URL) を開き、**管理者** または **Super Admin** 権限でサインインします。
      </Step>

      <Step title="API と監査の利用資格を確認する">
        RingCentral のプランに、Iru の同意画面で要求される **ReadAccounts**、**ReadCallRecording** (メタデータ)、**ReadAuditTrail** の機能が含まれていることを確認します。一部のスコープはプランのティアによって異なります。
      </Step>

      <Step title="正しいプラットフォームホストを選択する">
        テナントが **`platform.ringcentral.com`** (一般的な本番環境) と **media** ホストのどちらを使用しているかを判断し、アカウントのリージョンについて RingCentral が文書化している内容に合わせます。
      </Step>

      <Step title="Iru のポップアップを許可する">
        Compliance で使用するブラウザプロファイルで、RingCentral の OAuth ウィンドウがブロックされないように、**Iru** のホスト名に対して**ポップアップ**を許可します。
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) タブに進みます。
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      先に [**RingCentral**](#ringcentral) タブの手順を完了してください。
    </Note>

    <Steps>
      <Step title="ソースを開く">
        Iru Compliance の左側のナビゲーションバーで **コンプライアンス** を展開し、**ソース** を選択します。

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="左側のナビゲーション: Compliance を展開し、Sources を選択した状態" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="RingCentral をオンにする">
        **RingCentral** を見つけます (**カテゴリ** または **名前または説明で検索** を使用します)。そのカードで**トグル**をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
      </Step>

      <Step title="プラットフォームホストを確認して OAuth を開始する">
        ウィザードで**サーバー** / リージョンを確認してから **OAuth** を開始し、同意ウィンドウが開くようにします。
      </Step>

      <Step title="サインインして承認する">
        プロンプトが表示されたら RingCentral にサインインします。アクセス内容を確認し、**Authorize** (または同等の承認ボタン) を選択します。
      </Step>

      <Step title="接続を完了する">
        RingCentral のポップアップが閉じ、Iru がトークン交換を完了すると、ウィザードに **接続が構成されました** と表示されます。
      </Step>

      <Step title="ソースが有効であることを確認する">
        **Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**RingCentral** カードが **有効** であることを確認します。
      </Step>
    </Steps>
  </Tab>
</Tabs>

### トラブルシューティング

<AccordionGroup>
  <Accordion title="ソースをオンにしても何も開かない">
    Iru サイトの**ポップアップブロッカー**設定を確認して、もう一度お試しください。
  </Accordion>

  <Accordion title="アクセスが拒否される">
    **管理者** アカウントを使用してください。
  </Accordion>

  <Accordion title="監査データがない">
    プランに**監査** API へのアクセスが含まれていない可能性があります。
  </Accordion>

  <Accordion title="セッションの期限切れ">
    Iru から OAuth を再実行してください。
  </Accordion>
</AccordionGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="ソース管理" icon="plug" href="/ja/compliance/sources-management">
    すべての Compliance ソースを参照および管理します。
  </Card>

  <Card title="Compliance の使用を開始する" icon="rocket" href="/ja/compliance/getting-started-with-compliance">
    フレームワーク、アクション、**アーティファクト**。
  </Card>

  <Card title="Iru の概要" icon="layer-group" href="/ja/iru/platform-overview/iru-overview">
    Endpoint、Compliance、Identity がどのように連携するか。
  </Card>

  <Card title="アーティファクト管理" icon="folder-open" href="/ja/compliance/artifacts-management">
    ソースとアクションから得たエビデンスをアップロード、確認、整理します。
  </Card>
</CardGroup>