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

# Arnica

> 範囲を限定した読み取り専用 API キーを使用して Arnica を Iru Compliance に接続し、シークレット検出の結果、リポジトリのインベントリ、開発者リスク、セキュリティポリシーのステータスを収集します。

### Arnica について

Iru は、Arnica の Web プラットフォームの **管理者** → **API** で作成した **Bearer** API キーを使用して、Arnica の REST API から**検出結果**、**リポジトリのインベントリ**、**セキュリティポリシー**、**開発者リスク**のデータを読み取ります。キーは作成時に**スコープが固定**されます。コントロールに必要な**読み取り**スコープのみを付与し、書き込みスコープは一切付与しないでください。

### 仕組み

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

Arnica の API は `https://api.app.arnica.io` からバージョン **v1** で提供されています。キーは Arnica ダッシュボードでスコープごとに作成されるため、スコープが不足しているキーは部分的な結果ではなくエラーを返します。Arnica は、認証および認可のすべての失敗に対して `401` ではなく **`403`** を返します。無効なキー、取り消されたキー、必要なスコープが不足しているキーは、すべて同じように見えます。Iru が保存するのは API キーのみで、設定するホストやサブドメインはありません。

| 項目 | 値 |
| - | - |
| **カテゴリ** | セキュリティ |
| **認証** | Bearer（スコープ付き API キー） |

公式の参考資料: [Arnica ドキュメント](https://docs.arnica.io/)、[API リファレンス (Swagger)](https://api.app.arnica.io/swagger)。

### 前提条件

* **Arnica 管理者**のアクセス権。キーを作成するために **管理者** → **API** を開けるのは管理者のみです。
* 対象とするリポジトリを決めておきます。Arnica ではリポジトリを除外でき、除外されたリポジトリからはエビデンスが生成されません。Iru は、リポジトリに検出結果がないのか、一度もスキャンされていないのかを区別できません。

### Arnica を Iru に接続する

<Tabs>
  <Tab title="Arnica">
    <Note>
      Compliance でソースを接続する前に、このタブを完了してください。
    </Note>

    <Steps>
      <Step title="Arnica にサインインする">
        **admin** ロールを持つアカウントで [https://app.arnica.io](https://app.arnica.io) の Arnica にサインインします。
      </Step>

      <Step title="管理者の API を開く">
        **管理者** → **API** に移動します。
      </Step>

      <Step title="新しい API キーを作成する">
        **Create a New API Key** を選択します。
      </Step>

      <Step title="キーに名前を付ける">
        後でこのキーを識別できるように、**Iru Compliance** などの名前を入力します。
      </Step>

      <Step title="読み取り専用スコープを選択する">
        コンプライアンスプログラムをカバーする**読み取り専用**スコープ（`risks:read`、`products:read`、`inventory:read`、`policies:read`、`status-checks:read`）を選択します。コントロールが開発者グループのメンバーシップを対象とする場合は、`groups:read` を追加します。`risks:write` やその他の書き込みスコープは付与**しないでください**。
      </Step>

      <Step title="作成してトークンをコピーする">
        **作成** を選択し、Arnica に表示されている間にトークンの値を**一度だけ**コピーします。Iru に **Bearer** トークンとして貼り付けるまで、安全に保管してください。
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      先に [**Arnica**](#arnica) タブを完了してください。
    </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="Arnica をオンにする">
        **Arnica** を探します（**カテゴリ** または **名前または説明で検索** を使用します）。そのカードの**トグル**をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
      </Step>

      <Step title="Bearer トークンを貼り付ける">
        トークンを **Bearer** フィールドに貼り付けます。
      </Step>

      <Step title="接続を完了する">
        **Bearerトークンを送信** を選択します。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
      </Step>

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

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

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

  <Accordion title="403 で接続に失敗する">
    Arnica は認証の失敗に対して `401` ではなく `403` を返すため、これには無効なキー、期限切れのキー、取り消されたキーのほか、スコープの不足も含まれます。キーを再生成し、文字列全体を貼り付けたことを確認して、スコープの一覧を再確認してください。
  </Accordion>

  <Accordion title="一部のリポジトリの検出結果が表示されない">
    キーに `risks:read` または `inventory:read` がないか、それらのリポジトリが Arnica で**除外**されています。除外されたリポジトリは Iru からは見えません。
  </Accordion>

  <Accordion title="カードは Active だが Artifacts が表示されない">
    Arnica はオンデマンドではなく、スケジュールに従ってポーリングされます。調査を始める前に、収集サイクルが一巡するまでお待ちください。
  </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>