Compartir a través de


Automations - Update

Novedades una automatización de seguridad

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
automationName
path True

string

Nombre de la automatización de seguridad.

resourceGroupName
path True

string

Nombre del grupo de recursos dentro de la suscripción del usuario. El nombre distingue mayúsculas de minúsculas.

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

subscriptionId
path True

string

Identificador de suscripción de Azure

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

api-version
query True

string

Versión de API para la operación

Cuerpo de la solicitud

Nombre Tipo Description
properties.actions AutomationAction[]:

Colección de las acciones que se desencadenan si todas las evaluaciones de reglas configuradas, dentro de al menos un conjunto de reglas, son true.

properties.description

string

Descripción de la automatización de seguridad.

properties.isEnabled

boolean

Indica si la automatización de seguridad está habilitada.

properties.scopes

AutomationScope[]

Colección de ámbitos en los que se aplica la lógica de automatización de seguridad. Los ámbitos admitidos son la propia suscripción o un grupo de recursos en esa suscripción. La automatización solo se aplicará en ámbitos definidos.

properties.sources

AutomationSource[]

Colección de los tipos de eventos de origen que evalúan el conjunto de reglas de automatización de seguridad.

tags

object

Una lista de pares de clave y valor que describen el recurso.

Respuestas

Nombre Tipo Description
200 OK

Automation

Aceptar

Other Status Codes

CloudError

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

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

Scopes

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

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

Definiciones

Nombre Description
Automation

El recurso de automatización de seguridad.

AutomationActionEventHub

El centro de eventos de destino al que se exportarán los datos de eventos. Para más información sobre Microsoft Defender para las funcionalidades de exportación continua en la nube, visitehttps://aka.ms/ASCExportLearnMore

AutomationActionLogicApp

Acción de aplicación lógica que se debe desencadenar. Para más información sobre las funcionalidades de automatización de flujos de trabajo de Microsoft Defender for Cloud, visitehttps://aka.ms/ASCWorkflowAutomationLearnMore

AutomationActionWorkspace

Área de trabajo de Log Analytics a la que se exportarán los datos de eventos. Los datos de alertas de seguridad residirán en la tabla "SecurityAlert" y los datos de las evaluaciones residirán en la tabla "SecurityRecommendation" (en las soluciones "Security"/"SecurityCenterFree"). Tenga en cuenta que para ver los datos en el área de trabajo, la solución gratuita o estándar de Security Center Log Analytics debe estar habilitada en esa área de trabajo. Para más información sobre Microsoft Defender para las funcionalidades de exportación continua en la nube, visitehttps://aka.ms/ASCExportLearnMore

AutomationRuleSet

Un conjunto de reglas que evalúa todas sus reglas en una interceptación de eventos. Solo cuando todas las reglas incluidas del conjunto de reglas se evalúen como "true", el evento desencadenará las acciones definidas.

AutomationScope

Un único ámbito de automatización.

AutomationSource

Tipos de eventos de origen que evalúan el conjunto de reglas de automatización de seguridad. Por ejemplo: alertas de seguridad y evaluaciones de seguridad. Para más información sobre los esquemas de modelos de datos de eventos de seguridad admitidos, visite https://aka.ms/ASCAutomationSchemas.

AutomationTriggeringRule

Regla que se evalúa tras la interceptación de eventos. La regla se configura comparando un valor específico del modelo de eventos con un valor esperado. Esta comparación se realiza mediante uno de los operadores admitidos establecidos.

AutomationUpdateModel

El modelo de actualización del recurso de automatización de seguridad.

CloudError

Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).

CloudErrorBody

Detalle del error.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

EventSource

Tipo de origen de evento válido.

Operator

Operador de comparador válido que se va a usar. Se aplicará una comparación sin distinción entre mayúsculas y minúsculas para String PropertyType.

PropertyType

Tipo de datos de los operandos comparados (cadena, entero, número de punto flotante o booleano [true/false]]

