Condividi tramite


Microsoft.SecurityInsights automationRules 2025-03-01

Definizione di risorsa Bicep

Il tipo di risorsa automationRules può essere distribuito con operazioni destinate a:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato delle risorse

Per creare una risorsa Microsoft.SecurityInsights/automationRules, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.SecurityInsights/automationRules@2025-03-01' = {
  scope: resourceSymbolicName or scope
  etag: 'string'
  name: 'string'
  properties: {
    actions: [
      {
        order: int
        actionType: 'string'
        // For remaining properties, see AutomationRuleAction objects
      }
    ]
    displayName: 'string'
    order: int
    triggeringLogic: {
      conditions: [
        {
          conditionType: 'string'
          // For remaining properties, see AutomationRuleCondition objects
        }
      ]
      expirationTimeUtc: 'string'
      isEnabled: bool
      triggersOn: 'string'
      triggersWhen: 'string'
    }
  }
}

Oggetti AutomationRuleAction

Impostare la proprietà actionType per specificare il tipo di oggetto.

Per AddIncidentTask, usare:

{
  actionConfiguration: {
    description: 'string'
    title: 'string'
  }
  actionType: 'AddIncidentTask'
}

Per ModifyProperties, usare:

{
  actionConfiguration: {
    classification: 'string'
    classificationComment: 'string'
    classificationReason: 'string'
    labels: [
      {
        labelName: 'string'
      }
    ]
    owner: {
      assignedTo: 'string'
      email: 'string'
      objectId: 'string'
      ownerType: 'string'
      userPrincipalName: 'string'
    }
    severity: 'string'
    status: 'string'
  }
  actionType: 'ModifyProperties'
}

Per RunPlaybook, usare:

{
  actionConfiguration: {
    logicAppResourceId: 'string'
    tenantId: 'string'
  }
  actionType: 'RunPlaybook'
}

Oggetti AutomationRuleCondition

Impostare la proprietà conditionType per specificare il tipo di oggetto.

Per booleano, usare:

{
  conditionProperties: {
    innerConditions: [
      {
        conditionType: 'string'
        // For remaining properties, see AutomationRuleCondition objects
      }
    ]
    operator: 'string'
  }
  conditionType: 'Boolean'
}

Per Proprietà, usare:

{
  conditionProperties: {
    operator: 'string'
    propertyName: 'string'
    propertyValues: [
      'string'
    ]
  }
  conditionType: 'Property'
}

Per PropertyArray, usare:

{
  conditionProperties: {
    arrayConditionType: 'string'
    arrayType: 'string'
    itemConditions: [
      {
        conditionType: 'string'
        // For remaining properties, see AutomationRuleCondition objects
      }
    ]
  }
  conditionType: 'PropertyArray'
}

Per PropertyArrayChanged, usare:

{
  conditionProperties: {
    arrayType: 'string'
    changeType: 'string'
  }
  conditionType: 'PropertyArrayChanged'
}

Per PropertyChanged, usare:

{
  conditionProperties: {
    changeType: 'string'
    operator: 'string'
    propertyName: 'string'
    propertyValues: [
      'string'
    ]
  }
  conditionType: 'PropertyChanged'
}

Valori delle proprietà

Microsoft.SecurityInsights/automationRules

Name Description Value
etag Etag della risorsa di Azure string
name Nome della risorsa stringa (obbligatorio)
properties Proprietà delle regole di automazione AutomationRuleProperties (obbligatorio)
scope Usare quando si crea una risorsa in un ambito diverso dall'ambito di distribuzione. Impostare questa proprietà sul nome simbolico di una risorsa per applicare la risorsa di estensione .

AddIncidentTaskActionProperties

Name Description Value
description Descrizione dell'attività. string
title Titolo dell'attività. stringa (obbligatorio)

AutomationRuleAction

Name Description Value
actionType Impostare su 'AddIncidentTask' per il tipo AutomationRuleAddIncidentTaskAction. Impostare su 'ModifyProperties' per il tipo AutomationRuleModifyPropertiesAction. Impostare su "RunPlaybook" per il tipo AutomationRuleRunPlaybookAction. 'AddIncidentTask'
'ModifyProperties'
'RunPlaybook' (obbligatorio)
order int (obbligatorio)

AutomationRuleAddIncidentTaskAction

Name Description Value
actionConfiguration Descrive un'azione della regola di automazione per aggiungere un'attività a un evento imprevisto. AddIncidentTaskActionProperties
actionType Tipo dell'azione della regola di automazione. 'AddIncidentTask' (obbligatorio)

AutomationRuleBooleanCondition

Name Description Value
innerConditions AutomationRuleCondition[]
operator Descrive un operatore di condizione booleano. 'And'
'Or'

AutomationRuleCondition

