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

# Doppler

> サービス API トークンまたはパーソナル API トークンを使用して Doppler を Iru Compliance に接続し、プロジェクト、環境、シークレットメタデータのエビデンスを収集します。

### Doppler について

Iru は **Bearer** トークン（**Service Token** または **Personal Token**）を使用して Doppler API を呼び出します。エビデンスには、**プロジェクト**、**環境**、**シークレットメタデータ**（名前、バージョン、変更履歴）、および **チーム** 構造が含まれます。Iru は **平文のシークレット値** を取得または保存することは **ありません**。コンプライアンスの可視化に必要なメタデータのみを扱います。

### 仕組み

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

| 項目 | 値 |
| - | - |
| **カテゴリ** | 開発者ツール |
| **認証** | Bearer トークン（Service または Personal） |

* **Service Token**: **特定のプロジェクトと構成** にスコープされます。範囲を絞った監査に使用します。
* **Personal Token**: プロジェクト全体でユーザーのアクセス権に従います。組織全体の可視化に使用します。

公式リファレンス: [認証](https://docs.doppler.com/reference/auth)、[API リファレンス](https://docs.doppler.com/reference/api)、[API トークン](https://docs.doppler.com/docs/api-tokens)。

### 前提条件

* プログラムの対象となるプロジェクトと環境への Doppler アクセス権。

### Doppler を Iru に接続する

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

    <Steps>
      <Step title="Doppler にサインインする">
        [Doppler ダッシュボード](https://dashboard.doppler.com) を開き、Iru が読み取るワークプレイスまたはプロジェクトの **API** トークンを作成できるユーザーでサインインします。
      </Step>

      <Step title="API トークン画面を開く">
        ワークプレイスの **API** に移動します（URL パターンは `https://dashboard.doppler.com/workplace/api` のような形式です）。
      </Step>

      <Step title="トークンを生成する">
        **Generate Token**（または **トークンを作成**）を選択して作成フォームを開きます。
      </Step>

      <Step title="トークンに名前を付ける">
        監査時に正しい認証情報を取り消せるよう、**Iru Compliance** などのラベルを入力します。
      </Step>

      <Step title="Service Token と Personal Token のどちらかを選択する">
        プロジェクト/構成にスコープされた範囲の狭いシークレットが必要な場合は **Service Token** を、連携が **あなたの** ユーザーアクセス権を継承する必要がある場合は **Personal Token** を選択します。最小権限ポリシーに沿って選択してください。
      </Step>

      <Step title="値を生成、コピー、保存する">
        トークンを生成し、一度だけ **コピー** します。Doppler はトークンを作成時にのみ表示します。トークンは取り消されない限り失効しません。**Iru Compliance** に貼り付けるまで、シークレットマネージャーに保管してください。
      </Step>
    </Steps>

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

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

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

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

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

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

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

  <Accordion title="401 Unauthorized">
    余分なスペースがないことを確認し、トークンが Doppler で取り消されていないことを確認してください。
  </Accordion>

  <Accordion title="プロジェクトが表示されない">
    **Service Token** は単一プロジェクト用です。**Personal Token** を使用するか、プロジェクトごとに追加のスコープ付きトークンを使用してください。
  </Accordion>

  <Accordion title="漏えい">
    Doppler でトークンを取り消し、新しいトークンを発行して Iru を更新してください。
  </Accordion>
</AccordionGroup>

### 考慮事項

<CardGroup cols={2}>
  <Card title="Personal Token のユーザーがワークスペースへのアクセス権を失った場合…" icon="circle-info">
    **Personal Token** のユーザーがワークスペースへのアクセス権を失うと、トークンは機能しなくなります。有効なアカウントで再接続してください。
  </Card>
</CardGroup>

### 関連記事

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