Jira ユーザーストーリー統合の構成
Jira 統合オプションを構成するには、次の手順を実行します。
始める前に
必要なロール:スキャンエンジンアドミン (sn_se.scan_engine_admin)
- 統合を有効にするには、 スキャンエンジン と統合する Jira プロジェクトの詳細が必要です。Jira ボードのプロジェクト設定から、次の情報を見つけてメモします。
- プロジェクトキー
- 作業アイテムタイプ
- ドメイン名注:ドメイン名は Jira URL から取得できます。たとえば、URL が
companyname.atlassian.net/jiraの場合、ドメイン名はcompanynameです。
- Jira プロジェクトに接続するには、API トークンも必要です。
- https://id.atlassian.com/manage-profile/security/api-tokens URL に移動します。
- [ API トークンの作成] を選択し、トークンの名前を入力して、[ 作成] を選択します。
- トークンが作成されたら、それをコピーして保存します。
ServiceNow 接続プロセスで必要になります。
手順
Jira 統合スクリプトのベストプラクティス
次のベストプラクティスは、Jira 統合スクリプトを作成するためのガイドラインです。
- ServiceNow 統合とは異なり、Jira 統合では検出結果ごとにフィールドマッピングスクリプトが 1 回実行されます。ソースインスタンスと宛先インスタンスは、この統合には適用されません。
- [プロジェクトキー] フィールドと [ドメイン名] フィールドで、ペイロードの送信先の Jira プロジェクトが決まります。
- スクリプトをビルドするときは、grFinding 変数からフィールドを抽出して結果からのデータを使用します。
- Jira プロジェクトに表示する説明とサマリーを作成できます。これらは、作業アイテムタイプのコア要素になります。Jira プロジェクトの他のフィールドを使用することもできますが、使用可能なフィールドを知るには Jira API を理解する必要があります。
- 使用できる一般的なフィールドは次のとおりです。
- サマリー
- 説明
- プロジェクト
- issueType
これらは、次の形式を使用して設定できます。
payload = { 'fields':{ 'summary': text to display in the title, 'description': a description of the work item, 'project': { 'key': the project key}, 'issuetype': { 'name': a work item type: Epic, Story, Bug, Task, Sub-Task} }
Azure DevOps 統合で使用できる事前定義された変数がいくつかあります。
| ペイロード | Jira プロジェクトに入力するフィールドマッピング。 |
| grFinding | 要求を送信する検出結果の Glide レコード。 |
| workItemType | Jira 統合用に選択された作業アイテムタイプ。 |
| キー | Jira 統合用に作成されたプロジェクトキー。 |