Megosztás a következőn keresztül:


Automations - Update

biztonsági automatizálás Frissítések

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/automations/{automationName}?api-version=2023-12-01-preview

URI-paraméterek

Name In Kötelező Típus Description
automationName
path True

string

A biztonsági automatizálás neve.

resourceGroupName
path True

string

A felhasználó előfizetésében található erőforráscsoport neve. A név megkülönbözteti a kis- és nagybetűket.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Azure-előfizetés azonosítója

Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version
query True

string

A művelet API-verziója

Kérelem törzse

Name Típus Description
properties.actions AutomationAction[]:

Azoknak a műveleteknek a gyűjteménye, amelyek akkor aktiválódnak, ha a konfigurált szabályok kiértékelése legalább egy szabálykészleten belül igaz.

properties.description

string

A biztonsági automatizálás leírása.

properties.isEnabled

boolean

Azt jelzi, hogy a biztonsági automatizálás engedélyezve van-e.

properties.scopes

AutomationScope[]

Hatókörök gyűjteménye, amelyre a biztonsági automatizálási logika alkalmazva van. A támogatott hatókörök maguk az előfizetések vagy az előfizetéshez tartozó erőforráscsoportok. Az automatizálás csak meghatározott hatókörökre vonatkozik.

properties.sources

AutomationSource[]

A forrásesemény-típusok gyűjteménye, amely kiértékeli a biztonsági automatizálási szabályok készletét.

tags

object

Az erőforrást leíró kulcsértékpárok listája.

Válaszok

Name Típus Description
200 OK

Automation

OK

Other Status Codes

CloudError

Hibaválasz, amely leírja, hogy miért meghiúsult a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation felhasználói fiók megszemélyesítése

Példák

Update a security automation

Sample Request

PATCH https://management.azure.com/subscriptions/a5caac9c-5c04-49af-b3d0-e204f40345d5/resourceGroups/exampleResourceGroup/providers/Microsoft.Security/automations/exampleAutomation?api-version=2023-12-01-preview

{
  "tags": {
    "Example": "exampleTag"
  },
  "properties": {
    "description": "An example of a security automation that triggers one LogicApp resource (myTest1) on any security assessment",
    "scopes": [
      {
        "description": "A description that helps to identify this scope - for example: security assessments that relate to the resource group myResourceGroup within the subscription a5caac9c-5c04-49af-b3d0-e204f40345d5",
        "scopePath": "/subscriptions/a5caac9c-5c04-49af-b3d0-e204f40345d5/resourceGroups/myResourceGroup"
      }
    ],
    "sources": [
      {
        "eventSource": "Assessments"
      }
    ],
    "actions": [
      {
        "logicAppResourceId": "/subscriptions/e54a4a18-5b94-4f90-9471-bd3decad8a2e/resourceGroups/sample/providers/Microsoft.Logic/workflows/MyTest1",
        "actionType": "LogicApp",
        "uri": "https://exampleTriggerUri1.com"
      }
    ]
  }
}

Sample Response

{
  "id": "/subscriptions/a5caac9c-5c04-49af-b3d0-e204f40345d5/resourceGroups/exampleResourceGroup/providers/Microsoft.Security/automations/exampleAutomation",
  "name": "exampleAutomation",
  "type": "Microsoft.Security/automations",
  "location": "Central US",
  "etag": "new etag value",
  "tags": {},
  "properties": {
    "description": "An example of a security automation that triggers one LogicApp resource (myTest1) on any security assessment",
    "isEnabled": true,
    "scopes": [
      {
        "description": "A description that helps to identify this scope - for example: security assessments that relate to the resource group myResourceGroup within the subscription a5caac9c-5c04-49af-b3d0-e204f40345d5",
        "scopePath": "/subscriptions/a5caac9c-5c04-49af-b3d0-e204f40345d5/resourceGroups/myResourceGroup"
      }
    ],
    "sources": [
      {
        "eventSource": "Assessments",
        "ruleSets": []
      }
    ],
    "actions": [
      {
        "logicAppResourceId": "/subscriptions/e54a4a18-5b94-4f90-9471-bd3decad8a2e/resourceGroups/sample/providers/Microsoft.Logic/workflows/MyTest1",
        "actionType": "LogicApp"
      }
    ]
  }
}