Name Description Value
conditionType Impostare su 'Boolean' per il tipo BooleanConditionProperties. Impostare su 'Property' per il tipo PropertyConditionProperties. Impostare su 'PropertyArray' per il tipo PropertyArrayConditionProperties. Impostare su 'PropertyArrayChanged' per il tipo PropertyArrayChangedConditionProperties. Impostare su 'PropertyChanged' per il tipo PropertyChangedConditionProperties. 'Boolean'
'Property'
'PropertyArray'
'PropertyArrayChanged'
'PropertyChanged' (obbligatorio)

AutomationRuleModifyPropertiesAction

Name Description Value
actionConfiguration IncidentPropertiesAction
actionType Tipo dell'azione della regola di automazione. 'ModifyProperties' (obbligatorio)

AutomationRuleProperties

Name Description Value
actions Azioni da eseguire quando viene attivata la regola di automazione. AutomationRuleAction[] (obbligatorio)
displayName Nome visualizzato della regola di automazione. string

Constraints:
Lunghezza massima = 500 (obbligatorio)
order Ordine di esecuzione della regola di automazione. int

Constraints:
Valore minimo = 1
Valore massimo = 1000 (obbligatorio)
triggeringLogic Descrive la logica di attivazione delle regole di automazione. AutomationRuleTriggeringLogic (obbligatorio)

AutomationRulePropertyArrayChangedValuesCondition

Name Description Value
arrayType 'Alerts'
'Comments'
'Labels'
'Tactics'
changeType 'Added'

AutomationRulePropertyArrayValuesCondition

Name Description Value
arrayConditionType Descrive un tipo di valutazione della condizione di matrice. 'AnyItem'
arrayType Descrive un tipo di matrice valutato in una condizione di matrice. 'CustomDetails'
'CustomDetailValues'
itemConditions AutomationRuleCondition[]

AutomationRulePropertyValuesChangedCondition

Name Description Value
changeType 'ChangedFrom'
'ChangedTo'
operator 'Contains'
'EndsWith'
'Equals'
'NotContains'
'NotEndsWith'
'NotEquals'
'NotStartsWith'
'StartsWith'
propertyName 'IncidentOwner'
'IncidentSeverity'
'IncidentStatus'
propertyValues string[]

AutomationRulePropertyValuesCondition

Name Description Value
operator 'Contains'
'EndsWith'
'Equals'
'NotContains'
'NotEndsWith'
'NotEquals'
'NotStartsWith'
'StartsWith'
propertyName Proprietà da valutare in una condizione di proprietà della regola di automazione. 'AccountAadTenantId'
'AccountAadUserId'
'AccountName'
'AccountNTDomain'
'AccountObjectGuid'
'AccountPUID'
'AccountSid'
'AccountUPNSuffix'
'AlertAnalyticRuleIds'
'AlertProductNames'
'AzureResourceResourceId'
'AzureResourceSubscriptionId'
'CloudApplicationAppId'
'CloudApplicationAppName'
'DNSDomainName'
'FileDirectory'
'FileHashValue'
'FileName'
'HostAzureID'
'HostName'
'HostNetBiosName'
'HostNTDomain'
'HostOSVersion'
'IncidentCustomDetailsKey'
'IncidentCustomDetailsValue'
'IncidentDescription'
'IncidentLabel'
'IncidentProviderName'
'IncidentRelatedAnalyticRuleIds'
'IncidentSeverity'
'IncidentStatus'
'IncidentTactics'
'IncidentTitle'
'IncidentUpdatedBySource'
'IoTDeviceId'
'IoTDeviceModel'
'IoTDeviceName'
'IoTDeviceOperatingSystem'
'IoTDeviceType'
'IoTDeviceVendor'
'IPAddress'
'MailboxDisplayName'
'MailboxPrimaryAddress'
'MailboxUPN'
'MailMessageDeliveryAction'
'MailMessageDeliveryLocation'
'MailMessageP1Sender'
'MailMessageP2Sender'
'MailMessageRecipient'
'MailMessageSenderIP'
'MailMessageSubject'
'MalwareCategory'
'MalwareName'
'ProcessCommandLine'
'ProcessId'
'RegistryKey'
'RegistryValueData'
'Url'
propertyValues string[]

AutomationRuleRunPlaybookAction

Name Description Value
actionConfiguration PlaybookActionProperties
actionType Tipo dell'azione della regola di automazione. 'RunPlaybook' (obbligatorio)

AutomationRuleTriggeringLogic

Name Description Value
conditions Condizioni da valutare per determinare se la regola di automazione deve essere attivata in un determinato oggetto. AutomationRuleCondition[]
expirationTimeUtc Determina quando la regola di automazione deve scadere e essere disabilitata automaticamente. string
isEnabled Determina se la regola di automazione è abilitata o disabilitata. bool (obbligatorio)
triggersOn 'Alerts'
'Incidenti' (obbligatorio)
triggersWhen 'Created'
'Aggiornato' (obbligatorio)

BooleanConditionProperties

Name Description Value
conditionProperties Descrive una condizione della regola di automazione con operatori booleani. AutomationRuleBooleanCondition
conditionType 'Booleano' (obbligatorio)

