Azure Boards

Azure Boards 組織を Tenable One Cloud Exposure と統合して、 Tenable の特定の検出結果に関連する作業項目の作成をサポートします。

次の手順

  • 検出結果のワークアイテムの作成を開始するには、 自動化 を設定するか、ツールと統合した後 検出結果に基づくアクションのトリガー する必要もあります。すべての統合ステップを正常に完了しても、それ自体ではデータ送信はトリガーされません。

始める前に

Tenable は、Microsoft Entra ID アプリケーション、 クラウドサイバーエクスポージャー Azure Boards コネクタを介して Azure Boards に対して認証を行います。すでに Tenable に接続した Microsoft Entra ID 統合を再利用することも、セットアップ中に新しい統合接続することもできます。

ウィザードを開始する前に、次のことを確認してください。

  • 既存の Microsoft Entra ID 統合 (推奨)、または統合を追加できること。 Tenable は、既存の統合がある場合は再利用することを推奨しています。
  • Microsoft Entra ID のグローバル管理者またはアプリケーション管理者のロール。 コネクタアプリケーションのサービスプリンシパルを作成するデプロイメントスクリプトを実行するには、これらのロールのいずれかが必要です。
  • Azure DevOps 組織にユーザーを追加するアクセス許可。 これは、後ほどウィザードでコネクタのサービスプリンシパルに組織へのアクセス権を付与するために必要になります。

組織の追加

前提条件を完了したら、 クラウドサイバーエクスポージャー コンソールから Azure Boards 組織を追加します。

新しい組織を追加する方法

  1. クラウドサイバーエクスポージャー コンソールで、[設定] > [統合] に移動します。
  2. (オプション)[Organization] (組織) ドロップダウンで、アカウント範囲を選択します。
  3. [統合の追加] をクリックします。
  4. 統合ライブラリで、[Azure Boards] をクリックします。[Azure Boards の追加] ウィザードが開きます。
  5. Microsoft Entra ID の設定 (ウィザードのステップ 1):
    1. [Microsoft Entra ID] で、[既存の Microsoft Entra ID 統合を使用する] を選択し、ドロップダウンから統合を選択するか、 + 追加 をクリックして新しい統合を接続します。または、[Microsoft Entra ID 統合を使用しない (非推奨)] を選択します。
    2. [アクセスの検証] で、[確認] をクリックして Microsoft Entra ID にサインインし、アクセスを確認します。
    3. [デプロイ] で、提供された PowerShell スクリプトをコピーします。

    4. [使用している Azure 環境]Azure 環境で PowerShell スクリプトを実行します。このスクリプトは、 クラウドサイバーエクスポージャー Azure Boards コネクタ アプリケーションのサービスプリンシパルを作成します (まだ存在しない場合)。

      必要な クラウドサイバーエクスポージャー ユーザーロール: スクリプトを実行するには、Microsoft Entra ID で グローバル管理者 または アプリケーション管理者 のロールが必要です。

    5. [次へ] をクリックします。
  6. Azure DevOps ポータルで組織のアクセス許可を付与 します (ウィザードのステップ 2)。
  7. [次へ] をクリックします。
  8. ドロップダウン (ウィザードのステップ 3) から Azure DevOps 組織を選択し、[完了] をクリックします。統合プロファイルが開き、[プロジェクト] タブがアクティブになります。

組織が正常に追加されると、Settings > 統合> Azure Boards のテーブルに表示されます。

重要: 検出結果のワークアイテムの作成を開始するには、 自動化 を設定するか、ツールと統合した後 検出結果に基づくアクションのトリガー する必要もあります。すべての統合ステップを正常に完了しても、それ自体ではデータ送信はトリガーされません。

組織アクセス許可を付与

組織にアクセス許可を付与するには:

  1. Azure DevOps にログインし、追加する組織を選択して、左下の [組織の設定] をクリックします。
  2. [一般 > ユーザー] に移動し、[ユーザーの追加] をクリックします。
  3. 次のユーザーの詳細を入力します。
    1. ユーザーまたはサービスプリンシパル: クラウドサイバーエクスポージャー Azure Boards コネクタを選択し、オブジェクト ID が含まれているサービスプリンシパルを必ずクリックします。
    2. アクセスレベル: [基本] を選択します。
    3. プロジェクトに追加: Tenableで使用するプロジェクトを選択します。
    4. Azure DevOps グループ: [プロジェクト共同作成者] を選択します。
    5. [Add] (追加) をクリックします。

