Pravidla upozornění Microsoft.SecurityInsights 2022-01-01-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

Jméno Popis Hodnota
typ entity Typ mapované entity V3 Účet
AzureResource
CloudApplication
DNS
"Soubor"
FileHash
"Hostitel"
IP adresa
Poštovní schránka
MailCluster
MailMessage
Malware
Proces
RegistryKey
RegistryValue
SecurityGroup
"SubmissionMail"
Adresa URL
mapování polí pole mapování polí pro dané mapování entity mapování polí []

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ů. GroupingConfiguration

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í do Azure
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

Jméno Popis Hodnota
typ entity Typ mapované entity V3 Účet
AzureResource
CloudApplication
DNS
"Soubor"
FileHash
"Hostitel"
IP adresa
Poštovní schránka
MailCluster
MailMessage
Malware
Proces
RegistryKey
RegistryValue
SecurityGroup
"SubmissionMail"
Adresa URL
mapování polí pole mapování polí pro dané mapování entity mapování polí []

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ů. GroupingConfiguration

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

Jméno Popis Hodnota
typ entity Typ mapované entity V3 Účet
AzureResource
CloudApplication
DNS
"Soubor"
FileHash
"Hostitel"
IP adresa
Poštovní schránka
MailCluster
MailMessage
Malware
Proces
RegistryKey
RegistryValue
SecurityGroup
"SubmissionMail"
Adresa URL
mapování polí pole mapování polí pro dané mapování entity mapování polí []

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ů. GroupingConfiguration

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é)