IncidentLabel

Name Description Value
labelName Nome dell'etichetta stringa (obbligatorio)

IncidentOwnerInfo

Name Description Value
assignedTo Nome dell'utente a cui viene assegnato l'evento imprevisto. string
email Il messaggio di posta elettronica dell'utente a cui viene assegnato l'evento imprevisto. string
objectId ID oggetto dell'utente a cui viene assegnato l'evento imprevisto. string

Constraints:
Lunghezza minima = 36
Lunghezza massima = 36
Modello = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
ownerType Tipo di proprietario a cui viene assegnato l'evento imprevisto. 'Group'
'Unknown'
'User'
userPrincipalName Nome dell'entità utente dell'utente a cui viene assegnato l'evento imprevisto. string

IncidentPropertiesAction

Name Description Value
classification Il motivo per cui l'evento imprevisto è stato chiuso 'BenignPositive'
'FalsePositive'
'TruePositive'
'Undetermined'
classificationComment Descrive il motivo per cui l'evento imprevisto è stato chiuso. string
classificationReason Motivo della classificazione con cui l'evento imprevisto è stato chiuso 'InaccurateData'
'IncorrectAlertLogic'
'SuspiciousActivity'
'SuspiciousButExpected'
labels Elenco di etichette da aggiungere all'evento imprevisto. IncidentLabel[]
owner Le informazioni sull'utente a cui viene assegnato un evento imprevisto IncidentOwnerInfo
severity Gravità dell'evento imprevisto 'High'
'Informational'
'Low'
'Medium'
status Stato dell'evento imprevisto 'Active'
'Closed'
'New'

PlaybookActionProperties

Name Description Value
logicAppResourceId ID risorsa della risorsa playbook. stringa (obbligatorio)
tenantId ID tenant della risorsa del playbook. string

Constraints:
Lunghezza minima = 36
Lunghezza massima = 36
Modello = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

PropertyArrayChangedConditionProperties

Name Description Value
conditionProperties AutomationRulePropertyArrayChangedValuesCondition
conditionType 'PropertyArrayChanged' (obbligatorio)

PropertyArrayConditionProperties

Name Description Value
conditionProperties Descrive una condizione della regola di automazione sulle proprietà della matrice. AutomationRulePropertyArrayValuesCondition
conditionType 'PropertyArray' (obbligatorio)

PropertyChangedConditionProperties

Name Description Value
conditionProperties AutomationRulePropertyValuesChangedCondition
conditionType 'PropertyChanged' (obbligatorio)

PropertyConditionProperties

Name Description Value
conditionProperties AutomationRulePropertyValuesCondition
conditionType 'Proprietà' (obbligatorio)

Esempi di utilizzo

Esempi bicep

Un esempio di base di distribuzione della regola di automazione Sentinel.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource automationRule 'Microsoft.SecurityInsights/automationRules@2022-10-01-preview' = {
  scope: workspace
  name: '3b862818-ad7b-409e-83be-8812f2a06d37'
  properties: {
    actions: [
      {
        actionConfiguration: {
          classification: ''
          classificationComment: ''
          classificationReason: ''
          severity: ''
          status: 'Active'
        }
        actionType: 'ModifyProperties'
        order: 1
      }
    ]
    displayName: 'acctest-SentinelAutoRule-230630033910945846'
    order: 1
    triggeringLogic: {
      isEnabled: true
      triggersOn: 'Incidents'
      triggersWhen: 'Created'
    }
  }
  dependsOn: [
    onboardingState
  ]
}

resource onboardingState 'Microsoft.SecurityInsights/onboardingStates@2023-06-01-preview' = {
  scope: workspace
  name: 'default'
  properties: {
    customerManagedKey: false
  }
}

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
    }
  }
}

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa automationRules può essere distribuito con operazioni destinate a:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato delle risorse

Per creare una risorsa Microsoft.SecurityInsights/automationRules, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.SecurityInsights/automationRules",
  "apiVersion": "2025-03-01",
  "name": "string",
  "etag": "string",
  "properties": {
    "actions": [ {
      "order": "int",
      "actionType": "string"
      // For remaining properties, see AutomationRuleAction objects
    } ],
    "displayName": "string",
    "order": "int",
    "triggeringLogic": {
      "conditions": [ {
        "conditionType": "string"
        // For remaining properties, see AutomationRuleCondition objects
      } ],
      "expirationTimeUtc": "string",
      "isEnabled": "bool",
      "triggersOn": "string",
      "triggersWhen": "string"
    }
  }
}

Oggetti AutomationRuleAction

Impostare la proprietà actionType per specificare il tipo di oggetto.

Per AddIncidentTask, usare:

{
  "actionConfiguration": {
    "description": "string",
    "title": "string"
  },
  "actionType": "AddIncidentTask"
}

Per ModifyProperties, usare:

