Microsoft Sentinel自動化ルールをコードとして管理します。 プログラムの一部として、自動化ルールを Azure Resource Manager (ARM) テンプレート ファイルにエクスポートし、これらのファイルからルールをインポートして、Microsoft Sentinelデプロイをコードとして管理および制御できるようになりました。 エクスポートアクションはブラウザのダウンロード先にJSONファイルを作成します。 その後、ファイル名の変更や移動、その他の処理は他のファイルと同じようにできます。
エクスポートされた JSON ファイルはワークスペースに依存しないため、他のワークスペースや他のテナントにもインポートできます。 コードとして、マネージド CI/CD フレームワークでバージョン管理、更新、デプロイすることもできます。
エクスポートされたJSONファイルには、自動化ルールで定義されたすべてのパラメータが含まれています。 任意のトリガーの種類のルールを JSON ファイルにエクスポートできます。
このセクションでは、Microsoft Sentinel自動化ルールのエクスポートおよびインポート方法を説明します。
重要
2027 年 3 月 31 日以降、Microsoft SentinelはAzure portalでサポートされなくなり、Microsoft Defender ポータルでのみ使用できるようになります。 Azure portalでMicrosoft Sentinelを使用しているすべてのお客様は、Defender ポータルにリダイレクトされ、Defender ポータルでのみMicrosoft Sentinelを使用します。
Azure portalでMicrosoft Sentinelを引き続き使用している場合は、スムーズな移行を確保し、Microsoft Defenderによって提供される統合セキュリティ操作エクスペリエンスを最大限に活用するために、Defender ポータルへの移行の計画を開始することをお勧めします。
注:
Microsoft Defender ポータルで自動化ページを開くには、パッケージのパスを使用してください:
- DefenderポータルのMicrosoft Sentinelでは、Microsoft Sentinel>Configuration>Automation。
- ISOC のメイン ナビゲーション メニュー: オートメーション。
自動化ルールをARMテンプレートにエクスポートする
1 つ以上の自動化規則を JSON ファイルにエクスポートするには、次の手順を実行します。
Azure ポータルの Microsoft Sentinel の場合、ナビゲーションメニューから「自動化」を選択します。
エクスポートするルール (またはルールを参照) を選択し、画面上部のバーから [エクスポート ] を選択します。
エクスポートしたファイルをダウンロード フォルダーで見つけます。 自動化規則と同じ名前で、.json拡張子が付いています。
注:
複数のオートメーション ルールを一度に選択してエクスポートするには、ルールの横にある [チェック] ボックスにマークを付け、最後に [エクスポート] を選択します。
[エクスポート] をクリックする前にヘッダー行の [チェック] ボックスにマークを付けることで、表示グリッドの 1 ページにすべてのルールを一度にエクスポートできます。 ただし、一度に複数のページのルールをエクスポートすることはできません。
複数のルールを一度にエクスポートすると、1 つのファイル ( Azure_Sentinel_automation_rules.jsonという名前) が作成され、エクスポートされたすべてのルールの JSON コードが含まれます。
ARMテンプレートから自動化ルールをインポートする
ARM テンプレート JSON ファイルから自動化規則をインポートするには、次の手順に従います。
自動化ルール ARM テンプレート JSON ファイルを準備します。
Azure ポータルの Microsoft Sentinel の場合、ナビゲーションメニューから「自動化」を選択します。
画面の上部にあるバーから [ インポート ] を選択します。 結果のダイアログ ボックスに移動し、インポートするルールを表す JSON ファイルを選択し、[ 開く] を選択します。
注:
1 つの ARM テンプレート ファイルから 最大 50 個の自動化ルールをインポートできます。
トラブルシューティング
エクスポートされた自動化ルールのインポートに問題がある場合は、このセクションのトラブルシューティング表を参照してください。
| 動作 ( エラーあり) | 理由 | 提案されているアクション |
|---|---|---|
|
インポートされたオートメーションルールが無効になっています - および- ルールの 分析ルール 条件に「不明ルール」が表示されます |
ルールには、ターゲット ワークスペースに存在しない分析ルールを参照する条件が含まれています。 |
|
|
インポートされたオートメーションルールが無効になっています - および- ルールの カスタム詳細キー 条件に「不明なカスタム詳細キー」が表示されます |
ルールには、ターゲット ワークスペース内の分析ルールで定義されていない カスタム詳細キー を参照する条件が含まれています。 |
|
|
ターゲットワークスペースでの展開に失敗し、「自動化ルールの展開に失敗しました」というエラーメッセージが表示されます。 デプロイの詳細には、[失敗の理由] 列に一覧表示されている 理由 が含まれています。 |
プレイブックが移動されました。 - または- プレイブックが削除されました。 - または- ターゲット ワークスペースはプレイブックにアクセスできません。 |
プレイブックが存在し、ターゲット ワークスペースがプレイブックを含むリソース グループに適切なアクセス権を持っていることを確認します。 |
|
ターゲット ワークスペースでのデプロイは、エラー メッセージ: 「自動化ルールのデプロイに失敗しました。」で失敗しました デプロイの詳細には、[失敗の理由] 列に一覧表示されている 理由 が含まれています。 |
自動化ルールは、インポート時に定義された有効期限を過ぎました。 |
ルールを元のワークスペースで期限切れのままにしておきたい場合は:
|
|
ターゲットワークスペースでのデプロイに失敗し、エラーメッセージが表示されました: "インポートしようとした JSON ファイルの形式が無効です。ファイルをチェックして、もう一度やり直してください。 |
インポートされたファイルは有効な JSON ファイルではありません。 | ファイルに問題がないか確認し、もう一度やり直してください。 最良の結果を得るには、元のルールをもう一度新しいファイルにエクスポートしてから、インポートをやり直してください。 |
|
ターゲットワークスペースでの展開に失敗し、エラーメッセージが表示されました: "ファイルにリソースが見つかりません。ファイルにデプロイ リソースが含まれていることを確認し、やり直してください。 |
JSON ファイルの "resources" キーの下にあるリソースの一覧が空です。 | ファイルに問題がないか確認し、もう一度やり直してください。 最良の結果を得るには、元のルールをもう一度新しいファイルにエクスポートしてから、インポートをやり直してください。 |
関連するコンテンツ
- 自動化規則の詳細と、自動化規則を作成して使用する方法について説明します。
- ARM テンプレートの詳細については、こちらをご覧ください。