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

# Microsoft Azure Monitor

> OAuth を使用して Azure Monitor を Iru Compliance に接続し、診断設定、アクティビティログ、アラート、Log Analytics ワークスペースの構成を収集します。

### Microsoft Azure Monitor について

**Microsoft Azure Monitor** ソースは、接続したサブスクリプションから **診断設定**、**サブスクリプションのアクティビティログ**、**メトリックアラートルールとログアラートルール** の構成、**Log Analytics ワークスペース** の設定を取得します。データは、サインインしたユーザーとして **委任された OAuth** を使用し、**Azure Resource Manager** を通じて読み取られます。Iru が診断設定、アラートルール、ワークスペースを作成または変更することは **ありません**。

**アクティビティログ** の可視性は、Azure のデフォルトの保持期間（サブスクリプションで **約 90 日**）に従います。Iru は、その期間に Azure が公開する内容を読み取ります。より長く保持するには、Azure でアクティビティログを **Log Analytics** ワークスペースまたは **ストレージ** にエクスポートしてください。

### 仕組み

Iru は **Azure Resource Manager** に対して Microsoft の **OAuth 2.0 認可コードフロー** を使用します。要求されるスコープは次のとおりです:

`https://management.azure.com/user_impersonation`

| 項目 | 値 |
| - | - |
| **カテゴリ** | 開発者ツール |
| **認証** | OAuth 2.0（Microsoft Entra ID、Azure Resource Manager） |
| **ベンダープラン** | 任意の Azure サブスクリプション |

#### Iru が収集する内容

| データの種類 | 備考 |
| - | - |
| 診断設定 | ログカテゴリ、保持期間、送信先（ストレージ、イベントハブ、Log Analytics） |
| アクティビティログ | サブスクリプションレベルの監査イベント（作成、削除、ポリシー、ロールの変更など） |
| メトリックアラートルール | 定義、しきい値、評価頻度 |
| ログアラートルール | スケジュールされたクエリルールとアクティビティログアラートの構成 |
| Log Analytics ワークスペース | ワークスペースの構成とデータ保持の設定 |

公式リファレンス: [Azure Monitor のドキュメント](https://learn.microsoft.com/azure/azure-monitor/)、[診断設定](https://learn.microsoft.com/azure/azure-monitor/essentials/diagnostic-settings)、[アクティビティログ](https://learn.microsoft.com/azure/azure-monitor/essentials/activity-log)、[ロールと権限](https://learn.microsoft.com/azure/azure-monitor/fundamentals/roles-permissions-security)、[診断設定 REST API](https://learn.microsoft.com/rest/api/monitor/diagnostic-settings)。

### 前提条件

* [Azure portal](https://portal.azure.com) への **Microsoft Entra ID** サインイン。
* **サブスクリプション** スコープでの組み込みの **Monitoring Reader** ロール（または必要な読み取りパスを含む **Reader**）。**Monitoring Reader** は、診断設定、アラートルール、アクティビティログへのアクセスのための `Microsoft.Insights/*/read` を付与し、書き込み権限は **含みません**。
* ソースを有効にしたときにコネクタウィザードが開けるよう、ブラウザの **ポップアップ** が許可されていること。

アクセス権を確認する: **Subscriptions** → 対象のサブスクリプション → **Access control (IAM)** → **View my access**。

ロール割り当ての例（プレースホルダーを置き換えてください）:

```bash theme={null}
az role assignment create \
  --assignee <your-user-principal-name> \
  --role "Monitoring Reader" \
  --scope /subscriptions/<subscription-id>
```

### Microsoft Azure Monitor を Iru に接続する

まず **Microsoft Azure** でポータルへのアクセスと **Monitoring Reader**（または **Reader**）の対象範囲を確認してから、**Iru Compliance** で OAuth を完了します。ウィザードには **Step 1 of 1: Perform OAuth Authentication** と表示されます。

<Tabs>
  <Tab title="Microsoft Azure">
    <Note>
      **Iru Compliance** で OAuth を開始する前に、このタブの手順を完了してください。
    </Note>

    <Steps>
      <Step title="Azure portal にサインインする">
        [portal.azure.com](https://portal.azure.com) を開き、Iru ウィザードで使用するアカウントでサインインします。
      </Step>

      <Step title="対象のサブスクリプションを開く">
        **Subscriptions** を検索し、Iru が **Monitor** の診断とメトリックを読み取るサブスクリプションを開きます。
      </Step>

      <Step title="Monitoring Reader または Reader のアクセス権を確認する">
        **Access control (IAM)** → **View my access** を開きます。**前提条件** に従って、**Monitoring Reader** またはサブスクリプションの **Reader** があることを確認します。
      </Step>

      <Step title="ブラウザでポップアップを許可する">
        Microsoft の同意ウィンドウを開けるよう、**Iru** のホスト名に対して **ポップアップ** を許可します。
      </Step>

      <Step title="正しい Microsoft Entra ID テナントを計画する">
        複数のテナントを使用している場合は、OAuth でサブスクリプションを所有するテナントにサインインできるよう、クリーンなブラウザセッションを使用します。
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) タブに進んでください。
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      先に [**Microsoft Azure**](#microsoft-azure) タブの手順を完了してください。
    </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="連携をオンにする">
        **Microsoft Azure Monitor** を探します（**カテゴリ** を **Developer tools** に設定するか、**名前または説明で検索** を使用します）。そのカードで **トグル** をオンにして、コネクタウィザードを開始します。
      </Step>

      <Step title="OAuth を開始してサインインする">
        **Launch OAuth Authentication** を選択します。Microsoft のウィンドウが開いたら、Azure portal で確認したのと同じアカウントでサインインし、同意画面で **Accept** を選択します。
      </Step>

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

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

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

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

  <Accordion title="診断設定が表示されない、または不完全">
    サインインしたアカウントに、**サブスクリプション** スコープでの **Monitoring Reader**（または **Reader**）がない可能性があります。**IAM** を確認してください（**前提条件** を参照）。
  </Accordion>

  <Accordion title="アクティビティログが短いように見える">
    Azure は、サブスクリプションの **アクティビティログ** をデフォルトで約 **90 日間** 保持します。Log Analytics やストレージへのエクスポートによって保持期間を延長していない限り、Iru にはその期間に利用可能な内容が反映されます。
  </Accordion>

  <Accordion title="Microsoft Entra テナントが間違っている">
    Microsoft のポップアップから **サインアウト** し、**正しい** テナントのアカウントでサインインしてください。
  </Accordion>

  <Accordion title="Broken ステータス">
    **ソース** で **Microsoft Azure Monitor** を **オフ** にしてから **オン** にし、OAuth を再度完了してください。
  </Accordion>
</AccordionGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="Sources の管理" 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="Artifacts の管理" icon="folder-open" href="/ja/compliance/artifacts-management">
    ソースやアクションから得たエビデンスをアップロード、確認、整理します。
  </Card>
</CardGroup>