{
  "actionConfiguration": {
    "classification": "string",
    "classificationComment": "string",
    "classificationReason": "string",
    "labels": [
      {
        "labelName": "string"
      }
    ],
    "owner": {
      "assignedTo": "string",
      "email": "string",
      "objectId": "string",
      "ownerType": "string",
      "userPrincipalName": "string"
    },
    "severity": "string",
    "status": "string"
  },
  "actionType": "ModifyProperties"
}

Per RunPlaybook, usare:

{
  "actionConfiguration": {
    "logicAppResourceId": "string",
    "tenantId": "string"
  },
  "actionType": "RunPlaybook"
}

Oggetti AutomationRuleCondition

Impostare la proprietà conditionType per specificare il tipo di oggetto.

Per booleano, usare:

{
  "conditionProperties": {
    "innerConditions": [ {
      "conditionType": "string"
      // For remaining properties, see AutomationRuleCondition objects
    } ],
    "operator": "string"
  },
  "conditionType": "Boolean"
}

Per Proprietà, usare:

{
  "conditionProperties": {
    "operator": "string",
    "propertyName": "string",
    "propertyValues": [ "string" ]
  },
  "conditionType": "Property"
}

Per PropertyArray, usare:

{
  "conditionProperties": {
    "arrayConditionType": "string",
    "arrayType": "string",
    "itemConditions": [ {
      "conditionType": "string"
      // For remaining properties, see AutomationRuleCondition objects
    } ]
  },
  "conditionType": "PropertyArray"
}

Per PropertyArrayChanged, usare:

{
  "conditionProperties": {
    "arrayType": "string",
    "changeType": "string"
  },
  "conditionType": "PropertyArrayChanged"
}

Per PropertyChanged, usare:

{
  "conditionProperties": {
    "changeType": "string",
    "operator": "string",
    "propertyName": "string",
    "propertyValues": [ "string" ]
  },
  "conditionType": "PropertyChanged"
}

Valori delle proprietà

Microsoft.SecurityInsights/automationRules

Name Description Value
apiVersion Versione dell'API '2025-03-01'
etag Etag della risorsa di Azure string
name Nome della risorsa stringa (obbligatorio)
properties Proprietà delle regole di automazione AutomationRuleProperties (obbligatorio)
type Tipo di risorsa 'Microsoft.SecurityInsights/automationRules'

AddIncidentTaskActionProperties

Name Description Value
description Descrizione dell'attività. string
title Titolo dell'attività. stringa (obbligatorio)

AutomationRuleAction

Name Description Value
actionType Impostare su 'AddIncidentTask' per il tipo AutomationRuleAddIncidentTaskAction. Impostare su 'ModifyProperties' per il tipo AutomationRuleModifyPropertiesAction. Impostare su "RunPlaybook" per il tipo AutomationRuleRunPlaybookAction. 'AddIncidentTask'
'ModifyProperties'
'RunPlaybook' (obbligatorio)
order int (obbligatorio)

AutomationRuleAddIncidentTaskAction

Name Description Value
actionConfiguration Descrive un'azione della regola di automazione per aggiungere un'attività a un evento imprevisto. AddIncidentTaskActionProperties
actionType Tipo dell'azione della regola di automazione. 'AddIncidentTask' (obbligatorio)

AutomationRuleBooleanCondition

Name Description Value
innerConditions AutomationRuleCondition[]
operator Descrive un operatore di condizione booleano. 'And'
'Or'

AutomationRuleCondition

Name Description Value
conditionType Impostare su 'Boolean' per il tipo BooleanConditionProperties. Impostare su 'Property' per il tipo PropertyConditionProperties. Impostare su 'PropertyArray' per il tipo PropertyArrayConditionProperties. Impostare su 'PropertyArrayChanged' per il tipo PropertyArrayChangedConditionProperties. Impostare su 'PropertyChanged' per il tipo PropertyChangedConditionProperties. 'Boolean'
'Property'
'PropertyArray'
'PropertyArrayChanged'
'PropertyChanged' (obbligatorio)

AutomationRuleModifyPropertiesAction

Name Description Value
actionConfiguration IncidentPropertiesAction
actionType Tipo dell'azione della regola di automazione. 'ModifyProperties' (obbligatorio)

AutomationRuleProperties

Name Description Value
actions Azioni da eseguire quando viene attivata la regola di automazione. AutomationRuleAction[] (obbligatorio)
displayName Nome visualizzato della regola di automazione. string

Constraints:
Lunghezza massima = 500 (obbligatorio)
order Ordine di esecuzione della regola di automazione. int

Constraints:
Valore minimo = 1
Valore massimo = 1000 (obbligatorio)
triggeringLogic Descrive la logica di attivazione delle regole di automazione. AutomationRuleTriggeringLogic (obbligatorio)

AutomationRulePropertyArrayChangedValuesCondition

Name Description Value
arrayType 'Alerts'
'Comments'
'Labels'
'Tactics'
changeType 'Added'

AutomationRulePropertyArrayValuesCondition

