Microsoft Sentinel 用 Cisco Duo Security (Azure Functions を使用) コネクタ

[アーティクル]
07/29/2023

Cisco Duo Security データコネクタは、Cisco Duo Admin API を使って、認証ログ、管理者ログ、テレフォニーログ、オフライン登録ログ、Trust Monitor イベントを Microsoft Sentinel に取り込む機能を提供します。詳細については、API のドキュメントを参照してください。

コネクタの属性

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

クエリのサンプル

すべての Cisco Duo ログ

CiscoDuo_CL

| sort by TimeGenerated desc

前提条件

Cisco Duo Security (Azure Functions を使用) と統合するには、次のものがあることをご確認ください:

Microsoft.Web/sites のアクセス許可: 関数アプリを作成するための、Azure Functions に対する読み取りと書き込みのアクセス許可が必要です。 Azure Functions の詳細については、こちらのドキュメントを参照してください。
Cisco Duo API の資格情報: Cisco Duo API には、アクセス許可 "ログの読み取りを許可する" を持つ Cisco Duo API の資格情報が必要です。 Cisco Duo API の資格情報の作成について詳しくは、ドキュメントをご覧ください。

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

注意

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

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

注意

このデータコネクタは、Kusto 関数に基づくパーサー (Microsoft Sentinel ソリューションと共にデプロイされている CiscoDuo) を利用して期待どおりに動作します。

ステップ 1 - Cisco Duo Admin API の資格情報の取得

手順に従って、統合キー、秘密鍵、API ホスト名を取得します。手順の 4 番目のステップでは、[Grant read log] (ログの読み取りを許可する) アクセス許可を使います。

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

重要: データコネクタをデプロイする前に、ワークスペース ID とワークスペース主キー (以下からコピー可)、および Azure Blob Storage 接続文字列とコンテナー名をすぐに使用できるようにしておきます。

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

ARM テンプレートを使ってデータコネクタを自動的にデプロイするには、この方法を使用します。

下の [Azure へのデプロイ] ボタンをクリックします。
ご希望の [サブスクリプション]、[リソースグループ]、[場所] を選択します。
Cisco Duo 統合キー、Cisco Duo 秘密鍵、Cisco Duo API ホスト名、Cisco Duo ログの種類、Microsoft Sentinel ワークスペース ID、Microsoft Sentinel 共有キーを入力します
[上記のご契約条件に同意する] というラベルのチェックボックスをオンにします。
[購入] をクリックしてデプロイします。

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

Azure Functions を使用してデータコネクタを手動でデプロイするには、次の詳細な手順を使用します (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 内での一意性を確保するために検証されます。

e. ランタイムの選択: [Python 3.8] を選びます。

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

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

関数アプリで、関数アプリ名を選択し、[構成] を選択します。
[アプリケーションの設定] タブで、 [+ 新しいアプリケーション設定] を選択します。
次の各アプリケーション設定を、それぞれの文字列値を使用して個別に追加します (大文字と小文字を区別): CISCO_DUO_INTEGRATION_KEY CISCO_DUO_SECRET_KEY CISCO_DUO_API_HOSTNAME CISCO_DUO_LOG_TYPES WORKSPACE_ID SHARED_KEY logAnalyticsUri (省略可能)

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

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

次の手順

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