Microsoft Sentinel 用 Armis デバイス (Azure Functions を使用) コネクタ

[アーティクル]
05/02/2024

Armis デバイスコネクタは、Armis REST API を介して Armis デバイスを Microsoft Sentinel に取り込む機能を提供します。詳細については、API のドキュメント (https://<YourArmisInstance>.armis.com/api/v1/docs) を参照してください。コネクタは、Armis プラットフォームからデバイス情報を取得する機能を提供します。 Armis は、既存のインフラストラクチャを使用して、エージェントをデプロイすることなく、デバイスを検出して識別します。 Armis は、既存の IT およびセキュリティ管理ツールと統合して、環境内で管理されている、または管理されていないありとあらゆるデバイスを識別して分類することもできます。

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

コネクタの属性

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

クエリのサンプル

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

Armis_Devices_CL

| sort by TimeGenerated desc

前提条件

Armis デバイス (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 関数に基づくパーサーに依存して正常に動作します。 Kusto 関数のエイリアス ArmisDevice を作成するには、こちらの手順に従ってください

手順 1 - Armis API の構成手順

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

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

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

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

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

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

下の [Azure へのデプロイ] ボタンをクリックします。
ご希望の [サブスクリプション]、[リソースグループ]、[場所] を選択します。
次の情報を追加します。
- 関数名
- ワークスペース ID
- ワークスペースキー
- Armis 秘密鍵
- Armis URL https://<armis-instance>.armis.com/api/v1/
- Armis デバイステーブル名
- Armis スケジュール
- 重複を回避 (既定値: true)
[上記の使用条件に同意する] というラベルのチェックボックスをオンにします。
[購入] をクリックしてデプロイします。

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

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

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

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

Azure 関数アプリファイルをダウンロードします。アーカイブをローカル開発用コンピューターに抽出します。
VS Code を起動します。メインメニューで [ファイル] を選び、[フォルダーを開く] を選択します。
展開されたファイルから最上位のフォルダーを選択します。
アクティビティバーで Azure アイコンを選択し、[Azure: Functions] 領域の [関数アプリにデプロイ] ボタンを選択します。まだサインインしていない場合は、アクティビティバーの Azure アイコンを選択し、[Azure: Functions] 領域で [Azure にサインイン] を選択します。既にサインインしている場合は、次の手順に進みます。
プロンプトで、次の情報を入力します。

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

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

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

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

e. Select a runtime (ランタイムの選択): Python 3.8 以上を選択します。

f. 新しいリソースの場所を選択してくださいパフォーマンスを向上させ、コストを下げるために、Microsoft Sentinel が配置されているのと同じリージョンを選びます。
デプロイが開始されます。関数アプリが作成され、展開パッケージが適用されると、通知が表示されます。
関数アプリを構成するために、Azure portal に移動します。

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

関数アプリで、関数アプリ名を選択し、[構成] を選択します。
[アプリケーションの設定] タブで、 [+ 新しいアプリケーション設定] を選択します。
次の各アプリケーション設定を、それぞれの値で個別に追加します (大文字と小文字を区別します)。
- ワークスペース ID
- ワークスペースキー
- Armis 秘密鍵
- Armis URL https://<armis-instance>.armis.com/api/v1/
- Armis デバイステーブル名
- Armis スケジュール
- 重複を回避 (既定値: true)
- logAnalyticsUri (省略可能)

専用クラウドの Log Analytics API エンドポイントをオーバーライドするには、logAnalyticsUri を使用します。たとえば、パブリッククラウドではこの値を空のままにします。Azure GovUS クラウド環境では、https://<CustomerId>.ods.opinsights.azure.us の形式で値を指定します。

すべてのアプリケーション設定を入力したら、[保存] をクリックします。

次の手順

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

Share via