Name Description Value
arrayConditionType Descrive un tipo di valutazione della condizione di matrice. 'AnyItem'
arrayType Descrive un tipo di matrice valutato in una condizione di matrice. 'CustomDetails'
'CustomDetailValues'
itemConditions AutomationRuleCondition[]

AutomationRulePropertyValuesChangedCondition

Name Description Value
changeType 'ChangedFrom'
'ChangedTo'
operator 'Contains'
'EndsWith'
'Equals'
'NotContains'
'NotEndsWith'
'NotEquals'
'NotStartsWith'
'StartsWith'
propertyName 'IncidentOwner'
'IncidentSeverity'
'IncidentStatus'
propertyValues string[]

AutomationRulePropertyValuesCondition

Name Description Value
operator 'Contains'
'EndsWith'
'Equals'
'NotContains'
'NotEndsWith'
'NotEquals'
'NotStartsWith'
'StartsWith'
propertyName Proprietà da valutare in una condizione di proprietà della regola di automazione. 'AccountAadTenantId'
'AccountAadUserId'
'AccountName'
'AccountNTDomain'
'AccountObjectGuid'
'AccountPUID'
'AccountSid'
'AccountUPNSuffix'
'AlertAnalyticRuleIds'
'AlertProductNames'
'AzureResourceResourceId'
'AzureResourceSubscriptionId'
'CloudApplicationAppId'
'CloudApplicationAppName'
'DNSDomainName'
'FileDirectory'
'FileHashValue'
'FileName'
'HostAzureID'
'HostName'
'HostNetBiosName'
'HostNTDomain'
'HostOSVersion'
'IncidentCustomDetailsKey'
'IncidentCustomDetailsValue'
'IncidentDescription'
'IncidentLabel'
'IncidentProviderName'
'IncidentRelatedAnalyticRuleIds'
'IncidentSeverity'
'IncidentStatus'
'IncidentTactics'
'IncidentTitle'
'IncidentUpdatedBySource'
'IoTDeviceId'
'IoTDeviceModel'
'IoTDeviceName'
'IoTDeviceOperatingSystem'
'IoTDeviceType'
'IoTDeviceVendor'
'IPAddress'
'MailboxDisplayName'
'MailboxPrimaryAddress'
'MailboxUPN'
'MailMessageDeliveryAction'
'MailMessageDeliveryLocation'
'MailMessageP1Sender'
'MailMessageP2Sender'
'MailMessageRecipient'
'MailMessageSenderIP'
'MailMessageSubject'
'MalwareCategory'
'MalwareName'
'ProcessCommandLine'
'ProcessId'
'RegistryKey'
'RegistryValueData'
'Url'
propertyValues string[]

AutomationRuleRunPlaybookAction

Name Description Value
actionConfiguration PlaybookActionProperties
actionType Tipo dell'azione della regola di automazione. 'RunPlaybook' (obbligatorio)

AutomationRuleTriggeringLogic

Name Description Value
conditions Condizioni da valutare per determinare se la regola di automazione deve essere attivata in un determinato oggetto. AutomationRuleCondition[]
expirationTimeUtc Determina quando la regola di automazione deve scadere e essere disabilitata automaticamente. string
isEnabled Determina se la regola di automazione è abilitata o disabilitata. bool (obbligatorio)
triggersOn 'Alerts'
'Incidenti' (obbligatorio)
triggersWhen 'Created'
'Aggiornato' (obbligatorio)

BooleanConditionProperties

Name Description Value
conditionProperties Descrive una condizione della regola di automazione con operatori booleani. AutomationRuleBooleanCondition
conditionType 'Booleano' (obbligatorio)

IncidentLabel

Name Description Value
labelName Nome dell'etichetta stringa (obbligatorio)

IncidentOwnerInfo

Name Description Value
assignedTo Nome dell'utente a cui viene assegnato l'evento imprevisto. string
email Il messaggio di posta elettronica dell'utente a cui viene assegnato l'evento imprevisto. string
objectId ID oggetto dell'utente a cui viene assegnato l'evento imprevisto. string

Constraints:
Lunghezza minima = 36
Lunghezza massima = 36
Modello = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
ownerType Tipo di proprietario a cui viene assegnato l'evento imprevisto. 'Group'
'Unknown'
'User'
userPrincipalName Nome dell'entità utente dell'utente a cui viene assegnato l'evento imprevisto. string

IncidentPropertiesAction

Name Description Value
classification Il motivo per cui l'evento imprevisto è stato chiuso 'BenignPositive'
'FalsePositive'
'TruePositive'
'Undetermined'
classificationComment Descrive il motivo per cui l'evento imprevisto è stato chiuso. string
classificationReason Motivo della classificazione con cui l'evento imprevisto è stato chiuso 'InaccurateData'
'IncorrectAlertLogic'
'SuspiciousActivity'
'SuspiciousButExpected'
labels Elenco di etichette da aggiungere all'evento imprevisto. IncidentLabel[]
owner Le informazioni sull'utente a cui viene assegnato un evento imprevisto IncidentOwnerInfo
severity Gravità dell'evento imprevisto 'High'
'Informational'
'Low'
'Medium'
status Stato dell'evento imprevisto 'Active'
'Closed'
'New'

