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

# Jira

> OAuth を使用して Jira Cloud を Iru Compliance に接続し、監査用にプロジェクト、課題、ワークフロー、変更チケット、Jira Service Management のリクエストのエビデンスを収集します。

### Jira について

**Jira** ソースは、**Jira Cloud** から **プロジェクト構成**、**課題のメタデータ**、**ワークフロー定義**、**ユーザーと担当者の情報**、**Jira Service Management** のリクエストデータを Iru Compliance に取り込み、アクションやコントロールに関連付けられるエビデンスにします。Iru は **Atlassian の 3-legged OAuth 2.0（3LO）** 認可コードフローを通じて接続します。この連携は **読み取り専用** です。Iru が課題、プロジェクト、ワークスペースの設定を作成または変更することはありません。

このコネクタは **Jira Cloud** 専用です。**Jira Data Center**（セルフホスト）は異なる認証モデルを使用するため、このソースでは **サポートされていません**。

### 仕組み

**Cloud ID** を入力すると、コネクタウィザードによって Atlassian に移動し、サインインして同意します。Iru は有効期間の短い **アクセストークン** と **ローテーションするリフレッシュトークン** を受け取り、同期サイクルごとにトークンを自動的に更新します。

| スコープ | 許可される内容 |
| - | - |
| `read:jira-work` | 課題、プロジェクト、ワークフロー、添付ファイルの読み取り |
| `read:jira-user` | ユーザープロフィールと担当者情報の読み取り |
| `read:jira-service-desk` | Jira Service Management のリクエストと SLA メトリクスの読み取り |

| 項目 | 値 |
| - | - |
| **カテゴリ** | プロジェクト管理 |
| **認証** | OAuth 2.0（Jira Cloud 3LO） |
| **ベンダープラン** | **有料** の Jira Cloud プラン（**Free** ティアは、このコネクタに必要な OAuth API アクセスをサポートしていません） |

ドキュメントハブ: [Atlassian サポート - Jira](https://support.atlassian.com/jira/)。OAuth: [Jira Cloud OAuth 2.0 (3LO)](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/)、[OAuth 2.0 スコープ](https://developer.atlassian.com/cloud/jira/platform/scopes-for-oauth-2-3LO-and-forge-apps/)。Cloud ID: [Atlassian Cloud ID の取得](https://support.atlassian.com/jira/kb/retrieve-my-atlassian-sites-cloud-id/)。

### 前提条件

* **有料** の Jira Cloud サイト（**Free** は、ここで必要な OAuth API アクセスをサポートしていません）。
* **Jira Cloud ID**（UUID）。以下の **Jira Cloud ID を確認する** を参照してください。
* OAuth ステップを開けるよう、**Iru** ドメインに対してブラウザの **ポップアップ** が許可されていること。
* サインインするユーザーは Jira 管理者である **必要はありません** が、Iru はそのユーザーがアクセスできるデータのみを読み取れます。幅広いエビデンスを収集するには、少なくとも次の権限を持つアカウントを使用してください:
  * Iru に読み取らせるすべてのプロジェクトに対する **Browse projects**。
  * ユーザーと担当者のメタデータが必要な場合は **Browse users and groups**（グローバル権限）。

適切なプロジェクト全体に読み取りアクセス権を持つ **専用のサービスアカウント** を使用すると、多くの場合、対象範囲を安定させやすくなります。

### Jira を Iru に接続する

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

    #### Jira Cloud ID を確認する

    **Cloud ID** は、Iru が `https://api.atlassian.com/ex/jira/{cloudId}` で使用する UUID です。

    <Steps>
      <Step title="Jira Cloud と有料アクセスを確認する">
        このコネクタは、Iru に必要な OAuth API アクセスを許可する **有料** プランの **Jira Cloud** をサポートしています。連携がブロックされる **Free** サイトでないことを確認してください。
      </Step>

      <Step title="Jira サイトを開く">
        ブラウザで Jira Cloud の URL（例: `https://yoursite.atlassian.net`）を開き、以下の手順で置き換える **サブドメイン** を確認します。
      </Step>

      <Step title="Cloud ID の確認方法を選択する">
        JSON で素早く確認する場合は **オプション A** を、すでに **Atlassian Admin** を使用している場合は **オプション B** を使用します。
      </Step>

      <Step title="オプション A: テナント情報（最速）">
        新しいブラウザタブで次の URL を開きます（`yoursite` を Jira のサブドメインに置き換えます）:

        `https://yoursite.atlassian.net/_edge/tenant_info`

        JSON レスポンスから **`cloudId`** の値をコピーします。
      </Step>

      <Step title="オプション B: Atlassian Admin">
        [admin.atlassian.com](https://admin.atlassian.com) にサインインして組織を選択し、ブラウザの URL で Cloud ID を確認します（`/s/` の後に表示されます）。
      </Step>

      <Step title="Iru 用に Cloud ID を保存する">
        [**Iru Compliance**](#iru-compliance) タブで Iru コネクタウィザードの **cloudId** フィールドに貼り付けるまで、UUID を安全な場所に保管します。
      </Step>
    </Steps>

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

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

      <Step title="ステップ 1/2: サーバー変数を構成する">
        **cloudId** フィールドに **Cloud ID** を入力し、**Configure Server Variables** を選択します。続行する前に、サーバー変数が正常に更新されたことを示す確認が表示されるまで待ちます。
      </Step>

      <Step title="ステップ 2/2: OAuth">
        **Launch OAuth Authentication** を選択します。Atlassian のポップアップが開いたら、サインインして **Accept** を選択し、要求された権限を付与します。
      </Step>

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

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

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

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

  <Accordion title="サーバー変数の更新に失敗した">
    ウィザードのリンクの有効期限が切れている可能性があります。**ソース** で **Jira** をオフにしてから再度オンにし、**Cloud ID** をもう一度入力してください。
  </Accordion>

  <Accordion title="プロジェクトや課題が表示されない">
    OAuth を完了したアカウントに、一部のスペースに対する **Browse projects** がない可能性があります。Jira の権限を調整するか、必要な読み取り範囲を持つ **サービスアカウント** で接続してください。
  </Accordion>

  <Accordion title="トークンの有効期限切れ、または再接続を求められる">
    Jira Cloud は、有効期間が **90 日** の **ローテーションするリフレッシュトークン** を使用します。接続がそれ以上アイドル状態になった場合は、**Jira** ソースカードから OAuth フローを再度完了してください。
  </Accordion>

  <Accordion title="Jira Free プラン">
    **Free** ティアは、このコネクタに必要な OAuth API アクセスをサポートしていません。接続するには **有料** の Jira Cloud プランを使用してください。
  </Accordion>

  <Accordion title="サイトまたは Cloud ID が間違っている">
    **Cloud ID** が対象のサイトと一致していることを確認してください（**Jira Cloud ID を確認する** を参照）。一致しない場合、Iru は誤ったテナントを参照します。
  </Accordion>
</AccordionGroup>

### 考慮事項

<CardGroup cols={2}>
  <Card title="リフレッシュトークンとアイドル状態の接続" icon="circle-info">
    Iru は同期サイクルごとにアクセストークンを更新します。同期が **90 日間** 実行されない場合は、ソースカードから **再認証** する必要があります。
  </Card>

  <Card title="大規模なプロジェクトと保持" icon="shield">
    大規模なプロジェクトでは大量の履歴が生成されます。可能な範囲でプロジェクトの対象範囲を絞り、監査でワークフローのエビデンスに依存する前に、**保持** と **プライバシー** のポリシーを整合させてください。
  </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>