Definíciók

Name Description
Automation

A biztonsági automatizálási erőforrás.

AutomationActionEventHub

A cél eseményközpont, amelybe az eseményadatokat exportálni fogja. Ha többet szeretne megtudni a felhőbeli folyamatos exportálási képességek Microsoft Defender, látogasson el ahttps://aka.ms/ASCExportLearnMore

AutomationActionLogicApp

A logikai alkalmazás aktiválandó művelete. Ha többet szeretne megtudni a felhő munkafolyamat-automatizálási képességeinek Microsoft Defender, látogasson el ahttps://aka.ms/ASCWorkflowAutomationLearnMore

AutomationActionWorkspace

Az a Log Analytics-munkaterület, amelybe az eseményadatokat exportálni fogja. A biztonsági riasztások adatai a "SecurityAlert" táblában, az értékelések adatai pedig a "SecurityRecommendation" táblában (a "Security"/"SecurityCenterFree" megoldások alatt) találhatók. Vegye figyelembe, hogy a munkaterületen lévő adatok megtekintéséhez engedélyezni kell a Security Center Log Analytics ingyenes/standard megoldását az adott munkaterületen. Ha többet szeretne megtudni a felhőbeli folyamatos exportálási képességek Microsoft Defender, látogasson el ahttps://aka.ms/ASCExportLearnMore

AutomationRuleSet

Egy szabálykészlet, amely kiértékeli az összes szabályt egy esemény elfogásakor. Az esemény csak akkor aktiválja a definiált műveleteket, ha a szabálykészlet összes belefoglalt szabályát "true" értékre értékeli a rendszer.

AutomationScope

Egyetlen automatizálási hatókör.

AutomationSource

A forrásesemény-típusok, amelyek kiértékelik a biztonsági automatizálási szabályok készletét. Például biztonsági riasztások és biztonsági értékelések. Ha többet szeretne megtudni a támogatott biztonsági események adatmodell-sémáiról, látogasson el a webhelyre https://aka.ms/ASCAutomationSchemas.

AutomationTriggeringRule

Egy szabály, amely az esemény elfogásakor lesz kiértékelve. A szabály úgy van konfigurálva, hogy összehasonlít egy adott értéket az eseménymodellből egy várt értékkel. Ezt az összehasonlítást a támogatott operátorok egyikének használatával végezheti el.

AutomationUpdateModel

A biztonsági automatizálási erőforrás frissítési modellje.

CloudError

Az azure Resource Manager API-k gyakori hibaválasza a meghiúsult műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)

CloudErrorBody

A hiba részletei.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

EventSource

Érvényes eseményforrás-típus.

Operator

A használni kívánt érvényes összehasonlító operátor. A sztringtulajdonságtípus esetében a kis- és nagybetűket nem megkülönböztető összehasonlítás lesz alkalmazva.

PropertyType

Az összehasonlított operandusok adattípusa (sztring, egész szám, lebegőpontos szám vagy logikai [igaz/hamis]]

Automation

A biztonsági automatizálási erőforrás.

Name Típus Description
etag

string

Az entitáscímke két vagy több entitás összehasonlítására szolgál ugyanabból a kért erőforrásból.

id

string

Erőforrás-azonosító

kind

string

Az erőforrás típusa

location

string

Az erőforrás tárolási helye

name

string

Erőforrás neve

properties.actions AutomationAction[]:

Azoknak a műveleteknek a gyűjteménye, amelyek akkor aktiválódnak, ha az összes konfigurált szabályértékelés legalább egy szabálykészleten belül igaz.

properties.description

string

A biztonsági automatizálás leírása.

properties.isEnabled

boolean

Azt jelzi, hogy a biztonsági automatizálás engedélyezve van-e.

properties.scopes

AutomationScope[]

Hatókörök gyűjteménye, amelyre a biztonsági automatizálási logika alkalmazva van. A támogatott hatókörök maguk az előfizetések vagy az előfizetéshez tartozó erőforráscsoportok. Az automatizálás csak meghatározott hatókörökre vonatkozik.