PlaybookActionProperties

Name Description Value
logicAppResourceId ID risorsa della risorsa playbook. stringa (obbligatorio)
tenantId ID tenant della risorsa del playbook. string

Constraints:
Lunghezza minima = 36
Lunghezza massima = 36
Modello = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

PropertyArrayChangedConditionProperties

Name Description Value
conditionProperties AutomationRulePropertyArrayChangedValuesCondition
conditionType 'PropertyArrayChanged' (obbligatorio)

PropertyArrayConditionProperties

Name Description Value
conditionProperties Descrive una condizione della regola di automazione sulle proprietà della matrice. AutomationRulePropertyArrayValuesCondition
conditionType 'PropertyArray' (obbligatorio)

PropertyChangedConditionProperties

Name Description Value
conditionProperties AutomationRulePropertyValuesChangedCondition
conditionType 'PropertyChanged' (obbligatorio)

PropertyConditionProperties

Name Description Value
conditionProperties AutomationRulePropertyValuesCondition
conditionType 'Proprietà' (obbligatorio)

Esempi di utilizzo

Modelli di avvio rapido di Azure

I modelli di avvio rapido di Azure seguenti distribuire questo tipo di risorsa.

Template Description
Crea una nuova regola di automazione di Microsoft Sentinel

Distribuire in Azure
Questo esempio illustra come creare una nuova regola di automazione in Microsoft Sentinel

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa automationRules può essere distribuito con operazioni destinate a:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato delle risorse

Per creare una risorsa Microsoft.SecurityInsights/automationRules, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.SecurityInsights/automationRules@2025-03-01"
  name = "string"
  parent_id = "string"
  body = {
    etag = "string"
    properties = {
      actions = [
        {
          order = int
          actionType = "string"
          // For remaining properties, see AutomationRuleAction objects
        }
      ]
      displayName = "string"
      order = int
      triggeringLogic = {
        conditions = [
          {
            conditionType = "string"
            // For remaining properties, see AutomationRuleCondition objects
          }
        ]
        expirationTimeUtc = "string"
        isEnabled = bool
        triggersOn = "string"
        triggersWhen = "string"
      }
    }
  }
}

Oggetti AutomationRuleAction

Impostare la proprietà actionType per specificare il tipo di oggetto.

Per AddIncidentTask, usare:

{
  actionConfiguration = {
    description = "string"
    title = "string"
  }
  actionType = "AddIncidentTask"
}

Per ModifyProperties, usare:

{
  actionConfiguration = {
    classification = "string"
    classificationComment = "string"
    classificationReason = "string"
    labels = [
      {
        labelName = "string"
      }
    ]
    owner = {
      assignedTo = "string"
      email = "string"
      objectId = "string"
      ownerType = "string"
      userPrincipalName = "string"
    }
    severity = "string"
    status = "string"
  }
  actionType = "ModifyProperties"
}

Per RunPlaybook, usare:

{
  actionConfiguration = {
    logicAppResourceId = "string"
    tenantId = "string"
  }
  actionType = "RunPlaybook"
}

Oggetti AutomationRuleCondition

Impostare la proprietà conditionType per specificare il tipo di oggetto.

Per booleano, usare:

{
  conditionProperties = {
    innerConditions = [
      {
        conditionType = "string"
        // For remaining properties, see AutomationRuleCondition objects
      }
    ]
    operator = "string"
  }
  conditionType = "Boolean"
}

Per Proprietà, usare:

{
  conditionProperties = {
    operator = "string"
    propertyName = "string"
    propertyValues = [
      "string"
    ]
  }
  conditionType = "Property"
}

Per PropertyArray, usare:

{
  conditionProperties = {
    arrayConditionType = "string"
    arrayType = "string"
    itemConditions = [
      {
        conditionType = "string"
        // For remaining properties, see AutomationRuleCondition objects
      }
    ]
  }
  conditionType = "PropertyArray"
}

Per PropertyArrayChanged, usare:

{
  conditionProperties = {
    arrayType = "string"
    changeType = "string"
  }
  conditionType = "PropertyArrayChanged"
}

Per PropertyChanged, usare:

{
  conditionProperties = {
    changeType = "string"
    operator = "string"
    propertyName = "string"
    propertyValues = [
      "string"
    ]
  }
  conditionType = "PropertyChanged"
}

Valori delle proprietà

Microsoft.SecurityInsights/automationRules

Name Description Value
etag Etag della risorsa di Azure string
name Nome della risorsa stringa (obbligatorio)
parent_id ID della risorsa a cui applicare la risorsa di estensione. stringa (obbligatorio)
properties Proprietà delle regole di automazione AutomationRuleProperties (obbligatorio)
type Tipo di risorsa "Microsoft.SecurityInsights/automationRules@2025-03-01"

