AikidoデータをJiraカスタムフィールドにマッピングする

カスタムフィールドマッピングを使う理由:

必須フィールド — Jiraのissueタイプに必須のカスタムフィールドが設定されている場合、そのフィールドに値をマッピングしないとAikidoはチケットを作成できません
より充実したチケットデータ — 重大度、SLA日付、チームなどのAikidoデータを、Jiraのフィールドに直接送信できます
Jiraの自動化 — マッピングしたフィールドの値を使って、ワークフローのトリガー、チケットのルーティング、優先度の自動設定などを行えます

シンプルな設定

Jiraのフィールド名をJira上の表示どおりにそのまま入力するだけです
フィールドID、APIによる検索、特殊なフォーマットは一切不要です
固定値にはプレーンテキストを使用してください。読みやすい名前をそのまま入力するだけです

サポートされているJiraのフィールドタイプ:

自由記述: short text paragraph
リンク: URL Field
選択フィールド: select list (single choice)
複数選択フィールド: select list (multiple choice)
数値: Number field
日付: Date Picker
日時: Datetime Picker

フィールドマッピングの設定

Integrations > Jira > Jira Field Mappingに移動し、Add Fieldをクリックします
Custom Fieldの入力欄に、Jiraのカスタムフィールド名をJira上の表示どおりに入力します
Aikido Valueの入力欄に、Aikidoのショートコード（例: $SEVERITY）または固定のテキスト値を入力します
Save Changesをクリックします

Preview列には、Jiraに送信される値が表示されます。これはショートコードに基づく値、または固定値・自由記述のテキストのいずれかになります。

Aikido Value: 固定テキスト vs ショートコード

オプション1: 自由記述でJiraに固定値を送信する

ショートコードの代わりにプレーンテキストを入力すると、固定値を設定できます。読みやすい名前をそのまま使用するだけで、JiraのIDや特殊なフォーマットは不要です。

例えば、Securityと入力すると、Aikidoから作成されるすべてのチケットで、そのJiraフィールドに「Security」という値が設定されます。

オプション2: ショートコードでAikidoの値をJiraに送信する

ショートコードは、Aikidoのissueからデータを取得するためのプレースホルダーです。Jiraチケットが作成されると、ショートコードは実際の値に置き換えられます。ショートコードと固定テキストを組み合わせることもできます。例えばIssue: $TLDRやDetected on $FIRST_DETECTED_DATEのように使用できます。一覧にないショートコードが必要な場合は、お問い合わせください。

Shortcode	説明
`$SEVERITY_SCORE`	脆弱性の数値の重大度スコア（例: 85）
`$SEVERITY`	重大度レベル（Critical、High、Medium、Low）
`$ASSIGNEE`	Aikidoでそのissueの対応を割り当てられたユーザー
`$TLDR`	issueグループの要約
`$HOW_TO_FIX`	issueグループの修正方法の説明
`$FIX_TIME`	issueグループの修正にかかる時間（分単位）
`$TASK_DESCRIPTION`	スコープ、TLDR、修正方法を含む、Aikidoがこのタスクに対して生成するデフォルトの説明
`$TEAMS`	関連するissueを担当するチーム
`$SCOPES_REPO`	このタスクに関連するリポジトリ名のみに絞り込んだスコープ。グループ化されたissueによっては空になる場合があります。
`$SCOPES_SHORT`	リポジトリ名、コンテナ名、クラウド名など、このタスクに関連するスコープの短縮版。
`$SCOPES`	タスクに関連するスコープ/場所（リポジトリ、コンテナなど）
`$SLA_DATE`	SLA期限日
`$SLA_TIME`	SLA期限日のUnixタイムスタンプ表記
`$FIRST_DETECTED_DATE`	issueが最初に検出された日付
`$FIRST_DETECTED_TIME`	最初に検出された日付のUnixタイムスタンプ表記
`$AIKIDO_LINK`	Aikido内のissueグループへのリンク
`$CWE_IDS`	このタスクに関連するissueのCWE ID
`$CVSS`	このタスクに関連するissueの中で最も高いCVSSスコア
`$ISSUE_TYPE`	このタスクに関連するissueの種類
`$PROGRAMMING_LANGUAGE`	このタスクに関連するissueのプログラミング言語

日付・日時フィールド

Jiraのdate（日付）フィールドには、YYYY-MM-DD形式（例: 2024-03-15）または_DATEのショートコードを使用してください。

Jiraのdatetime（日時）フィールドには、_TIMEのショートコード（例: $SLA_TIME、$FIRST_DETECTED_TIME）を使用してください。これらはUnixタイムスタンプを出力し、Aikidoが自動的にJiraが要求する日時形式に変換します。

応用例

すべてのAikido issueを1つの固定の親issueにリンクする

Aikidoから作成されるすべてのJiraチケットに同じ親issueを設定したい場合は、JiraのParentフィールドを固定値にマッピングします。Aikido Valueの入力欄に、親issueのJira issueキー（SEC-123など）を入力します。