Atlassian Jira¶
JiraはAtlassianが開発した広く利用されているプロジェクト管理および課題追跡ソフトウェアです。脆弱性が検出された際に、すべてのリスクレベル、または選択したリスクレベル(高・中・低)のみを対象に、WallarmがJiraに課題を作成するように設定できます。
インテグレーションの設定¶
Jira UIで:
-
こちらに記載の手順に従ってAPI tokenを生成します。
-
生成したAPI tokenをコピーします。
Wallarm UIで:
-
Wallarm Console → Integrations → Jiraを開きます。
-
integration nameを入力します。
-
Jira hostを入力します(例:
https://company-x.atlassian.net/
)。 -
Jiraの認証に必要で、作成される課題のReporterの識別にも使用されるJira user emailを入力します。
-
生成したAPI tokenを貼り付けます。emailとtokenは、指定したJira hostでWallarmを認証するために検証されます。成功すると、このJiraユーザーで利用可能なspaceが一覧表示されます。
-
課題を作成するJiraのspaceを選択します。選択すると、そのspaceでサポートされているissue typesの一覧が表示されます。
-
作成される課題が属するJiraのissue typeを選択します。
-
通知をトリガーするevent typesを選択します。すべての脆弱性、または特定のリスクレベルのみを選択できます。
-
構成が正しいか、Wallarm Cloudの到達性、通知のフォーマットを確認するためにTest integrationをクリックします。
Jira課題作成のテスト:
-
Add integrationをクリックします。
Wallarm Cloud IP addresses
To provide Wallarm Cloud access to your system, you may need a list of its public IP addresses:
インテグレーションの無効化と削除¶
You can delete or temporarily disable the integration. While deleting stops sending notificatioins and completely deletes all configuration, disabling just stops sending notifications which you can at any moment re-enable with the same settings.
If for the integration the System related events are selected to trigger notifications, Wallarm will notify about both of these actions.
システムの利用不可と不正なインテグレーションパラメータ¶
Notifications to the system are sent via requests. If the system is unavailable or integration parameters are configured incorrectly, the error code is returned in the response to the request.
If the system responds to Wallarm request with any code other than 2xx
, Wallarm resends the request with the interval until the 2xx
code is received:
-
The first cycle intervals: 1, 3, 5, 10, 10 seconds
-
The second cycle intervals: 0, 1, 3, 5, 30 seconds
-
The third cycle intervals: 1, 1, 3, 5, 10, 30 minutes
If the percentage of unsuccessful requests reaches 60% in 12 hours, the integration is automatically disabled. If you receive system notifications, you will get a message about automatically disabled integration.