AddIncidentTaskActionProperties

Name Description Value
description Descrizione dell'attività. string
title Titolo dell'attività. stringa (obbligatorio)

AutomationRuleAction

Name Description Value
actionType Impostare su 'AddIncidentTask' per il tipo AutomationRuleAddIncidentTaskAction. Impostare su 'ModifyProperties' per il tipo AutomationRuleModifyPropertiesAction. Impostare su "RunPlaybook" per il tipo AutomationRuleRunPlaybookAction. 'AddIncidentTask'
'ModifyProperties'
'RunPlaybook' (obbligatorio)
order int (obbligatorio)

AutomationRuleAddIncidentTaskAction

Name Description Value
actionConfiguration Descrive un'azione della regola di automazione per aggiungere un'attività a un evento imprevisto. AddIncidentTaskActionProperties
actionType Tipo dell'azione della regola di automazione. 'AddIncidentTask' (obbligatorio)

AutomationRuleBooleanCondition

Name Description Value
innerConditions AutomationRuleCondition[]
operator Descrive un operatore di condizione booleano. 'And'
'Or'

AutomationRuleCondition

Name Description Value
conditionType Impostare su 'Boolean' per il tipo BooleanConditionProperties. Impostare su 'Property' per il tipo PropertyConditionProperties. Impostare su 'PropertyArray' per il tipo PropertyArrayConditionProperties. Impostare su 'PropertyArrayChanged' per il tipo PropertyArrayChangedConditionProperties. Impostare su 'PropertyChanged' per il tipo PropertyChangedConditionProperties. 'Boolean'
'Property'
'PropertyArray'
'PropertyArrayChanged'
'PropertyChanged' (obbligatorio)

AutomationRuleModifyPropertiesAction

Name Description Value
actionConfiguration IncidentPropertiesAction
actionType Tipo dell'azione della regola di automazione. 'ModifyProperties' (obbligatorio)

AutomationRuleProperties

Name Description Value
actions Azioni da eseguire quando viene attivata la regola di automazione. AutomationRuleAction[] (obbligatorio)
displayName Nome visualizzato della regola di automazione. string

Constraints:
Lunghezza massima = 500 (obbligatorio)
order Ordine di esecuzione della regola di automazione. int

Constraints:
Valore minimo = 1
Valore massimo = 1000 (obbligatorio)
triggeringLogic Descrive la logica di attivazione delle regole di automazione. AutomationRuleTriggeringLogic (obbligatorio)

AutomationRulePropertyArrayChangedValuesCondition

Name Description Value
arrayType 'Alerts'
'Comments'
'Labels'
'Tactics'
changeType 'Added'

AutomationRulePropertyArrayValuesCondition

Name Description Value
arrayConditionType Descrive un tipo di valutazione della condizione di matrice. 'AnyItem'
arrayType Descrive un tipo di matrice valutato in una condizione di matrice. 'CustomDetails'
'CustomDetailValues'
itemConditions AutomationRuleCondition[]

AutomationRulePropertyValuesChangedCondition

Name Description Value
changeType 'ChangedFrom'
'ChangedTo'
operator 'Contains'
'EndsWith'
'Equals'
'NotContains'
'NotEndsWith'
'NotEquals'
'NotStartsWith'
'StartsWith'
propertyName 'IncidentOwner'
'IncidentSeverity'
'IncidentStatus'
propertyValues string[]

AutomationRulePropertyValuesCondition

Name Description Value
operator 'Contains'
'EndsWith'
'Equals'
'NotContains'
'NotEndsWith'
'NotEquals'
'NotStartsWith'
'StartsWith'
propertyName Proprietà da valutare in una condizione di proprietà della regola di automazione. 'AccountAadTenantId'
'AccountAadUserId'
'AccountName'
'AccountNTDomain'
'AccountObjectGuid'
'AccountPUID'
'AccountSid'
'AccountUPNSuffix'
'AlertAnalyticRuleIds'
'AlertProductNames'
'AzureResourceResourceId'
'AzureResourceSubscriptionId'
'CloudApplicationAppId'
'CloudApplicationAppName'
'DNSDomainName'
'FileDirectory'
'FileHashValue'
'FileName'
'HostAzureID'
'HostName'
'HostNetBiosName'
'HostNTDomain'
'HostOSVersion'
'IncidentCustomDetailsKey'
'IncidentCustomDetailsValue'
'IncidentDescription'
'IncidentLabel'
'IncidentProviderName'
'IncidentRelatedAnalyticRuleIds'
'IncidentSeverity'
'IncidentStatus'
'IncidentTactics'
'IncidentTitle'
'IncidentUpdatedBySource'
'IoTDeviceId'
'IoTDeviceModel'
'IoTDeviceName'
'IoTDeviceOperatingSystem'
'IoTDeviceType'
'IoTDeviceVendor'
'IPAddress'
'MailboxDisplayName'
'MailboxPrimaryAddress'
'MailboxUPN'
'MailMessageDeliveryAction'
'MailMessageDeliveryLocation'
'MailMessageP1Sender'
'MailMessageP2Sender'
'MailMessageRecipient'
'MailMessageSenderIP'
'MailMessageSubject'
'MalwareCategory'
'MalwareName'
'ProcessCommandLine'
'ProcessId'
'RegistryKey'
'RegistryValueData'
'Url'
propertyValues string[]

