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

# Heroku

> Platform API トークンを使用して Heroku を Iru Compliance に接続し、監査用にアプリ、パイプライン、アドオン、チームアクセス、dyno 構成のエビデンスを収集します。

### Heroku について

Iru は **Bearer** トークン（CLI の認可またはアカウントの API キー）を使用し、**Heroku Platform API** 経由で **アプリ** と **dyno** の構成、**パイプライン**、**アドオン**、**チーム** のアクセスメタデータを読み取ります。

### 仕組み

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

| 項目 | 値 |
| - | - |
| **カテゴリ** | 開発者ツール |
| **認証** | Platform API トークン（Bearer） |

Heroku のトークンは細かくスコープされて **いません**。生成したアカウントがアクセスできるすべてのものを継承します。チームメンバーシップを最小限にした **専用** アカウントを推奨します。

公式リファレンス: [認証](https://devcenter.heroku.com/articles/authentication)、[Platform API](https://devcenter.heroku.com/articles/platform-api-reference)、[CLI](https://devcenter.heroku.com/articles/heroku-cli)。

### 前提条件

* **Heroku CLI** **または** ダッシュボードの **API Key** セクションへのアクセス権。
* **SSO** に関する注意: トークンはより短いセッション期間に合わせられる場合があります。**`--expires-in`** については Heroku のドキュメントを参照してください。

### Heroku を Iru に接続する

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

    <Steps>
      <Step title="CLI またはダッシュボードを選択する">
        ほとんどのチームは、トークンが **認可（authorization）** としてスコープされるよう **Heroku CLI** を使用します。CLI を使用できない場合は、以下の手順のダッシュボードの **API Key** の方法を使用してください。
      </Step>

      <Step title="Heroku CLI でサインインする">
        信頼できるワークステーションで **`heroku login`**（CI 形式のフローの場合は **`heroku login -i`**）を実行し、認可を作成できるアカウントで認証を完了します。
      </Step>

      <Step title="認可トークンを作成する">
        **`heroku authorizations:create --description "Iru Compliance"`** を実行します。デフォルトの有効期限は多くの場合 **1 年** ですが、SSO を使用する組織ではより短くなる場合があります。ポリシーでより短い TTL が必要な場合は **`--expires-in`** を追加します。
      </Step>

      <Step title="CLI の出力から Token の値をコピーする">
        コマンド出力から **Token** の文字列をコピーし、Iru に貼り付けるまでボールトに保管します。
      </Step>

      <Step title="ダッシュボードの代替手順: Account settings を開く">
        [Heroku ダッシュボード](https://dashboard.heroku.com) で、**アバター** → **Account settings**（または **アカウント**）を選択します。
      </Step>

      <Step title="ダッシュボードの代替手順: API Key を表示または再生成する">
        **API Key** セクションを開きます。**Reveal** を使用して既存のアカウント全体のキーをコピーするか、**Regenerate** を使用して新しいキーを発行します。**Regenerate** を実行すると以前のキーはすべての場所で無効になるため、Iru だけでなく、古いキーを使用していたすべての連携を更新してください。
      </Step>
    </Steps>

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

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

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

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

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

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

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

  <Accordion title="401 Unauthorized">
    トークン全体を貼り付けてください。SSO セッションでは新しい認可が必要になる場合があります。
  </Accordion>

  <Accordion title="再生成後に接続が古くなった">
    ダッシュボードで再生成すると、古いトークンは無効になります。Iru を更新してください。
  </Accordion>

  <Accordion title="アプリが表示されない">
    トークンのアカウントが適切な **チーム** に所属している必要があります。
  </Accordion>
</AccordionGroup>

### 考慮事項

<CardGroup cols={2}>
  <Card title="Iru は読み取り専用: デプロイ、スケール、再起動は行いません。" icon="circle-info">
    Iru は **読み取り専用** です。デプロイ、スケール、再起動は行いません。
  </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>