次の方法で共有

Microsoft Sentinel 用の Armis Alerts Activities (Azure Functions を使用) コネクタ

  • [アーティクル]

Armis Alerts Activities コネクタを使うと、Armis REST API を介して Armis のアラートとアクティビティを Microsoft Sentinel に取り込むことができます。 詳細については、API のドキュメント (https://<YourArmisInstance>.armis.com/api/v1/docs) を参照してください。 このコネクタは、Armis プラットフォームからアラートとアクティビティの情報を取得し、環境内の脅威を特定して優先順位を付ける機能を提供します。 Armis は、既存のインフラストラクチャを使用して、エージェントをデプロイすることなく、デバイスを検出して識別します。

これは自動生成されたコンテンツです。 変更については、ソリューション プロバイダーにお問い合わせください。

コネクタの属性

コネクタ属性 説明
Azure 関数アプリのコード https://aka.ms/sentinel-ArmisAlertsActivitiesAPI-functionapp
Log Analytics テーブル Armis_Alerts_CL
Armis_Activities_CL
データ収集ルールのサポート 現在、サポートされていません
サポートしているもの Armis Corporation

クエリのサンプル

Armis アラート イベント - すべてのアラート。

Armis_Alerts_CL

| sort by TimeGenerated desc

Armis アクティビティ イベント - すべてのアクティビティ。

Armis_Activities_CL

| sort by TimeGenerated desc

前提条件

Armis Alerts Activities (Azure Functions を使用) と統合するには、次のものがあることを確認します。

  • Microsoft.Web/sites のアクセス許可: 関数アプリを作成するための、Azure Functions に対する読み取りと書き込みのアクセス許可が必要です。 Azure Functions の詳細については、こちらのドキュメントを参照してください。
  • REST API の資格情報/アクセス許可: Armis 秘密鍵が必要です。 API の詳細については、こちらのドキュメント https://<YourArmisInstance>.armis.com/api/v1/doc を参照してください

ベンダーのインストール手順

Note

このコネクタでは Azure Functions を使用して Armis API に接続し、そのログを Microsoft Sentinel にプルします。 これにより、追加のデータ インジェスト コストが発生する可能性があります。 詳細については、「Azure Functions の価格」ページを確認してください。

(省略可能な手順) ワークスペースと API の認可キーまたはトークンを Azure Key Vault に安全に格納します。 Azure Key Vault には、キー値を格納および取得するためのセキュリティで保護されたメカニズムが用意されています。 Azure 関数アプリで Azure Key Vault を使用するには、これらの手順に従います。

注意

このデータ コネクタは、ソリューションの一部としてデプロイされている Kusto 関数に基づくパーサーを利用して正常に動作します。 Log Analytics で関数コードを表示するには、Log Analytics の Microsoft Sentinel ログ ブレードを開き、[関数] をクリックしてエイリアス ArmisActivities/ArmisAlerts を検索し、関数コードを読み込みます。 この関数は、通常、ソリューションのインストール/更新後にアクティブ化されるまでに 10 から 15 分かかります。

手順 1 - Armis API の構成手順

以下の手順に従って、Armis API 秘密鍵を作成します。

  1. Armis インスタンスにログインします
  2. [設定] -> [API Management] に移動します
  3. 秘密鍵がまだ作成されていない場合は、[作成] ボタンを押して秘密鍵を作成します
  4. 秘密鍵にアクセスするには、[表示] ボタンを押します
  5. 秘密鍵をコピーし、Armis Alerts Activities コネクタの構成で使用できるようになります

手順 2 - 次の 2 つのデプロイ オプションから 1 つを選び、コネクタと関連付けられている Azure 関数をデプロイする

重要: Armis Alerts Activities データ コネクタをデプロイする前に、ワークスペース ID とワークスペースのプライマリ キー (以下からコピー可)、および Armis API の認可キーを、すぐに使用できるようにしておいてください

オプション 1 - Azure Resource Manager (ARM) テンプレート

Armis コネクタの自動デプロイには、この方法を使用します。

  1. 下の [Azure へのデプロイ] ボタンをクリックします。

    Azure にデプロイする Deploy to Azure Gov

  2. ご希望の [サブスクリプション]、[リソース グループ]、[場所] を選択します。

  3. 次の情報を追加します。

    • 関数名
    • ワークスペース ID
    • ワークスペース キー
    • Armis 秘密鍵
    • Armis URL https://<armis-instance>.armis.com/api/v1/
    • Armis アラート テーブル名
    • Armis アクティビティ テーブル名
    • Armis スケジュール
    • 重複を回避 (既定値: true)

  4. [上記の使用条件に同意する] というラベルのチェックボックスをオンにします。

  5. [購入] をクリックしてデプロイします。

オプション 2 - Azure Functions の手動デプロイ

Azure Functions を使って Armis Alerts Activities データ コネクタを手動でデプロイするには、次の詳細な手順のようにします (Visual Studio Code によるデプロイ)。

1. 関数アプリをデプロイする

注: Azure 関数の開発には VS Code を準備する必要があります。

  1. Azure 関数アプリ ファイルをダウンロードします。 アーカイブをローカル開発用コンピューターに抽出します。

  2. VS Code を起動します。 メイン メニューで [ファイル] を選び、[フォルダーを開く] を選択します。

  3. 展開されたファイルから最上位のフォルダーを選択します。

  4. アクティビティ バーで Azure アイコンを選択し、[Azure: Functions] 領域の [関数アプリにデプロイ] ボタンを選択します。 まだサインインしていない場合は、アクティビティ バーの Azure アイコンを選択し、[Azure: Functions] 領域で [Azure にサインイン] を選択します。既にサインインしている場合は、次の手順に進みます。

  5. プロンプトで、次の情報を入力します。

    a. フォルダーの選択: ワークスペースのフォルダーを選択するか、関数アプリが格納されているフォルダーを参照します。

    b. サブスクリプションの選択: 使用するサブスクリプションを選択します。

    c. [Azure で新しい関数アプリを作成する] を選択します ([詳細設定] オプションは選ばないでください)

    d. 関数アプリのグローバルに一意の名前を入力: URL パスで有効な名前を入力します 入力した名前は、Azure Functions 内での一意性を確保するために検証されます。 (例: ARMISXXXXX)。

    e. ランタイムの選択: Python 3.11 を選びます

    f. 新しいリソースの場所を選択してください パフォーマンスを向上させ、コストを下げるために、Microsoft Sentinel が配置されているのと同じリージョンを選びます。

  6. デプロイが開始されます。 関数アプリが作成され、展開パッケージが適用されると、通知が表示されます。

  7. 関数アプリを構成するために、Azure portal に移動します。

2. 関数アプリを構成する

  1. 関数アプリで、関数アプリ名を選択し、[構成] を選択します。
  2. [アプリケーションの設定] タブで、 [+ 新しいアプリケーション設定] を選択します。
  3. 次の各アプリケーション設定を、それぞれの値で個別に追加します (大文字と小文字を区別します)。
    • ワークスペース ID
    • ワークスペース キー
    • Armis 秘密鍵
    • Armis URL https://<armis-instance>.armis.com/api/v1/
    • Armis アラート テーブル名
    • Armis アクティビティ テーブル名
    • Armis スケジュール
    • 重複を回避 (既定値: true)
    • logAnalyticsUri (省略可能)
  • 専用クラウドの Log Analytics API エンドポイントをオーバーライドするには、logAnalyticsUri を使用します。 たとえば、パブリック クラウドではこの値を空のままにします。Azure GovUS クラウド環境では、https://<CustomerId>.ods.opinsights.azure.us の形式で値を指定します。
  1. すべてのアプリケーション設定を入力したら、[保存] をクリックします。

次の手順

詳細については、Azure Marketplace の関連ソリューションに関するページを参照してください。