properties.sources

AutomationSource[]

A forrásesemény-típusok gyűjteménye, amely kiértékeli a biztonsági automatizálási szabályok készletét.

tags

object

Az erőforrást leíró kulcsértékpárok listája.

type

string

Erőforrás típusa

AutomationActionEventHub

A cél eseményközpont, amelybe az eseményadatokat exportálni fogja. Ha többet szeretne megtudni a felhőbeli folyamatos exportálási képességek Microsoft Defender, látogasson el ahttps://aka.ms/ASCExportLearnMore

Name Típus Description
actionType string:

EventHub

Az Automation által aktivált művelet típusa

connectionString

string

A cél eseményközpont kapcsolati karakterlánc (a válasz nem tartalmazza).

eventHubResourceId

string

A cél Event Hub Azure-erőforrás-azonosítója.

isTrustedServiceEnabled

boolean

Azt jelzi, hogy a megbízható szolgáltatás engedélyezve van-e.

sasPolicyName

string

A cél eseményközpont SAS-szabályzatának neve.

AutomationActionLogicApp

A logikai alkalmazás aktiválandó művelete. Ha többet szeretne megtudni a felhő munkafolyamat-automatizálási képességeinek Microsoft Defender, látogasson el ahttps://aka.ms/ASCWorkflowAutomationLearnMore

Name Típus Description
actionType string:

LogicApp

Az Automation által aktivált művelet típusa

logicAppResourceId

string

Az aktivált Logikai alkalmazás Azure-erőforrás-azonosítója. Ez más előfizetésekben is előfordulhat, mivel rendelkezik a logikai alkalmazás aktiválásához szükséges engedélyekkel

uri

string

A logikai alkalmazás eseményindítójának URI-végpontja (nem fog szerepelni semmilyen válaszban).

AutomationActionWorkspace

Az a Log Analytics-munkaterület, amelybe az eseményadatokat exportálni fogja. A biztonsági riasztások adatai a "SecurityAlert" táblában, az értékelések adatai pedig a "SecurityRecommendation" táblában (a "Security"/"SecurityCenterFree" megoldások alatt) találhatók. Vegye figyelembe, hogy a munkaterületen lévő adatok megtekintéséhez engedélyezni kell a Security Center Log Analytics ingyenes/standard megoldását az adott munkaterületen. Ha többet szeretne megtudni a felhőbeli folyamatos exportálási képességek Microsoft Defender, látogasson el ahttps://aka.ms/ASCExportLearnMore

Name Típus Description
actionType string:

Workspace

Az Automation által aktivált művelet típusa

workspaceResourceId

string

A Log Analytics-munkaterület teljes Azure-erőforrás-azonosítója.

AutomationRuleSet

Egy szabálykészlet, amely kiértékeli az összes szabályt egy esemény elfogásakor. Az esemény csak akkor aktiválja a definiált műveleteket, ha a szabálykészlet összes belefoglalt szabályát "true" értékre értékeli a rendszer.

Name Típus Description
rules

AutomationTriggeringRule[]

Egy szabály, amely az esemény elfogásakor lesz kiértékelve. A szabály úgy van konfigurálva, hogy összehasonlít egy adott értéket az eseménymodellből egy várt értékkel. Ezt az összehasonlítást a támogatott operátorok egyikének használatával végezheti el.

AutomationScope

Egyetlen automatizálási hatókör.

Name Típus Description
description

string

Az erőforrások hatókörének leírása.

scopePath

string

Az erőforrások hatókörének elérési útja. Lehet az az előfizetés, amelyen az automatizálás definiálva van, vagy egy erőforráscsoport az előfizetés alatt (teljes körű Azure-erőforrásazonosítók).

AutomationSource

A forrásesemény-típusok, amelyek kiértékelik a biztonsági automatizálási szabályok készletét. Például biztonsági riasztások és biztonsági értékelések. Ha többet szeretne megtudni a támogatott biztonsági események adatmodell-sémáiról, látogasson el a webhelyre https://aka.ms/ASCAutomationSchemas.

Name Típus Description
eventSource

EventSource

Érvényes eseményforrás-típus.

ruleSets

AutomationRuleSet[]