Automation

El recurso de automatización de seguridad.

Nombre Tipo Description
etag

string

La etiqueta de entidad se usa para comparar dos o más entidades del mismo recurso solicitado.

id

string

Id. de recurso

kind

string

Tipo de recurso

location

string

Ubicación donde se almacena el recurso

name

string

Nombre del recurso

properties.actions AutomationAction[]:

Colección de las acciones que se desencadenan si todas las evaluaciones de reglas configuradas, dentro de al menos un conjunto de reglas, son true.

properties.description

string

Descripción de la automatización de seguridad.

properties.isEnabled

boolean

Indica si la automatización de seguridad está habilitada.

properties.scopes

AutomationScope[]

Colección de ámbitos en los que se aplica la lógica de automatización de seguridad. Los ámbitos admitidos son la propia suscripción o un grupo de recursos en esa suscripción. La automatización solo se aplicará en ámbitos definidos.

properties.sources

AutomationSource[]

Colección de los tipos de eventos de origen que evalúan el conjunto de reglas de automatización de seguridad.

tags

object

Una lista de pares de clave y valor que describen el recurso.

type

string

Tipo de recurso

AutomationActionEventHub

El centro de eventos de destino al que se exportarán los datos de eventos. Para más información sobre Microsoft Defender para las funcionalidades de exportación continua en la nube, visitehttps://aka.ms/ASCExportLearnMore

Nombre Tipo Description
actionType string:

EventHub

El tipo de la acción que desencadenará Automation.

connectionString

string

El centro de eventos de destino cadena de conexión (no se incluirá en ninguna respuesta).

eventHubResourceId

string

Identificador de recurso de Azure del centro de eventos de destino.

isTrustedServiceEnabled

boolean

Indica si el servicio de confianza está habilitado o no.

sasPolicyName

string

Nombre de la directiva SAS de centro de eventos de destino.

AutomationActionLogicApp

Acción de aplicación lógica que se debe desencadenar. Para más información sobre las funcionalidades de automatización de flujos de trabajo de Microsoft Defender for Cloud, visitehttps://aka.ms/ASCWorkflowAutomationLearnMore

Nombre Tipo Description
actionType string:

LogicApp

El tipo de la acción que desencadenará Automation.

logicAppResourceId

string

Identificador de recurso de Azure de aplicación lógica desencadenada. Esto también puede residir en otras suscripciones, dado que tiene permisos para desencadenar la aplicación lógica.

uri

string

El punto de conexión del URI del desencadenador de aplicación lógica (no se incluirá en ninguna respuesta).

AutomationActionWorkspace

Área de trabajo de Log Analytics a la que se exportarán los datos de eventos. Los datos de alertas de seguridad residirán en la tabla "SecurityAlert" y los datos de las evaluaciones residirán en la tabla "SecurityRecommendation" (en las soluciones "Security"/"SecurityCenterFree"). Tenga en cuenta que para ver los datos en el área de trabajo, la solución gratuita o estándar de Security Center Log Analytics debe estar habilitada en esa área de trabajo. Para más información sobre Microsoft Defender para las funcionalidades de exportación continua en la nube, visitehttps://aka.ms/ASCExportLearnMore

Nombre Tipo Description
actionType string:

Workspace

El tipo de la acción que desencadenará Automation.

workspaceResourceId

string

Identificador de recurso de Azure del área de trabajo de Log Analytics completa.

AutomationRuleSet

Un conjunto de reglas que evalúa todas sus reglas en una interceptación de eventos. Solo cuando todas las reglas incluidas del conjunto de reglas se evalúen como "true", el evento desencadenará las acciones definidas.

Nombre Tipo Description
rules

AutomationTriggeringRule[]

Regla que se evalúa tras la interceptación de eventos. La regla se configura comparando un valor específico del modelo de eventos con un valor esperado. Esta comparación se realiza mediante uno de los operadores admitidos establecidos.

