Freshservice (Pro)
Freshservice 連携を使用すると、DefectDojo の検出事項および検出事項グループを Freshservice のチケットとしてプッシュし、任意の agent Group に割り当てることができます。
インスタンスのセットアップ
- Label には、この連携を識別するために使用したいラベルを設定します。
- Location には、Freshservice の URL を設定します:
https://yourcompany.freshservice.com。 - API Key には、Freshservice の API キーを設定します。プロフィール画像(右上)をクリックして Profile settings を開き、キャプチャを完了すると、Delegate Approvals セクションの下、右側にキーが表示されます。キーが表示されない場合は、アカウントレベルで API アクセスが無効になっている可能性があるため、管理者に先に有効化してもらう必要があります。
- Requester Email には、チケットの依頼元となるメールアドレスを設定します。Freshservice はすべてのチケットに依頼者を必須としているため、DefectDojo はこのアドレスを依頼者としてチケットを作成します。
課題管理マッピング
- Group ID には、チケットの割り当て先となる Freshservice の agent group の数値 ID を設定します。Admin > Agent Groups でグループを表示しているときの URL から確認できます。
- Workspace ID(任意)は、複数ワークスペースのアカウントで、チケットを特定のワークスペースに振り分けます。プライマリワークスペースを使用する場合は空欄のままにします。
深刻度マッピングの詳細
これは Freshservice チケットの Priority フィールドにマッピングされます。このフィールドは数値コード(1 Low、2 Medium、3 High、4 Urgent)を使用しますが、優先度名で指定することもできます。
- 深刻度フィールド名:
Priority - 情報マッピング:
1 - 低マッピング:
1 - 中マッピング:
2 - 高マッピング:
3 - 重大マッピング:
4
ステータスマッピングの詳細
これはチケットの Status フィールドにマッピングされます。このフィールドは数値コード(2 Open、3 Pending、4 Resolved、5 Closed)を使用しますが、ステータス名で指定することもできます。
- ステータスフィールド名:
Status - アクティブマッピング:
2 - クローズマッピング:
5 - 誤検知マッピング:
5 - リスク受容済みマッピング:
3
Freshservice 固有の動作として、いくつか注意すべき点があります。
- 更新はチケットの内容全体を同期します。Freshservice では、作成後に件名と説明を編集できます。
- 検出事項が削除されると、チケットは削除されるのではなくクローズされます。既に Resolved または Closed になっているチケットはそのままにされます。クローズ時には解決メモが自動的に添付されるため、これを必須とするアカウント(よくあるビジネスルール)でもクローズが受け付けられます。
- 一部のアカウントでは、チケットの優先度を Impact/Urgency マトリクスやビジネスルールから算出し、作成時に送信された優先度を無視します。DefectDojo はこれを検知し、後続の更新でマッピングされた優先度を再適用するため、マッピングは引き続き反映されます。