Az esemény elfogásakor kiértékelendő szabályok halmaza. A rendszer logikai tiltást alkalmaz a definiált szabálykészletek között (logikai 'vagy').

AutomationTriggeringRule

Egy szabály, amely az esemény elfogásakor lesz kiértékelve. A szabály úgy van konfigurálva, hogy összehasonlít egy adott értéket az eseménymodellből egy várt értékkel. Ezt az összehasonlítást a támogatott operátorok egyikének használatával végezheti el.

Name Típus Description
expectedValue

string

A várt érték.

operator

Operator

A használni kívánt érvényes összehasonlító operátor. A sztringtulajdonságtípus esetében a kis- és nagybetűket nem megkülönböztető összehasonlítás lesz alkalmazva.

propertyJPath

string

Az ellenőrizni kívánt entitásmodell-tulajdonság JPath-értéke.

propertyType

PropertyType

Az összehasonlított operandusok adattípusa (sztring, egész szám, lebegőpontos szám vagy logikai [igaz/hamis]]

AutomationUpdateModel

A biztonsági automatizálási erőforrás frissítési modellje.

Name Típus Description
properties.actions AutomationAction[]:

Azoknak a műveleteknek a gyűjteménye, amelyek akkor aktiválódnak, ha az összes konfigurált szabályértékelés legalább egy szabálykészleten belül igaz.

properties.description

string

A biztonsági automatizálás leírása.

properties.isEnabled

boolean

Azt jelzi, hogy a biztonsági automatizálás engedélyezve van-e.

properties.scopes

AutomationScope[]

Hatókörök gyűjteménye, amelyre a biztonsági automatizálási logika alkalmazva van. A támogatott hatókörök maguk az előfizetések vagy az előfizetéshez tartozó erőforráscsoportok. Az automatizálás csak meghatározott hatókörökre vonatkozik.

properties.sources

AutomationSource[]

A forrásesemény-típusok gyűjteménye, amely kiértékeli a biztonsági automatizálási szabályok készletét.

tags

object

Az erőforrást leíró kulcsértékpárok listája.

CloudError

Az azure Resource Manager API-k gyakori hibaválasza a meghiúsult műveletek hibaadatainak visszaadásához. (Ez az OData hibaválasz formátumát is követi.)

Name Típus Description
error.additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

error.code

string

A hibakód.

error.details

CloudErrorBody[]

A hiba részletei.

error.message

string

A hibaüzenet.

error.target

string

A hiba célja.

CloudErrorBody

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

CloudErrorBody[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hiba célja.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további adattípus.

EventSource

Érvényes eseményforrás-típus.

Name Típus Description
Alerts

string

Assessments

string

AssessmentsSnapshot

string

AttackPaths

string

AttackPathsSnapshot

string

RegulatoryComplianceAssessment

string

RegulatoryComplianceAssessmentSnapshot

string

SecureScoreControls

string

SecureScoreControlsSnapshot

string

SecureScores

string

SecureScoresSnapshot

string

SubAssessments

string

SubAssessmentsSnapshot

string

Operator

A használni kívánt érvényes összehasonlító operátor. A sztringtulajdonságtípus esetében a kis- és nagybetűket nem megkülönböztető összehasonlítás lesz alkalmazva.

Name Típus Description
Contains

string

Csak a nem decimális operandusokra vonatkozik

EndsWith

string

Csak a nem decimális operandusokra vonatkozik

Equals

string

Decimális és nem decimális operandusokra vonatkozik

GreaterThan

string

Csak decimális operandusokra vonatkozik

GreaterThanOrEqualTo

string

Csak decimális operandusokra vonatkozik

LesserThan

string

Csak decimális operandusokra vonatkozik

LesserThanOrEqualTo

string

Csak decimális operandusokra vonatkozik

NotEquals

string

Decimális és nem decimális operandusokra vonatkozik

StartsWith

string

Csak a nem decimális operandusokra vonatkozik

PropertyType

Az összehasonlított operandusok adattípusa (sztring, egész szám, lebegőpontos szám vagy logikai [igaz/hamis]]

Name Típus Description
Boolean

string

Integer

string

Number

string

String

string