AutomationScope

Un único ámbito de automatización.

Nombre Tipo Description
description

string

Descripción del ámbito de los recursos.

scopePath

string

Ruta de acceso del ámbito de recursos. Puede ser la suscripción en la que se define la automatización o un grupo de recursos en esa suscripción (identificadores de recursos de Azure completos).

AutomationSource

Tipos de eventos de origen que evalúan el conjunto de reglas de automatización de seguridad. Por ejemplo: alertas de seguridad y evaluaciones de seguridad. Para más información sobre los esquemas de modelos de datos de eventos de seguridad admitidos, visite https://aka.ms/ASCAutomationSchemas.

Nombre Tipo Description
eventSource

EventSource

Tipo de origen de evento válido.

ruleSets

AutomationRuleSet[]

Conjunto de reglas que se evalúan tras la interceptación de eventos. Se aplica una disyunción lógica entre conjuntos de reglas definidos (lógicos "o").

AutomationTriggeringRule

Regla que se evalúa tras la interceptación de eventos. La regla se configura comparando un valor específico del modelo de eventos con un valor esperado. Esta comparación se realiza mediante uno de los operadores admitidos establecidos.

Nombre Tipo Description
expectedValue

string

Valor esperado.

operator

Operator

Operador de comparador válido que se va a usar. Se aplicará una comparación sin distinción entre mayúsculas y minúsculas para String PropertyType.

propertyJPath

string

JPath de la propiedad del modelo de entidad que se debe comprobar.

propertyType

PropertyType

Tipo de datos de los operandos comparados (cadena, entero, número de punto flotante o booleano [true/false]]

AutomationUpdateModel

El modelo de actualización del recurso de automatización de seguridad.

Nombre Tipo Description
properties.actions AutomationAction[]:

Colección de las acciones que se desencadenan si todas las evaluaciones de reglas configuradas, dentro de al menos un conjunto de reglas, son true.

properties.description

string

Descripción de la automatización de seguridad.

properties.isEnabled

boolean

Indica si la automatización de seguridad está habilitada.

properties.scopes

AutomationScope[]

Colección de ámbitos en los que se aplica la lógica de automatización de seguridad. Los ámbitos admitidos son la propia suscripción o un grupo de recursos en esa suscripción. La automatización solo se aplicará en ámbitos definidos.

properties.sources

AutomationSource[]

Colección de los tipos de eventos de origen que evalúan el conjunto de reglas de automatización de seguridad.

tags

object

Una lista de pares de clave y valor que describen el recurso.

CloudError

Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).

Nombre Tipo Description
error.additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

error.code

string

Código de error.

error.details

CloudErrorBody[]

Los detalles del error.

error.message

string

El mensaje de error.

error.target

string

Destino del error.

CloudErrorBody

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

CloudErrorBody[]

Los detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

EventSource

Tipo de origen de evento válido.

Nombre Tipo 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

Operador de comparador válido que se va a usar. Se aplicará una comparación sin distinción entre mayúsculas y minúsculas para String PropertyType.

Nombre Tipo Description
Contains

string

Solo se aplica a operandos no decimales

EndsWith

string

Solo se aplica a operandos no decimales

Equals

string

Se aplica a operandos decimales y no decimales

GreaterThan

string

Solo se aplica a operandos decimales.

GreaterThanOrEqualTo

string

Solo se aplica a operandos decimales.

LesserThan

string

Solo se aplica a operandos decimales.

LesserThanOrEqualTo

string

Solo se aplica a operandos decimales.

NotEquals

string

Se aplica a operandos decimales y no decimales

StartsWith

string

Solo se aplica a operandos no decimales

PropertyType

Tipo de datos de los operandos comparados (cadena, entero, número de punto flotante o booleano [true/false]]

Nombre Tipo Description
Boolean

string

Integer

string

Number

string

String

string