AutomationRuleRunPlaybookAction

Name Description Value
actionConfiguration PlaybookActionProperties
actionType Tipo dell'azione della regola di automazione. 'RunPlaybook' (obbligatorio)

AutomationRuleTriggeringLogic

Name Description Value
conditions Condizioni da valutare per determinare se la regola di automazione deve essere attivata in un determinato oggetto. AutomationRuleCondition[]
expirationTimeUtc Determina quando la regola di automazione deve scadere e essere disabilitata automaticamente. string
isEnabled Determina se la regola di automazione è abilitata o disabilitata. bool (obbligatorio)
triggersOn 'Alerts'
'Incidenti' (obbligatorio)
triggersWhen 'Created'
'Aggiornato' (obbligatorio)

BooleanConditionProperties

Name Description Value
conditionProperties Descrive una condizione della regola di automazione con operatori booleani. AutomationRuleBooleanCondition
conditionType 'Booleano' (obbligatorio)

IncidentLabel

Name Description Value
labelName Nome dell'etichetta stringa (obbligatorio)

IncidentOwnerInfo

Name Description Value
assignedTo Nome dell'utente a cui viene assegnato l'evento imprevisto. string
email Il messaggio di posta elettronica dell'utente a cui viene assegnato l'evento imprevisto. string
objectId ID oggetto dell'utente a cui viene assegnato l'evento imprevisto. string

Constraints:
Lunghezza minima = 36
Lunghezza massima = 36
Modello = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
ownerType Tipo di proprietario a cui viene assegnato l'evento imprevisto. 'Group'
'Unknown'
'User'
userPrincipalName Nome dell'entità utente dell'utente a cui viene assegnato l'evento imprevisto. string

IncidentPropertiesAction

Name Description Value
classification Il motivo per cui l'evento imprevisto è stato chiuso 'BenignPositive'
'FalsePositive'
'TruePositive'
'Undetermined'
classificationComment Descrive il motivo per cui l'evento imprevisto è stato chiuso. string
classificationReason Motivo della classificazione con cui l'evento imprevisto è stato chiuso 'InaccurateData'
'IncorrectAlertLogic'
'SuspiciousActivity'
'SuspiciousButExpected'
labels Elenco di etichette da aggiungere all'evento imprevisto. IncidentLabel[]
owner Le informazioni sull'utente a cui viene assegnato un evento imprevisto IncidentOwnerInfo
severity Gravità dell'evento imprevisto 'High'
'Informational'
'Low'
'Medium'
status Stato dell'evento imprevisto 'Active'
'Closed'
'New'

PlaybookActionProperties

Name Description Value
logicAppResourceId ID risorsa della risorsa playbook. stringa (obbligatorio)
tenantId ID tenant della risorsa del playbook. string

Constraints:
Lunghezza minima = 36
Lunghezza massima = 36
Modello = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$

PropertyArrayChangedConditionProperties

Name Description Value
conditionProperties AutomationRulePropertyArrayChangedValuesCondition
conditionType 'PropertyArrayChanged' (obbligatorio)

PropertyArrayConditionProperties

Name Description Value
conditionProperties Descrive una condizione della regola di automazione sulle proprietà della matrice. AutomationRulePropertyArrayValuesCondition
conditionType 'PropertyArray' (obbligatorio)

PropertyChangedConditionProperties

Name Description Value
conditionProperties AutomationRulePropertyValuesChangedCondition
conditionType 'PropertyChanged' (obbligatorio)

PropertyConditionProperties

Name Description Value
conditionProperties AutomationRulePropertyValuesCondition
conditionType 'Proprietà' (obbligatorio)

Esempi di utilizzo

Esempi di Terraform

Un esempio di base di distribuzione della regola di automazione Sentinel.

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" "automationRule" {
  type      = "Microsoft.SecurityInsights/automationRules@2022-10-01-preview"
  parent_id = azapi_resource.workspace.id
  name      = "3b862818-ad7b-409e-83be-8812f2a06d37"
  body = {
    properties = {
      actions = [
        {
          actionConfiguration = {
            classification        = ""
            classificationComment = ""
            classificationReason  = ""
            severity              = ""
            status                = "Active"
          }
          actionType = "ModifyProperties"
          order      = 1
        },
      ]
      displayName = "acctest-SentinelAutoRule-230630033910945846"
      order       = 1
      triggeringLogic = {
        isEnabled    = true
        triggersOn   = "Incidents"
        triggersWhen = "Created"
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
  depends_on                = [azapi_resource.onboardingState]
}