プロジェクトの追加

Azure Boards プロジェクトを追加する前に、まず Azure Boards 組織を追加する必要があります。

Azure Boards プロジェクトを追加するには:

  1. クラウドサイバーエクスポージャー コンソールで、[Settings > 統合] に移動し、追加した関連する Azure Boards 組織を見つけます。

  2. 組織名の横にある三点リーダーをクリックし、[プロジェクトの追加] をクリックします。[プロジェクトを追加] ウィザードが開きます。

    注意: [プロジェクト] ドロップダウンには、クラウドサイバーエクスポージャー Azure Boards コネクタ アプリがすでにメンバーである Azure DevOps プロジェクトのみが一覧表示されます。目的のプロジェクトがリストにない場合は、[プロジェクトに追加] の 組織の追加 に追加します。
  3. プロジェクトをアクティブ化します (ウィザードのステップ 1):

    1. ドロップダウンから追加するAzure Boardsプロジェクトを選択します。

      注意: プロジェクトがドロップダウンに表示されない場合は、 組織アクセス許可を付与して Azure DevOps に追加します。
    2. [次へ] をクリックします。
  4. 作業項目の優先度を同期して、 Tenable の検出結果の深刻度を Azure Boards の対応する優先度と一致させます (ウィザードの手順 2)。Tenable 経由で作成された Azure Boards 作業項目には、選択した優先順位が割り当てられます。作業項目の種類 (バグ、タスク、ストーリー、組織で定義されているカスタムの種類) ごとに、 検出結果の深刻度 を Azure Boards の既定の優先順位フィールドである [優先度] フィールドの値に割り当てます。完了したら、[次へ] をクリックします。
  5. 作業項目の状態を同期して、 Tenable の検出結果の状態を Azure Boards の対応する状態に合わせます (ウィザードの手順 3)。Tenable 経由で作成された Azure Boards 作業項目には、選択した状態が割り当てられます。作業項目の種類ごとに、Azure Boardsの必須フィールドである [状態] フィールドの値に検出結果の状態を割り当てます。[終了] をクリックします。

プロジェクトが正常に追加されると、Azure Boards Settings > 統合の表>表示されます。

検出結果のAzure Boards作業項目の詳細

検出結果を Azure Boards 作業項目にリンクした後、検出結果テーブルのチケット アイコンにカーソルを合わせると、 プロジェクト、 作業項目の種類、 ID、および作業項目へのリンクが表示されます。

作業項目の更新を同期する

Tenable 検出結果の変更に応じて、リンクされた Azure Boards 作業項目を最新の状態に保ちます。

  • 状態と深刻度は、プロジェクトの追加 で構成したマッピングに基づいて、Tenable から Azure Boards に自動的に更新されます。
  • 担当者は 、 Tenable と Azure Boards の間で双方向に同期します。 Tenable は、Azure Boards で行われた他のフィールドの変更を検出結果に同期しません。

たとえば、構成が無効なために、統合で作業項目を更新できない場合、 Tenable は、Jira の場合と同じ方法で、失敗の表示と理由でプロジェクトの状態にフラグを立てます。

サポートされている作業項目の種類とフィールド

Tenable は、作業項目を作成および同期するときに、次の Azure Boards 作業項目の種類とフィールドをサポートします。

  • 作業項目の種類。 すべての組み込みの種類 (ユーザー ストーリー、バグ、タスク、エピックなど) と、組織で定義されているカスタム作業項目の種類。
  • 標準フィールド。 タイトル、説明、イテレーション、エリア、優先度、担当者、工数、タグ (タグの作成を含む)。
  • カスタムフィールド。 サポートされているフィールドタイプにマッピングされるカスタムフィールド。
  • フィールドタイプ。 文字列、整数、double、ブーリアン値、日付と時刻、および選択リスト (1 つの選択した値)。

以下はサポートされていません。

  • 作業項目のリンク。 親子リンクおよび関連するリンク。
  • コラボレーションと歴史。 コメント、ディスカッションスレッド、改訂履歴。
  • 専門分野。 担当者以外のアイデンティティ フィールド、依存フィールド、サードパーティ拡張機能によって生成されたフィールド。

Azure Boards 作業項目のサンプル

A sample Azure Boards work item created for a finding