Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
- nejnovější
- 2025-10-01-Náhled
- 2025-09-01
- 2025-07-01-preview
- 2025-06-01
- 2025-04-01-preview
- 2025-03-01
- 2025-01-01-preview
- z 10. 10. 2024 ve verzi Preview
-
2024-09-09 -
2024-04-01-preview -
2024-03-01 - 1. 1. 2024 ve verzi Preview
-
12. 12. 2023 ve verzi Preview - 11. 11. 2023
- 10. 10. 2023 ve verzi Preview
-
2023-09-01-preview -
2023-08-01-preview -
2023-07-01-preview -
2023-06-01-preview -
2023-05-01-preview -
2023-04-01-Preview - 1. 3. 2023 ve verzi Preview
- 2023-02-01
-
2023-023-01-preview -
12. 12. 2022 ve verzi Preview - 11. 11. 2022
- 11. 11. 2022 ve verzi Preview
-
10. 10. 2022 ve verzi Preview -
2022-09-01-preview - 2022-08-01
- 2022-08-01-náhled
-
2022-07-01-preview -
2022-06-01-preview -
2022-05-01-preview -
2022-04-01-preview -
2022-01-01-preview - 10. 10. 2021
-
10. 10. 2021 ve verzi Preview - z 9. 9. 2021 ve verzi Preview
-
2021-03-01-preview - 1. 1. 2020
-
1. 1. 2019 ve verzi Preview
Definice prostředku Bicep
Typ prostředku alertRules je možné nasadit s operacemi, které cílí:
Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.
Příklady použití
Ukázky Bicep
Základní příklad nasazení pravidla Sentinel Alert.
param resourceName string = 'acctest0001'
param location string = 'westeurope'
resource workspace 'Microsoft.OperationalInsights/workspaces@2022-10-01' = {
name: resourceName
location: location
properties: {
features: {
disableLocalAuth: false
enableLogAccessUsingOnlyResourcePermissions: true
}
publicNetworkAccessForIngestion: 'Enabled'
publicNetworkAccessForQuery: 'Enabled'
retentionInDays: 30
sku: {
name: 'PerGB2018'
}
workspaceCapping: {
dailyQuotaGb: -1
}
}
}
resource onboardingState 'Microsoft.SecurityInsights/onboardingStates@2023-06-01-preview' = {
name: 'default'
scope: workspace
properties: {
customerManagedKey: false
}
}
resource alertRule 'Microsoft.SecurityInsights/alertRules@2022-10-01-preview' = {
name: resourceName
scope: workspace
dependsOn: [
onboardingState
]
kind: 'NRT'
properties: {
description: ''
displayName: 'Some Rule'
enabled: true
query: '''AzureActivity |
where OperationName == "Create or Update Virtual Machine" or OperationName =="Create Deployment" |
where ActivityStatus == "Succeeded" |
make-series dcount(ResourceId) default=0 on EventSubmissionTimestamp in range(ago(7d), now(), 1d) by Caller
'''
severity: 'High'
suppressionDuration: 'PT5H'
suppressionEnabled: false
tactics: []
techniques: []
}
}
Formát prostředku
Pokud chcete vytvořit prostředek Microsoft.SecurityInsights/alertRules, přidejte do šablony následující bicep.
resource symbolicname 'Microsoft.SecurityInsights/alertRules@2022-01-01-preview' = {
etag: 'string'
name: 'string'
kind: 'string'
// For remaining properties, see Microsoft.SecurityInsights/alertRules objects
}
Objekty Microsoft.SecurityInsights/alertRules
Nastavte druh vlastnost určit typ objektu.
Pro Fusionpoužijte:
{
kind: 'Fusion'
properties: {
alertRuleTemplateName: 'string'
enabled: bool
scenarioExclusionPatterns: [
{
dateAddedInUTC: 'string'
exclusionPattern: 'string'
}
]
sourceSettings: [
{
enabled: bool
sourceName: 'string'
sourceSubTypes: [
{
enabled: bool
severityFilters: {
filters: [
{
enabled: bool
severity: 'string'
}
]
}
sourceSubTypeName: 'string'
}
]
}
]
}
}
Pro MLBehaviorAnalyticspoužijte:
{
kind: 'MLBehaviorAnalytics'
properties: {
alertRuleTemplateName: 'string'
enabled: bool
}
}
Pro MicrosoftSecurityIncidentCreationpoužijte:
{
kind: 'MicrosoftSecurityIncidentCreation'
properties: {
alertRuleTemplateName: 'string'
description: 'string'
displayName: 'string'
displayNamesExcludeFilter: [
'string'
]
displayNamesFilter: [
'string'
]
enabled: bool
productFilter: 'string'
severitiesFilter: [
'string'
]
}
}
Pro NRTpoužijte:
{
kind: 'NRT'
properties: {
alertDetailsOverride: {
alertDescriptionFormat: 'string'
alertDisplayNameFormat: 'string'
alertSeverityColumnName: 'string'
alertTacticsColumnName: 'string'
}
alertRuleTemplateName: 'string'
customDetails: {
{customized property}: 'string'
}
description: 'string'
displayName: 'string'
enabled: bool
entityMappings: [
{
entityType: 'string'
fieldMappings: [
{
columnName: 'string'
identifier: 'string'
}
]
}
]
incidentConfiguration: {
createIncident: bool
groupingConfiguration: {
enabled: bool
groupByAlertDetails: [
'string'
]
groupByCustomDetails: [
'string'
]
groupByEntities: [
'string'
]
lookbackDuration: 'string'
matchingMethod: 'string'
reopenClosedIncident: bool
}
}
query: 'string'
severity: 'string'
suppressionDuration: 'string'
suppressionEnabled: bool
tactics: [
'string'
]
techniques: [
'string'
]
templateVersion: 'string'
}
}
Pro Naplánovanépoužijte:
{
kind: 'Scheduled'
properties: {
alertDetailsOverride: {
alertDescriptionFormat: 'string'
alertDisplayNameFormat: 'string'
alertSeverityColumnName: 'string'
alertTacticsColumnName: 'string'
}
alertRuleTemplateName: 'string'
customDetails: {
{customized property}: 'string'
}
description: 'string'
displayName: 'string'
enabled: bool
entityMappings: [
{
entityType: 'string'
fieldMappings: [
{
columnName: 'string'
identifier: 'string'
}
]
}
]
eventGroupingSettings: {
aggregationKind: 'string'
}
incidentConfiguration: {
createIncident: bool
groupingConfiguration: {
enabled: bool
groupByAlertDetails: [
'string'
]
groupByCustomDetails: [
'string'
]
groupByEntities: [
'string'
]
lookbackDuration: 'string'
matchingMethod: 'string'
reopenClosedIncident: bool
}
}
query: 'string'
queryFrequency: 'string'
queryPeriod: 'string'
severity: 'string'
suppressionDuration: 'string'
suppressionEnabled: bool
tactics: [
'string'
]
techniques: [
'string'
]
templateVersion: 'string'
triggerOperator: 'string'
triggerThreshold: int
}
}
Pro ThreatIntelligence použijte:
{
kind: 'ThreatIntelligence'
properties: {
alertRuleTemplateName: 'string'
enabled: bool
}
}
Hodnoty vlastností
Microsoft.SecurityInsights/alertRules
| Jméno | Popis | Hodnota |
|---|---|---|
| etag | Označení prostředku Azure | řetězec |
| laskavý | Pro typ FusionAlertRulenastavte hodnotu FusionAlertRule . Nastavte na MLBehaviorAnalytics pro typ MLBehaviorAnalyticsAlertRule. Nastavte na MicrosoftSecurityIncidentCreation pro typ MicrosoftSecurityIncidentCreationAlertRule. Pro typ NrtAlertRulenastavte na nrtAlertRule . Pro typ ScheduledAlertRulenastavte hodnotu ScheduledAlertRule . Nastavte na ThreatIntelligence pro typ ThreatIntelligenceAlertRule. | "Fúzní" MicrosoftSecurityIncidentCreation MLBehaviorAnalytics "NRT" Naplánované ThreatIntelligence (povinné) |
| Jméno | Název prostředku | string (povinné) |
| obor | Slouží k vytvoření prostředku v oboru, který se liší od oboru nasazení. | Nastavte tuto vlastnost na symbolický název prostředku, který použijeprostředku rozšíření |
AlertDetailsOverride
| Jméno | Popis | Hodnota |
|---|---|---|
| alertDescriptionFormat | formát obsahující názvy sloupců pro přepsání popisu výstrahy | řetězec |
| alertDisplayNameFormat | formát obsahující názvy sloupců pro přepsání názvu výstrahy | řetězec |
| Název_sloupce alertSeverityColumnName | název sloupce, ze které má být závažnost výstrahy | řetězec |
| alertTacticsColumnName | název sloupce, ze které se mají použít taktika upozornění | řetězec |
mapování entit
Nastavení seskupení událostí
| Jméno | Popis | Hodnota |
|---|---|---|
| druh agregace | Typy agregace seskupení událostí | AlertPerResult SingleAlert |
Mapování polí
| Jméno | Popis | Hodnota |
|---|---|---|
| název_sloupce | název sloupce, který se má namapovat na identifikátor | řetězec |
| identifikátor | identifikátor entity V3 | řetězec |
Pravidlo FusionAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | "Fúzní" (povinné) |
| vlastnosti | Vlastnosti pravidla fúzního upozornění | FusionAlertRuleProperties |
FusionAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | string (povinné) |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| scenarioExclusionPatterns | Konfigurace pro vyloučení scénářů při detekci fúzní syntézy | Vzor vyloučení scénáře fúze[] |
| sourceSettings | Konfigurace pro všechny podporované zdrojové signály při detekci fúzní syntézy | Nastavení zdroje FusionSource[] |
Vzor vyloučení scénáře fúze
| Jméno | Popis | Hodnota |
|---|---|---|
| dateAddedInUTC | DateTime, kdy se vzor vyloučení scénáře přidá v UTC. | string (povinné) |
| vzor vyloučení | Model vyloučení scénáře | string (povinné) |
Nastavení zdroje FusionSource
| Jméno | Popis | Hodnota |
|---|---|---|
| zpřístupněný | Určuje, zda je tento zdrojový signál povolen nebo zakázán v fúzní detekci. | bool (povinné) |
| Název zdroje | Název signálu fúzního zdroje. Informace o podporovaných hodnotách najdete v šabloně pravidla fúzního upozornění. | string (povinné) |
| sourceSubTypes | Konfigurace pro všechny podtypy zdroje v rámci tohoto zdrojového signálu spotřebovaného při detekci fúzní syntézy. | FusionSourceSubTypeSetting[] |
FusionSourceSubTypeSetting
| Jméno | Popis | Hodnota |
|---|---|---|
| zpřístupněný | Určuje, zda je tento zdrojový podtyp podtypu ve zdrojovém signálu povolený nebo zakázaný v detekci fúze. | bool (povinné) |
| Filtry závažnosti | Konfigurace závažnosti pro zdrojový podtyp spotřebovaný při detekci fúzní syntézy | FusionSubTypeSeverityFilter (povinné) |
| zdrojNázevSubTypeName | Název podtypu zdroje pod daným zdrojovým signálem v detekci fusion. Informace o podporovaných hodnotách najdete v šabloně pravidla fúzního upozornění. | string (povinné) |
FusionSubTypeSeverityFilter
| Jméno | Popis | Hodnota |
|---|---|---|
| filtruje | Individuální nastavení konfigurace závažnosti pro daný zdrojový podtyp spotřebovaný v detekci fúzní syntézy | FusionSubTypeSeverityFiltersItem[] |
Položka FusionSubTypeSeverityFiltersItem
| Jméno | Popis | Hodnota |
|---|---|---|
| zpřístupněný | Určuje, jestli je tato závažnost povolená nebo zakázaná pro tento zdrojový podtyp spotřebovaný v detekci fusion. | bool (povinné) |
| závažnost | Závažnost pro daný zdrojový podtyp spotřebovaný v detekci fúzní syntézy. | "Vysoká" Informační "Nízká" Střední (povinné) |
Konfigurace seskupení
| Jméno | Popis | Hodnota |
|---|---|---|
| zpřístupněný | Povoleno seskupování | bool (povinné) |
| groupByAlertDetails | Seznam podrobností o upozornění, podle které se má seskupit (pokud je vybrána odpovídající hodnotaMethod) | Řetězcové pole obsahující některou z těchto možností: DisplayName Závažnost |
| groupByCustomDetails | Seznam vlastních klíčů podrobností, podle které se seskupí (pokud je vybrána shodaMethod). Je možné použít pouze klíče definované v aktuálním pravidlu upozornění. | řetězec[] |
| groupByEntities | Seznam typů entit, podle které se seskupí (pokud je vybrána shodaMethod). Je možné použít pouze entity definované v aktuálním pravidlu upozornění. | Řetězcové pole obsahující některou z těchto možností: Účet AzureResource CloudApplication DNS "Soubor" FileHash "Hostitel" IP adresa Poštovní schránka MailCluster MailMessage Malware Proces RegistryKey RegistryValue SecurityGroup "SubmissionMail" Adresa URL |
| doba trvání lookbacku | Omezení skupiny na výstrahy vytvořené během doby trvání zpětného vyhledávání (ve formátu doby trvání ISO 8601) | string (povinné) |
| matching– metoda | Seskupování odpovídající metody Pokud je metoda Vybrána alespoň jedna z groupByEntities, groupByAlertDetails, groupByCustomDetails musí být poskytována a není prázdná. | "AllEntities" AnyAlert Vybráno (povinné) |
| znovu otevřítClosedIncident | Opětovné otevření uzavřených odpovídajících incidentů | bool (povinné) |
Konfigurace incidentu
| Jméno | Popis | Hodnota |
|---|---|---|
| createIncident | Vytváření incidentů z upozornění aktivovaných tímto analytickým pravidlem | bool (povinné) |
| groupingConfiguration | Nastavte, jak se výstrahy aktivované tímto analytickým pravidlem seskupují do incidentů. | |
MicrosoftSecurityIncidentCreationAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | MicrosoftSecurityIncidentCreation (povinné) |
| vlastnosti | Vlastnosti pravidla MicrosoftSecurityIncidentCreation | MicrosoftSecurityIncidentCreationAlertRuleProperties |
MicrosoftSecurityIncidentCreationAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | řetězec |
| popis | Popis pravidla upozornění. | řetězec |
| zobrazované jméno | Zobrazovaný název pro výstrahy vytvořené tímto pravidlem upozornění | string (povinné) |
| displayNamesExcludeFilter | displayNames výstrah, pro které nebudou vygenerovány případy | řetězec[] |
| filtr displayNamesFilter | displayNames výstrah, pro které budou vygenerovány případy | řetězec[] |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| ProductFilter | ProductName výstrah, pro které budou vygenerovány případy | Azure Active Directory Identity Protection Azure Advanced Threat Protection Azure Security Center pro IoT Azure Security Center Microsoft Cloud App Security Rozšířená ochrana před internetovými útoky v programu Microsoft Defender Office 365 Advanced Threat Protection (povinné) |
| závažnostiFilter | závažnosti výstrah, pro které budou vygenerovány případy | Řetězcové pole obsahující některou z těchto možností: "Vysoká" Informační "Nízká" "Střední" |
MLBehaviorAnalyticsAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | MLBehaviorAnalytics (povinné) |
| vlastnosti | Vlastnosti pravidla upozornění MLBehaviorAnalytics | MLBehaviorAnalyticsAlertRuleProperties |
MLBehaviorAnalyticsAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | string (povinné) |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
NrtAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | "NRT" (povinné) |
| vlastnosti | Vlastnosti pravidla upozornění NRT | nrtAlertRuleProperties |
NrtAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| alertDetailsOverride | Nastavení přepsání podrobností výstrahy | AlertDetailsOverride |
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | řetězec |
| customDetails | Slovník párů klíč-hodnota řetězce, které mají být připojeny k upozornění | NrtAlertRulePropertiesCustomDetails |
| popis | Popis pravidla upozornění. | řetězec |
| zobrazované jméno | Zobrazovaný název pro výstrahy vytvořené tímto pravidlem upozornění | string (povinné) |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| EntityMappings | Pole mapování entit pravidla upozornění | EntityMapping [] |
| konfigurace incidentu | Nastavení incidentů vytvořených z výstrah aktivovaných tímto analytickým pravidlem | incidentconfiguration |
| dotaz | Dotaz, který pro toto pravidlo vytvoří výstrahy. | string (povinné) |
| závažnost | Závažnost upozornění vytvořená tímto pravidlem upozornění. | "Vysoká" Informační "Nízká" Střední (povinné) |
| trvání potlačení | Potlačení (ve formátu doby trvání ISO 8601) čeká od posledního spuštění tohoto pravidla upozornění. | string (povinné) |
| potlačeníEnabled | Určuje, jestli je potlačení pro toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| taktika | Taktika pravidla upozornění | Řetězcové pole obsahující některou z těchto možností: Kolekce CommandAndControl CredentialAccess "DefenseEvasion" Zjišťování Provádění Exfiltrace Dopad "NarušovatprocessControl" InhibiceResponseFunction InitialAccess LateralMovement Trvalost "Předpřipojený" "Eskalace oprávnění" "Rekognoskace" ResourceDevelopment |
| techniky | Techniky pravidla upozornění | řetězec[] |
| verze šablony | Verze šablony pravidla upozornění použitá k vytvoření tohoto pravidla – ve formátu <a.b.c>, kde jsou všechna čísla, například 0 <1.0.2> | řetězec |
NrtAlertRulePropertiesCustomDetails
| Jméno | Popis | Hodnota |
|---|
ScheduledAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | Naplánované (povinné) |
| vlastnosti | Vlastnosti naplánovaného pravidla upozornění | ScheduledAlertRuleProperties |
ScheduledAlertRuleCommonPropertiesCustomDetails
| Jméno | Popis | Hodnota |
|---|
ScheduledAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| alertDetailsOverride | Nastavení přepsání podrobností výstrahy | AlertDetailsOverride |
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | řetězec |
| customDetails | Slovník párů klíč-hodnota řetězce, které mají být připojeny k upozornění | ScheduledAlertRuleCommonPropertiesCustomDetails |
| popis | Popis pravidla upozornění. | řetězec |
| zobrazované jméno | Zobrazovaný název pro výstrahy vytvořené tímto pravidlem upozornění | string (povinné) |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| EntityMappings | Pole mapování entit pravidla upozornění | EntityMapping [] |
| Nastavení seskupení událostí | Nastavení seskupení událostí. | EventGroupingSettings |
| konfigurace incidentu | Nastavení incidentů vytvořených z výstrah aktivovaných tímto analytickým pravidlem | incidentconfiguration |
| dotaz | Dotaz, který pro toto pravidlo vytvoří výstrahy. | řetězec |
| Frekvence dotazů | Frekvence (ve formátu doby trvání ISO 8601) pro spuštění tohoto pravidla upozornění. | řetězec |
| queryPeriod | Období (ve formátu doby trvání ISO 8601), na které toto pravidlo upozornění sleduje. | řetězec |
| závažnost | Závažnost upozornění vytvořená tímto pravidlem upozornění. | "Vysoká" Informační "Nízká" "Střední" |
| trvání potlačení | Potlačení (ve formátu doby trvání ISO 8601) čeká od posledního spuštění tohoto pravidla upozornění. | string (povinné) |
| potlačeníEnabled | Určuje, jestli je potlačení pro toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| taktika | Taktika pravidla upozornění | Řetězcové pole obsahující některou z těchto možností: Kolekce CommandAndControl CredentialAccess "DefenseEvasion" Zjišťování Provádění Exfiltrace Dopad "NarušovatprocessControl" InhibiceResponseFunction InitialAccess LateralMovement Trvalost "Předpřipojený" "Eskalace oprávnění" "Rekognoskace" ResourceDevelopment |
| techniky | Techniky pravidla upozornění | řetězec[] |
| verze šablony | Verze šablony pravidla upozornění použitá k vytvoření tohoto pravidla – ve formátu <a.b.c>, kde jsou všechna čísla, například 0 <1.0.2> | řetězec |
| Operátor triggeru | Operace proti prahové hodnotě, která aktivuje pravidlo upozornění. | "Rovná se" "GreaterThan" "LessThan" NotEqual |
| prahová hodnota spouště | Prahová hodnota aktivuje toto pravidlo upozornění. | Int |
Pravidlo ThreatIntelligenceAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | ThreatIntelligence (povinné) |
| vlastnosti | Vlastnosti pravidla upozornění analýzy hrozeb | ThreatIntelligenceAlertRuleProperties |
ThreatIntelligenceAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | string (povinné) |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
Definice prostředku šablony ARM
Typ prostředku alertRules je možné nasadit s operacemi, které cílí:
Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.
Příklady použití
Šablony Azure pro rychlý start
Následující šablony Azure Pro rychlý start nasadit tento typ prostředku.
| Šablona | Popis |
|---|---|
|
vytvoří nové pravidlo naplánované analýzy služby Microsoft Sentinel nasazení |
Tato ukázka ukazuje, jak vytvořit nové naplánované analytické pravidlo v Microsoft Sentinelu. |
Formát prostředku
Pokud chcete vytvořit prostředek Microsoft.SecurityInsights/alertRules, přidejte do šablony následující JSON.
{
"etag": "string",
"name": "string",
"kind": "string"
// For remaining properties, see Microsoft.SecurityInsights/alertRules objects
}
Objekty Microsoft.SecurityInsights/alertRules
Nastavte druh vlastnost určit typ objektu.
Pro Fusionpoužijte:
{
"kind": "Fusion",
"properties": {
"alertRuleTemplateName": "string",
"enabled": "bool",
"scenarioExclusionPatterns": [
{
"dateAddedInUTC": "string",
"exclusionPattern": "string"
}
],
"sourceSettings": [
{
"enabled": "bool",
"sourceName": "string",
"sourceSubTypes": [
{
"enabled": "bool",
"severityFilters": {
"filters": [
{
"enabled": "bool",
"severity": "string"
}
]
},
"sourceSubTypeName": "string"
}
]
}
]
}
}
Pro MLBehaviorAnalyticspoužijte:
{
"kind": "MLBehaviorAnalytics",
"properties": {
"alertRuleTemplateName": "string",
"enabled": "bool"
}
}
Pro MicrosoftSecurityIncidentCreationpoužijte:
{
"kind": "MicrosoftSecurityIncidentCreation",
"properties": {
"alertRuleTemplateName": "string",
"description": "string",
"displayName": "string",
"displayNamesExcludeFilter": [ "string" ],
"displayNamesFilter": [ "string" ],
"enabled": "bool",
"productFilter": "string",
"severitiesFilter": [ "string" ]
}
}
Pro NRTpoužijte:
{
"kind": "NRT",
"properties": {
"alertDetailsOverride": {
"alertDescriptionFormat": "string",
"alertDisplayNameFormat": "string",
"alertSeverityColumnName": "string",
"alertTacticsColumnName": "string"
},
"alertRuleTemplateName": "string",
"customDetails": {
"{customized property}": "string"
},
"description": "string",
"displayName": "string",
"enabled": "bool",
"entityMappings": [
{
"entityType": "string",
"fieldMappings": [
{
"columnName": "string",
"identifier": "string"
}
]
}
],
"incidentConfiguration": {
"createIncident": "bool",
"groupingConfiguration": {
"enabled": "bool",
"groupByAlertDetails": [ "string" ],
"groupByCustomDetails": [ "string" ],
"groupByEntities": [ "string" ],
"lookbackDuration": "string",
"matchingMethod": "string",
"reopenClosedIncident": "bool"
}
},
"query": "string",
"severity": "string",
"suppressionDuration": "string",
"suppressionEnabled": "bool",
"tactics": [ "string" ],
"techniques": [ "string" ],
"templateVersion": "string"
}
}
Pro Naplánovanépoužijte:
{
"kind": "Scheduled",
"properties": {
"alertDetailsOverride": {
"alertDescriptionFormat": "string",
"alertDisplayNameFormat": "string",
"alertSeverityColumnName": "string",
"alertTacticsColumnName": "string"
},
"alertRuleTemplateName": "string",
"customDetails": {
"{customized property}": "string"
},
"description": "string",
"displayName": "string",
"enabled": "bool",
"entityMappings": [
{
"entityType": "string",
"fieldMappings": [
{
"columnName": "string",
"identifier": "string"
}
]
}
],
"eventGroupingSettings": {
"aggregationKind": "string"
},
"incidentConfiguration": {
"createIncident": "bool",
"groupingConfiguration": {
"enabled": "bool",
"groupByAlertDetails": [ "string" ],
"groupByCustomDetails": [ "string" ],
"groupByEntities": [ "string" ],
"lookbackDuration": "string",
"matchingMethod": "string",
"reopenClosedIncident": "bool"
}
},
"query": "string",
"queryFrequency": "string",
"queryPeriod": "string",
"severity": "string",
"suppressionDuration": "string",
"suppressionEnabled": "bool",
"tactics": [ "string" ],
"techniques": [ "string" ],
"templateVersion": "string",
"triggerOperator": "string",
"triggerThreshold": "int"
}
}
Pro ThreatIntelligence použijte:
{
"kind": "ThreatIntelligence",
"properties": {
"alertRuleTemplateName": "string",
"enabled": "bool"
}
}
Hodnoty vlastností
Microsoft.SecurityInsights/alertRules
| Jméno | Popis | Hodnota |
|---|---|---|
| Verze rozhraní apiVersion | Verze rozhraní API | 2022-01-01-preview |
| etag | Označení prostředku Azure | řetězec |
| laskavý | Pro typ FusionAlertRulenastavte hodnotu FusionAlertRule . Nastavte na MLBehaviorAnalytics pro typ MLBehaviorAnalyticsAlertRule. Nastavte na MicrosoftSecurityIncidentCreation pro typ MicrosoftSecurityIncidentCreationAlertRule. Pro typ NrtAlertRulenastavte na nrtAlertRule . Pro typ ScheduledAlertRulenastavte hodnotu ScheduledAlertRule . Nastavte na ThreatIntelligence pro typ ThreatIntelligenceAlertRule. | "Fúzní" MicrosoftSecurityIncidentCreation MLBehaviorAnalytics "NRT" Naplánované ThreatIntelligence (povinné) |
| Jméno | Název prostředku | string (povinné) |
| typ | Typ prostředku | Microsoft.SecurityInsights/alertRules |
AlertDetailsOverride
| Jméno | Popis | Hodnota |
|---|---|---|
| alertDescriptionFormat | formát obsahující názvy sloupců pro přepsání popisu výstrahy | řetězec |
| alertDisplayNameFormat | formát obsahující názvy sloupců pro přepsání názvu výstrahy | řetězec |
| Název_sloupce alertSeverityColumnName | název sloupce, ze které má být závažnost výstrahy | řetězec |
| alertTacticsColumnName | název sloupce, ze které se mají použít taktika upozornění | řetězec |
mapování entit
Nastavení seskupení událostí
| Jméno | Popis | Hodnota |
|---|---|---|
| druh agregace | Typy agregace seskupení událostí | AlertPerResult SingleAlert |
Mapování polí
| Jméno | Popis | Hodnota |
|---|---|---|
| název_sloupce | název sloupce, který se má namapovat na identifikátor | řetězec |
| identifikátor | identifikátor entity V3 | řetězec |
Pravidlo FusionAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | "Fúzní" (povinné) |
| vlastnosti | Vlastnosti pravidla fúzního upozornění | FusionAlertRuleProperties |
FusionAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | string (povinné) |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| scenarioExclusionPatterns | Konfigurace pro vyloučení scénářů při detekci fúzní syntézy | Vzor vyloučení scénáře fúze[] |
| sourceSettings | Konfigurace pro všechny podporované zdrojové signály při detekci fúzní syntézy | Nastavení zdroje FusionSource[] |
Vzor vyloučení scénáře fúze
| Jméno | Popis | Hodnota |
|---|---|---|
| dateAddedInUTC | DateTime, kdy se vzor vyloučení scénáře přidá v UTC. | string (povinné) |
| vzor vyloučení | Model vyloučení scénáře | string (povinné) |
Nastavení zdroje FusionSource
| Jméno | Popis | Hodnota |
|---|---|---|
| zpřístupněný | Určuje, zda je tento zdrojový signál povolen nebo zakázán v fúzní detekci. | bool (povinné) |
| Název zdroje | Název signálu fúzního zdroje. Informace o podporovaných hodnotách najdete v šabloně pravidla fúzního upozornění. | string (povinné) |
| sourceSubTypes | Konfigurace pro všechny podtypy zdroje v rámci tohoto zdrojového signálu spotřebovaného při detekci fúzní syntézy. | FusionSourceSubTypeSetting[] |
FusionSourceSubTypeSetting
| Jméno | Popis | Hodnota |
|---|---|---|
| zpřístupněný | Určuje, zda je tento zdrojový podtyp podtypu ve zdrojovém signálu povolený nebo zakázaný v detekci fúze. | bool (povinné) |
| Filtry závažnosti | Konfigurace závažnosti pro zdrojový podtyp spotřebovaný při detekci fúzní syntézy | FusionSubTypeSeverityFilter (povinné) |
| zdrojNázevSubTypeName | Název podtypu zdroje pod daným zdrojovým signálem v detekci fusion. Informace o podporovaných hodnotách najdete v šabloně pravidla fúzního upozornění. | string (povinné) |
FusionSubTypeSeverityFilter
| Jméno | Popis | Hodnota |
|---|---|---|
| filtruje | Individuální nastavení konfigurace závažnosti pro daný zdrojový podtyp spotřebovaný v detekci fúzní syntézy | FusionSubTypeSeverityFiltersItem[] |
Položka FusionSubTypeSeverityFiltersItem
| Jméno | Popis | Hodnota |
|---|---|---|
| zpřístupněný | Určuje, jestli je tato závažnost povolená nebo zakázaná pro tento zdrojový podtyp spotřebovaný v detekci fusion. | bool (povinné) |
| závažnost | Závažnost pro daný zdrojový podtyp spotřebovaný v detekci fúzní syntézy. | "Vysoká" Informační "Nízká" Střední (povinné) |
Konfigurace seskupení
| Jméno | Popis | Hodnota |
|---|---|---|
| zpřístupněný | Povoleno seskupování | bool (povinné) |
| groupByAlertDetails | Seznam podrobností o upozornění, podle které se má seskupit (pokud je vybrána odpovídající hodnotaMethod) | Řetězcové pole obsahující některou z těchto možností: DisplayName Závažnost |
| groupByCustomDetails | Seznam vlastních klíčů podrobností, podle které se seskupí (pokud je vybrána shodaMethod). Je možné použít pouze klíče definované v aktuálním pravidlu upozornění. | řetězec[] |
| groupByEntities | Seznam typů entit, podle které se seskupí (pokud je vybrána shodaMethod). Je možné použít pouze entity definované v aktuálním pravidlu upozornění. | Řetězcové pole obsahující některou z těchto možností: Účet AzureResource CloudApplication DNS "Soubor" FileHash "Hostitel" IP adresa Poštovní schránka MailCluster MailMessage Malware Proces RegistryKey RegistryValue SecurityGroup "SubmissionMail" Adresa URL |
| doba trvání lookbacku | Omezení skupiny na výstrahy vytvořené během doby trvání zpětného vyhledávání (ve formátu doby trvání ISO 8601) | string (povinné) |
| matching– metoda | Seskupování odpovídající metody Pokud je metoda Vybrána alespoň jedna z groupByEntities, groupByAlertDetails, groupByCustomDetails musí být poskytována a není prázdná. | "AllEntities" AnyAlert Vybráno (povinné) |
| znovu otevřítClosedIncident | Opětovné otevření uzavřených odpovídajících incidentů | bool (povinné) |
Konfigurace incidentu
| Jméno | Popis | Hodnota |
|---|---|---|
| createIncident | Vytváření incidentů z upozornění aktivovaných tímto analytickým pravidlem | bool (povinné) |
| groupingConfiguration | Nastavte, jak se výstrahy aktivované tímto analytickým pravidlem seskupují do incidentů. | |
MicrosoftSecurityIncidentCreationAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | MicrosoftSecurityIncidentCreation (povinné) |
| vlastnosti | Vlastnosti pravidla MicrosoftSecurityIncidentCreation | MicrosoftSecurityIncidentCreationAlertRuleProperties |
MicrosoftSecurityIncidentCreationAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | řetězec |
| popis | Popis pravidla upozornění. | řetězec |
| zobrazované jméno | Zobrazovaný název pro výstrahy vytvořené tímto pravidlem upozornění | string (povinné) |
| displayNamesExcludeFilter | displayNames výstrah, pro které nebudou vygenerovány případy | řetězec[] |
| filtr displayNamesFilter | displayNames výstrah, pro které budou vygenerovány případy | řetězec[] |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| ProductFilter | ProductName výstrah, pro které budou vygenerovány případy | Azure Active Directory Identity Protection Azure Advanced Threat Protection Azure Security Center pro IoT Azure Security Center Microsoft Cloud App Security Rozšířená ochrana před internetovými útoky v programu Microsoft Defender Office 365 Advanced Threat Protection (povinné) |
| závažnostiFilter | závažnosti výstrah, pro které budou vygenerovány případy | Řetězcové pole obsahující některou z těchto možností: "Vysoká" Informační "Nízká" "Střední" |
MLBehaviorAnalyticsAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | MLBehaviorAnalytics (povinné) |
| vlastnosti | Vlastnosti pravidla upozornění MLBehaviorAnalytics | MLBehaviorAnalyticsAlertRuleProperties |
MLBehaviorAnalyticsAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | string (povinné) |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
NrtAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | "NRT" (povinné) |
| vlastnosti | Vlastnosti pravidla upozornění NRT | nrtAlertRuleProperties |
NrtAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| alertDetailsOverride | Nastavení přepsání podrobností výstrahy | AlertDetailsOverride |
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | řetězec |
| customDetails | Slovník párů klíč-hodnota řetězce, které mají být připojeny k upozornění | NrtAlertRulePropertiesCustomDetails |
| popis | Popis pravidla upozornění. | řetězec |
| zobrazované jméno | Zobrazovaný název pro výstrahy vytvořené tímto pravidlem upozornění | string (povinné) |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| EntityMappings | Pole mapování entit pravidla upozornění | EntityMapping [] |
| konfigurace incidentu | Nastavení incidentů vytvořených z výstrah aktivovaných tímto analytickým pravidlem | incidentconfiguration |
| dotaz | Dotaz, který pro toto pravidlo vytvoří výstrahy. | string (povinné) |
| závažnost | Závažnost upozornění vytvořená tímto pravidlem upozornění. | "Vysoká" Informační "Nízká" Střední (povinné) |
| trvání potlačení | Potlačení (ve formátu doby trvání ISO 8601) čeká od posledního spuštění tohoto pravidla upozornění. | string (povinné) |
| potlačeníEnabled | Určuje, jestli je potlačení pro toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| taktika | Taktika pravidla upozornění | Řetězcové pole obsahující některou z těchto možností: Kolekce CommandAndControl CredentialAccess "DefenseEvasion" Zjišťování Provádění Exfiltrace Dopad "NarušovatprocessControl" InhibiceResponseFunction InitialAccess LateralMovement Trvalost "Předpřipojený" "Eskalace oprávnění" "Rekognoskace" ResourceDevelopment |
| techniky | Techniky pravidla upozornění | řetězec[] |
| verze šablony | Verze šablony pravidla upozornění použitá k vytvoření tohoto pravidla – ve formátu <a.b.c>, kde jsou všechna čísla, například 0 <1.0.2> | řetězec |
NrtAlertRulePropertiesCustomDetails
| Jméno | Popis | Hodnota |
|---|
ScheduledAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | Naplánované (povinné) |
| vlastnosti | Vlastnosti naplánovaného pravidla upozornění | ScheduledAlertRuleProperties |
ScheduledAlertRuleCommonPropertiesCustomDetails
| Jméno | Popis | Hodnota |
|---|
ScheduledAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| alertDetailsOverride | Nastavení přepsání podrobností výstrahy | AlertDetailsOverride |
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | řetězec |
| customDetails | Slovník párů klíč-hodnota řetězce, které mají být připojeny k upozornění | ScheduledAlertRuleCommonPropertiesCustomDetails |
| popis | Popis pravidla upozornění. | řetězec |
| zobrazované jméno | Zobrazovaný název pro výstrahy vytvořené tímto pravidlem upozornění | string (povinné) |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| EntityMappings | Pole mapování entit pravidla upozornění | EntityMapping [] |
| Nastavení seskupení událostí | Nastavení seskupení událostí. | EventGroupingSettings |
| konfigurace incidentu | Nastavení incidentů vytvořených z výstrah aktivovaných tímto analytickým pravidlem | incidentconfiguration |
| dotaz | Dotaz, který pro toto pravidlo vytvoří výstrahy. | řetězec |
| Frekvence dotazů | Frekvence (ve formátu doby trvání ISO 8601) pro spuštění tohoto pravidla upozornění. | řetězec |
| queryPeriod | Období (ve formátu doby trvání ISO 8601), na které toto pravidlo upozornění sleduje. | řetězec |
| závažnost | Závažnost upozornění vytvořená tímto pravidlem upozornění. | "Vysoká" Informační "Nízká" "Střední" |
| trvání potlačení | Potlačení (ve formátu doby trvání ISO 8601) čeká od posledního spuštění tohoto pravidla upozornění. | string (povinné) |
| potlačeníEnabled | Určuje, jestli je potlačení pro toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| taktika | Taktika pravidla upozornění | Řetězcové pole obsahující některou z těchto možností: Kolekce CommandAndControl CredentialAccess "DefenseEvasion" Zjišťování Provádění Exfiltrace Dopad "NarušovatprocessControl" InhibiceResponseFunction InitialAccess LateralMovement Trvalost "Předpřipojený" "Eskalace oprávnění" "Rekognoskace" ResourceDevelopment |
| techniky | Techniky pravidla upozornění | řetězec[] |
| verze šablony | Verze šablony pravidla upozornění použitá k vytvoření tohoto pravidla – ve formátu <a.b.c>, kde jsou všechna čísla, například 0 <1.0.2> | řetězec |
| Operátor triggeru | Operace proti prahové hodnotě, která aktivuje pravidlo upozornění. | "Rovná se" "GreaterThan" "LessThan" NotEqual |
| prahová hodnota spouště | Prahová hodnota aktivuje toto pravidlo upozornění. | Int |
Pravidlo ThreatIntelligenceAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | ThreatIntelligence (povinné) |
| vlastnosti | Vlastnosti pravidla upozornění analýzy hrozeb | ThreatIntelligenceAlertRuleProperties |
ThreatIntelligenceAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | string (povinné) |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
Definice prostředku Terraformu (poskytovatel AzAPI)
Typ prostředku alertRules je možné nasadit s operacemi, které cílí:
Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.
Příklady použití
Ukázky Terraformu
Základní příklad nasazení pravidla Sentinel Alert.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "workspace" {
type = "Microsoft.OperationalInsights/workspaces@2022-10-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
features = {
disableLocalAuth = false
enableLogAccessUsingOnlyResourcePermissions = true
}
publicNetworkAccessForIngestion = "Enabled"
publicNetworkAccessForQuery = "Enabled"
retentionInDays = 30
sku = {
name = "PerGB2018"
}
workspaceCapping = {
dailyQuotaGb = -1
}
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
resource "azapi_resource" "onboardingState" {
type = "Microsoft.SecurityInsights/onboardingStates@2023-06-01-preview"
parent_id = azapi_resource.workspace.id
name = "default"
body = {
properties = {
customerManagedKey = false
}
}
}
resource "azapi_resource" "alertRule" {
type = "Microsoft.SecurityInsights/alertRules@2022-10-01-preview"
parent_id = azapi_resource.workspace.id
name = var.resource_name
body = {
kind = "NRT"
properties = {
description = ""
displayName = "Some Rule"
enabled = true
query = "AzureActivity |\n where OperationName == \"Create or Update Virtual Machine\" or OperationName ==\"Create Deployment\" |\n where ActivityStatus == \"Succeeded\" |\n make-series dcount(ResourceId) default=0 on EventSubmissionTimestamp in range(ago(7d), now(), 1d) by Caller\n"
severity = "High"
suppressionDuration = "PT5H"
suppressionEnabled = false
tactics = [
]
techniques = [
]
}
}
schema_validation_enabled = false
response_export_values = ["*"]
depends_on = [azapi_resource.onboardingState]
}
Formát prostředku
Pokud chcete vytvořit prostředek Microsoft.SecurityInsights/alertRules, přidejte do šablony následující Terraform.
resource "azapi_resource" "symbolicname" {
etag = "string"
name = "string"
kind = "string"
// For remaining properties, see Microsoft.SecurityInsights/alertRules objects
}
Objekty Microsoft.SecurityInsights/alertRules
Nastavte druh vlastnost určit typ objektu.
Pro Fusionpoužijte:
{
kind = "Fusion"
properties = {
alertRuleTemplateName = "string"
enabled = bool
scenarioExclusionPatterns = [
{
dateAddedInUTC = "string"
exclusionPattern = "string"
}
]
sourceSettings = [
{
enabled = bool
sourceName = "string"
sourceSubTypes = [
{
enabled = bool
severityFilters = {
filters = [
{
enabled = bool
severity = "string"
}
]
}
sourceSubTypeName = "string"
}
]
}
]
}
}
Pro MLBehaviorAnalyticspoužijte:
{
kind = "MLBehaviorAnalytics"
properties = {
alertRuleTemplateName = "string"
enabled = bool
}
}
Pro MicrosoftSecurityIncidentCreationpoužijte:
{
kind = "MicrosoftSecurityIncidentCreation"
properties = {
alertRuleTemplateName = "string"
description = "string"
displayName = "string"
displayNamesExcludeFilter = [
"string"
]
displayNamesFilter = [
"string"
]
enabled = bool
productFilter = "string"
severitiesFilter = [
"string"
]
}
}
Pro NRTpoužijte:
{
kind = "NRT"
properties = {
alertDetailsOverride = {
alertDescriptionFormat = "string"
alertDisplayNameFormat = "string"
alertSeverityColumnName = "string"
alertTacticsColumnName = "string"
}
alertRuleTemplateName = "string"
customDetails = {
{customized property} = "string"
}
description = "string"
displayName = "string"
enabled = bool
entityMappings = [
{
entityType = "string"
fieldMappings = [
{
columnName = "string"
identifier = "string"
}
]
}
]
incidentConfiguration = {
createIncident = bool
groupingConfiguration = {
enabled = bool
groupByAlertDetails = [
"string"
]
groupByCustomDetails = [
"string"
]
groupByEntities = [
"string"
]
lookbackDuration = "string"
matchingMethod = "string"
reopenClosedIncident = bool
}
}
query = "string"
severity = "string"
suppressionDuration = "string"
suppressionEnabled = bool
tactics = [
"string"
]
techniques = [
"string"
]
templateVersion = "string"
}
}
Pro Naplánovanépoužijte:
{
kind = "Scheduled"
properties = {
alertDetailsOverride = {
alertDescriptionFormat = "string"
alertDisplayNameFormat = "string"
alertSeverityColumnName = "string"
alertTacticsColumnName = "string"
}
alertRuleTemplateName = "string"
customDetails = {
{customized property} = "string"
}
description = "string"
displayName = "string"
enabled = bool
entityMappings = [
{
entityType = "string"
fieldMappings = [
{
columnName = "string"
identifier = "string"
}
]
}
]
eventGroupingSettings = {
aggregationKind = "string"
}
incidentConfiguration = {
createIncident = bool
groupingConfiguration = {
enabled = bool
groupByAlertDetails = [
"string"
]
groupByCustomDetails = [
"string"
]
groupByEntities = [
"string"
]
lookbackDuration = "string"
matchingMethod = "string"
reopenClosedIncident = bool
}
}
query = "string"
queryFrequency = "string"
queryPeriod = "string"
severity = "string"
suppressionDuration = "string"
suppressionEnabled = bool
tactics = [
"string"
]
techniques = [
"string"
]
templateVersion = "string"
triggerOperator = "string"
triggerThreshold = int
}
}
Pro ThreatIntelligence použijte:
{
kind = "ThreatIntelligence"
properties = {
alertRuleTemplateName = "string"
enabled = bool
}
}
Hodnoty vlastností
Microsoft.SecurityInsights/alertRules
| Jméno | Popis | Hodnota |
|---|---|---|
| etag | Označení prostředku Azure | řetězec |
| laskavý | Pro typ FusionAlertRulenastavte hodnotu FusionAlertRule . Nastavte na MLBehaviorAnalytics pro typ MLBehaviorAnalyticsAlertRule. Nastavte na MicrosoftSecurityIncidentCreation pro typ MicrosoftSecurityIncidentCreationAlertRule. Pro typ NrtAlertRulenastavte na nrtAlertRule . Pro typ ScheduledAlertRulenastavte hodnotu ScheduledAlertRule . Nastavte na ThreatIntelligence pro typ ThreatIntelligenceAlertRule. | "Fúzní" MicrosoftSecurityIncidentCreation MLBehaviorAnalytics "NRT" Naplánované ThreatIntelligence (povinné) |
| Jméno | Název prostředku | string (povinné) |
| ID rodiče | ID prostředku, na který se má tento prostředek rozšíření použít. | string (povinné) |
| typ | Typ prostředku | Microsoft.SecurityInsights/alertRules@2022-01-01-preview |
AlertDetailsOverride
| Jméno | Popis | Hodnota |
|---|---|---|
| alertDescriptionFormat | formát obsahující názvy sloupců pro přepsání popisu výstrahy | řetězec |
| alertDisplayNameFormat | formát obsahující názvy sloupců pro přepsání názvu výstrahy | řetězec |
| Název_sloupce alertSeverityColumnName | název sloupce, ze které má být závažnost výstrahy | řetězec |
| alertTacticsColumnName | název sloupce, ze které se mají použít taktika upozornění | řetězec |
mapování entit
Nastavení seskupení událostí
| Jméno | Popis | Hodnota |
|---|---|---|
| druh agregace | Typy agregace seskupení událostí | AlertPerResult SingleAlert |
Mapování polí
| Jméno | Popis | Hodnota |
|---|---|---|
| název_sloupce | název sloupce, který se má namapovat na identifikátor | řetězec |
| identifikátor | identifikátor entity V3 | řetězec |
Pravidlo FusionAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | "Fúzní" (povinné) |
| vlastnosti | Vlastnosti pravidla fúzního upozornění | FusionAlertRuleProperties |
FusionAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | string (povinné) |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| scenarioExclusionPatterns | Konfigurace pro vyloučení scénářů při detekci fúzní syntézy | Vzor vyloučení scénáře fúze[] |
| sourceSettings | Konfigurace pro všechny podporované zdrojové signály při detekci fúzní syntézy | Nastavení zdroje FusionSource[] |
Vzor vyloučení scénáře fúze
| Jméno | Popis | Hodnota |
|---|---|---|
| dateAddedInUTC | DateTime, kdy se vzor vyloučení scénáře přidá v UTC. | string (povinné) |
| vzor vyloučení | Model vyloučení scénáře | string (povinné) |
Nastavení zdroje FusionSource
| Jméno | Popis | Hodnota |
|---|---|---|
| zpřístupněný | Určuje, zda je tento zdrojový signál povolen nebo zakázán v fúzní detekci. | bool (povinné) |
| Název zdroje | Název signálu fúzního zdroje. Informace o podporovaných hodnotách najdete v šabloně pravidla fúzního upozornění. | string (povinné) |
| sourceSubTypes | Konfigurace pro všechny podtypy zdroje v rámci tohoto zdrojového signálu spotřebovaného při detekci fúzní syntézy. | FusionSourceSubTypeSetting[] |
FusionSourceSubTypeSetting
| Jméno | Popis | Hodnota |
|---|---|---|
| zpřístupněný | Určuje, zda je tento zdrojový podtyp podtypu ve zdrojovém signálu povolený nebo zakázaný v detekci fúze. | bool (povinné) |
| Filtry závažnosti | Konfigurace závažnosti pro zdrojový podtyp spotřebovaný při detekci fúzní syntézy | FusionSubTypeSeverityFilter (povinné) |
| zdrojNázevSubTypeName | Název podtypu zdroje pod daným zdrojovým signálem v detekci fusion. Informace o podporovaných hodnotách najdete v šabloně pravidla fúzního upozornění. | string (povinné) |
FusionSubTypeSeverityFilter
| Jméno | Popis | Hodnota |
|---|---|---|
| filtruje | Individuální nastavení konfigurace závažnosti pro daný zdrojový podtyp spotřebovaný v detekci fúzní syntézy | FusionSubTypeSeverityFiltersItem[] |
Položka FusionSubTypeSeverityFiltersItem
| Jméno | Popis | Hodnota |
|---|---|---|
| zpřístupněný | Určuje, jestli je tato závažnost povolená nebo zakázaná pro tento zdrojový podtyp spotřebovaný v detekci fusion. | bool (povinné) |
| závažnost | Závažnost pro daný zdrojový podtyp spotřebovaný v detekci fúzní syntézy. | "Vysoká" Informační "Nízká" Střední (povinné) |
Konfigurace seskupení
| Jméno | Popis | Hodnota |
|---|---|---|
| zpřístupněný | Povoleno seskupování | bool (povinné) |
| groupByAlertDetails | Seznam podrobností o upozornění, podle které se má seskupit (pokud je vybrána odpovídající hodnotaMethod) | Řetězcové pole obsahující některou z těchto možností: DisplayName Závažnost |
| groupByCustomDetails | Seznam vlastních klíčů podrobností, podle které se seskupí (pokud je vybrána shodaMethod). Je možné použít pouze klíče definované v aktuálním pravidlu upozornění. | řetězec[] |
| groupByEntities | Seznam typů entit, podle které se seskupí (pokud je vybrána shodaMethod). Je možné použít pouze entity definované v aktuálním pravidlu upozornění. | Řetězcové pole obsahující některou z těchto možností: Účet AzureResource CloudApplication DNS "Soubor" FileHash "Hostitel" IP adresa Poštovní schránka MailCluster MailMessage Malware Proces RegistryKey RegistryValue SecurityGroup "SubmissionMail" Adresa URL |
| doba trvání lookbacku | Omezení skupiny na výstrahy vytvořené během doby trvání zpětného vyhledávání (ve formátu doby trvání ISO 8601) | string (povinné) |
| matching– metoda | Seskupování odpovídající metody Pokud je metoda Vybrána alespoň jedna z groupByEntities, groupByAlertDetails, groupByCustomDetails musí být poskytována a není prázdná. | "AllEntities" AnyAlert Vybráno (povinné) |
| znovu otevřítClosedIncident | Opětovné otevření uzavřených odpovídajících incidentů | bool (povinné) |
Konfigurace incidentu
| Jméno | Popis | Hodnota |
|---|---|---|
| createIncident | Vytváření incidentů z upozornění aktivovaných tímto analytickým pravidlem | bool (povinné) |
| groupingConfiguration | Nastavte, jak se výstrahy aktivované tímto analytickým pravidlem seskupují do incidentů. | |
MicrosoftSecurityIncidentCreationAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | MicrosoftSecurityIncidentCreation (povinné) |
| vlastnosti | Vlastnosti pravidla MicrosoftSecurityIncidentCreation | MicrosoftSecurityIncidentCreationAlertRuleProperties |
MicrosoftSecurityIncidentCreationAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | řetězec |
| popis | Popis pravidla upozornění. | řetězec |
| zobrazované jméno | Zobrazovaný název pro výstrahy vytvořené tímto pravidlem upozornění | string (povinné) |
| displayNamesExcludeFilter | displayNames výstrah, pro které nebudou vygenerovány případy | řetězec[] |
| filtr displayNamesFilter | displayNames výstrah, pro které budou vygenerovány případy | řetězec[] |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| ProductFilter | ProductName výstrah, pro které budou vygenerovány případy | Azure Active Directory Identity Protection Azure Advanced Threat Protection Azure Security Center pro IoT Azure Security Center Microsoft Cloud App Security Rozšířená ochrana před internetovými útoky v programu Microsoft Defender Office 365 Advanced Threat Protection (povinné) |
| závažnostiFilter | závažnosti výstrah, pro které budou vygenerovány případy | Řetězcové pole obsahující některou z těchto možností: "Vysoká" Informační "Nízká" "Střední" |
MLBehaviorAnalyticsAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | MLBehaviorAnalytics (povinné) |
| vlastnosti | Vlastnosti pravidla upozornění MLBehaviorAnalytics | MLBehaviorAnalyticsAlertRuleProperties |
MLBehaviorAnalyticsAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | string (povinné) |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
NrtAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | "NRT" (povinné) |
| vlastnosti | Vlastnosti pravidla upozornění NRT | nrtAlertRuleProperties |
NrtAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| alertDetailsOverride | Nastavení přepsání podrobností výstrahy | AlertDetailsOverride |
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | řetězec |
| customDetails | Slovník párů klíč-hodnota řetězce, které mají být připojeny k upozornění | NrtAlertRulePropertiesCustomDetails |
| popis | Popis pravidla upozornění. | řetězec |
| zobrazované jméno | Zobrazovaný název pro výstrahy vytvořené tímto pravidlem upozornění | string (povinné) |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| EntityMappings | Pole mapování entit pravidla upozornění | EntityMapping [] |
| konfigurace incidentu | Nastavení incidentů vytvořených z výstrah aktivovaných tímto analytickým pravidlem | incidentconfiguration |
| dotaz | Dotaz, který pro toto pravidlo vytvoří výstrahy. | string (povinné) |
| závažnost | Závažnost upozornění vytvořená tímto pravidlem upozornění. | "Vysoká" Informační "Nízká" Střední (povinné) |
| trvání potlačení | Potlačení (ve formátu doby trvání ISO 8601) čeká od posledního spuštění tohoto pravidla upozornění. | string (povinné) |
| potlačeníEnabled | Určuje, jestli je potlačení pro toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| taktika | Taktika pravidla upozornění | Řetězcové pole obsahující některou z těchto možností: Kolekce CommandAndControl CredentialAccess "DefenseEvasion" Zjišťování Provádění Exfiltrace Dopad "NarušovatprocessControl" InhibiceResponseFunction InitialAccess LateralMovement Trvalost "Předpřipojený" "Eskalace oprávnění" "Rekognoskace" ResourceDevelopment |
| techniky | Techniky pravidla upozornění | řetězec[] |
| verze šablony | Verze šablony pravidla upozornění použitá k vytvoření tohoto pravidla – ve formátu <a.b.c>, kde jsou všechna čísla, například 0 <1.0.2> | řetězec |
NrtAlertRulePropertiesCustomDetails
| Jméno | Popis | Hodnota |
|---|
ScheduledAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | Naplánované (povinné) |
| vlastnosti | Vlastnosti naplánovaného pravidla upozornění | ScheduledAlertRuleProperties |
ScheduledAlertRuleCommonPropertiesCustomDetails
| Jméno | Popis | Hodnota |
|---|
ScheduledAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| alertDetailsOverride | Nastavení přepsání podrobností výstrahy | AlertDetailsOverride |
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | řetězec |
| customDetails | Slovník párů klíč-hodnota řetězce, které mají být připojeny k upozornění | ScheduledAlertRuleCommonPropertiesCustomDetails |
| popis | Popis pravidla upozornění. | řetězec |
| zobrazované jméno | Zobrazovaný název pro výstrahy vytvořené tímto pravidlem upozornění | string (povinné) |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| EntityMappings | Pole mapování entit pravidla upozornění | EntityMapping [] |
| Nastavení seskupení událostí | Nastavení seskupení událostí. | EventGroupingSettings |
| konfigurace incidentu | Nastavení incidentů vytvořených z výstrah aktivovaných tímto analytickým pravidlem | incidentconfiguration |
| dotaz | Dotaz, který pro toto pravidlo vytvoří výstrahy. | řetězec |
| Frekvence dotazů | Frekvence (ve formátu doby trvání ISO 8601) pro spuštění tohoto pravidla upozornění. | řetězec |
| queryPeriod | Období (ve formátu doby trvání ISO 8601), na které toto pravidlo upozornění sleduje. | řetězec |
| závažnost | Závažnost upozornění vytvořená tímto pravidlem upozornění. | "Vysoká" Informační "Nízká" "Střední" |
| trvání potlačení | Potlačení (ve formátu doby trvání ISO 8601) čeká od posledního spuštění tohoto pravidla upozornění. | string (povinné) |
| potlačeníEnabled | Určuje, jestli je potlačení pro toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |
| taktika | Taktika pravidla upozornění | Řetězcové pole obsahující některou z těchto možností: Kolekce CommandAndControl CredentialAccess "DefenseEvasion" Zjišťování Provádění Exfiltrace Dopad "NarušovatprocessControl" InhibiceResponseFunction InitialAccess LateralMovement Trvalost "Předpřipojený" "Eskalace oprávnění" "Rekognoskace" ResourceDevelopment |
| techniky | Techniky pravidla upozornění | řetězec[] |
| verze šablony | Verze šablony pravidla upozornění použitá k vytvoření tohoto pravidla – ve formátu <a.b.c>, kde jsou všechna čísla, například 0 <1.0.2> | řetězec |
| Operátor triggeru | Operace proti prahové hodnotě, která aktivuje pravidlo upozornění. | "Rovná se" "GreaterThan" "LessThan" NotEqual |
| prahová hodnota spouště | Prahová hodnota aktivuje toto pravidlo upozornění. | Int |
Pravidlo ThreatIntelligenceAlertRule
| Jméno | Popis | Hodnota |
|---|---|---|
| laskavý | Druh pravidla upozornění | ThreatIntelligence (povinné) |
| vlastnosti | Vlastnosti pravidla upozornění analýzy hrozeb | ThreatIntelligenceAlertRuleProperties |
ThreatIntelligenceAlertRuleProperties
| Jméno | Popis | Hodnota |
|---|---|---|
| Název_šablony alertRuleRuleTemplate | Název šablony pravidla upozornění použité k vytvoření tohoto pravidla. | string (povinné) |
| zpřístupněný | Určuje, jestli je toto pravidlo upozornění povolené nebo zakázané. | bool (povinné) |