> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corgea.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> CorgeaでJira統合を設定する

CorgeaのJira統合により、コードベースや依存関係で見つかったセキュリティ問題に対して自動的にJiraチケットを作成できます。この統合により、既存のJiraワークフロー内でのセキュリティ脆弱性の追跡と管理プロセスが効率化されます。

## 前提条件

Jira統合を設定する前に、次の要件を確認してください。

* 管理権限を持つJiraアカウント
* JiraインスタンスのURL(例: `https://mycompany.atlassian.net`)
* Jira APIトークン([Jira API トークンの作成方法](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/))

## 統合の設定

<Steps>
  <Step title="Integrationsページを開く">
    Corgeaアカウントにログインし、**Integrations**ページに移動します。
  </Step>

  <Step title="Jira連携を開く">
    **JIRA**連携を見つけ、**Add**または**Edit**ボタンをクリックしてJIRA連携ページを開きます。
  </Step>

  <Step title="統合の設定">
    <img src="https://mintcdn.com/corgea/uxLuQR4653lM43Tj/images/create-jira-integration.png?fit=max&auto=format&n=uxLuQR4653lM43Tj&q=85&s=9b9ee22cc1005576c9723ff40294e23d" alt="Jira統合の作成" width="1009" height="616" data-path="images/create-jira-integration.png" />

    **Add Integration**をクリックし、次の情報を入力します。

    * **Name**:連携を識別しやすい名前（例:「My JIRA Instance」）
    * **Base URL**:JIRAインスタンスのURL（例:`https://mycompany.atlassian.net`）
    * **Username**:JIRAのユーザー名
    * **API Token**:JIRA APIトークン
    * **Project Key**（任意）:問題作成時に使用するデフォルトのJIRAプロジェクトキー
    * **Issue Type**（任意）:問題作成時に使用するデフォルトのJIRA問題タイプ
  </Step>

  <Step title="設定を保存">
    **Save**をクリックして連携設定を完了します。
  </Step>
</Steps>

## JIRA問題の作成

<Steps>
  <Step title="問題を開く">
    Corgeaでコードの問題または依存関係の問題に移動し、問題の詳細ページを開きます。
  </Step>

  <Step title="JIRAチケット作成画面を開く">
    問題の詳細ページで、チケットアイコンのボタン（ツールチップ:**Create Ticket**）を選択します。

    <img src="https://mintcdn.com/corgea/iadAV76rx_-M1qX0/images/pull_request.png?fit=max&auto=format&n=iadAV76rx_-M1qX0&q=85&s=c8286da5954cff2b319a709b40c635ca" alt="チケット作成ボタン" width="492" height="436" data-path="images/pull_request.png" />
  </Step>

  <Step title="チケットの設定">
    連携設定でプロジェクトキーと問題タイプのデフォルト値を指定していない場合は、ここで指定します。Corgeaがプロジェクトと問題タイプを自動取得し、選択肢として表示します。

    <img src="https://mintcdn.com/corgea/uxLuQR4653lM43Tj/images/create-ticket.png?fit=max&auto=format&n=uxLuQR4653lM43Tj&q=85&s=9225ca9d574a1fbf4abe654aa545669d" alt="チケット作成" width="611" height="499" data-path="images/create-ticket.png" />
  </Step>

  <Step title="チケット作成">
    **Create JIRA Ticket**ボタンをクリックします。Corgeaが関連情報を含む新しいJIRA問題を作成します。
  </Step>

  <Step title="作成確認">
    新しく作成されたJIRAチケットへのリンクを含む確認メッセージが表示されます。
  </Step>
</Steps>

## JIRAチケットの詳細のカスタマイズ

デフォルトでは、CorgeaはJIRAチケットに次の情報を入力します。

* **要約**:
  * コード問題:問題分類とファイル位置
  * 依存関係の問題:CVE、影響を受けたパッケージ、影響を受けたバージョン
  * JIRAの文字数制限を超える要約は自動的に短縮
* **説明**:
  * 脆弱性の詳細(場所/パッケージ、カテゴリ、重大度)
  * 問題の説明
  * 提案された修正案(利用可能な場合)
  * Corgeaの問題詳細ページへのリンク

追加フィールドが必要な場合やチケットの詳細をカスタマイズする場合は、作成後にJIRAインスタンスでチケットを編集できます。

## 複数のJIRA連携の管理

複数のJIRAインスタンスやプロジェクトがある場合は、Corgeaで複数のJIRA連携を設定できます。JIRAチケットの作成時に、使用する連携を選択します。

JIRA連携ページでは、既存の連携を編集したり、不要な連携を削除したりできます。連携を編集する際は、既存のAPIトークンを維持する場合はAPIトークン欄を空欄にし、置き換える場合は新しいトークンを入力します。

CorgeaをJIRAと連携すると、セキュリティ脆弱性の管理を効率化し、既存のワークフロー内で重要な問題を追跡して対応できます。