Automations - Update
Actualiza 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 |
---|---|---|---|---|
automation
|
path | True |
string |
Nombre de la automatización de seguridad. |
resource
|
path | True |
string |
Nombre del grupo de recursos dentro de la suscripción del usuario. El nombre no distingue mayúsculas de minúsculas. Patrón de Regex: |
subscription
|
path | True |
string |
Identificador de suscripción de Azure Patrón de Regex: |
api-version
|
query | True |
string |
Versión de API para la operación |
Cuerpo de la solicitud
Nombre | Tipo | Description |
---|---|---|
properties.actions | AutomationAction[]: |
Una 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 |
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 |
Colección de los tipos de eventos de origen que evalúan el conjunto de reglas de automatización de seguridad. |
|
tags |
object |
Lista de pares clave-valor que describen el recurso. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
De acuerdo |
|
Other Status Codes |
Respuesta de error que describe por qué se produjo un error en la operación. |
Seguridad
azure_auth
Flujo de OAuth2 de Azure Active Directory
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
Nombre | Description |
---|---|
user_impersonation | suplantar la cuenta de usuario |
Ejemplos
Update a security automation
Solicitud de ejemplo
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"
}
]
}
}
Respuesta de muestra
{
"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 |
Recurso de automatización de seguridad. |
Automation |
Centro de eventos de destino al que se exportarán los datos del evento. Para obtener más información sobre las funcionalidades de exportación continua de Microsoft Defender for Cloud, visite https://aka.ms/ASCExportLearnMore |
Automation |
Acción de aplicación lógica que se debe desencadenar. Para obtener más información sobre las funcionalidades de Automatización de flujos de trabajo de Microsoft Defender for Cloud, visite https://aka.ms/ASCWorkflowAutomationLearnMore |
Automation |
Á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 evaluaciones residirán en la tabla "SecurityRecommendation" (en las soluciones "Security"/"SecurityCenterFree"). Tenga en cuenta que, para ver los datos del área de trabajo, la solución gratuita o estándar de Log Analytics de Security Center debe estar habilitada en esa área de trabajo. Para obtener más información sobre las funcionalidades de exportación continua de Microsoft Defender for Cloud, visite https://aka.ms/ASCExportLearnMore |
Automation |
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. |
Automation |
Un único ámbito de automatización. |
Automation |
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. |
Automation |
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. |
Automation |
Modelo de actualización del recurso de automatización de seguridad. |
Cloud |
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). |
Cloud |
Detalle del error. |
Error |
Información adicional sobre el error de administración de recursos. |
Event |
Tipo de origen de evento válido. |
Operator |
Operador de comparador válido que se va a usar. Se aplicará una comparación que no distingue mayúsculas de minúsculas para String PropertyType. |
Property |
Tipo de datos de los operandos comparados (cadena, entero, número de punto flotante o booleano [true/false]] |
Automation
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 |
Identificador de recurso |
kind |
string |
Tipo de recurso |
location |
string |
Ubicación donde se almacena el recurso |
name |
string |
Nombre del recurso |
properties.actions | AutomationAction[]: |
Una 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 |
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 |
Colección de los tipos de eventos de origen que evalúan el conjunto de reglas de automatización de seguridad. |
|
tags |
object |
Lista de pares clave-valor que describen el recurso. |
type |
string |
Tipo de recurso |
AutomationActionEventHub
Centro de eventos de destino al que se exportarán los datos del evento. Para obtener más información sobre las funcionalidades de exportación continua de Microsoft Defender for Cloud, visite https://aka.ms/ASCExportLearnMore
Nombre | Tipo | Description |
---|---|---|
actionType |
string:
Event |
Tipo de la acción que desencadenará Automation. |
connectionString |
string |
Cadena de conexión del centro de eventos de destino (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 obtener más información sobre las funcionalidades de Automatización de flujos de trabajo de Microsoft Defender for Cloud, visite https://aka.ms/ASCWorkflowAutomationLearnMore
Nombre | Tipo | Description |
---|---|---|
actionType |
string:
Logic |
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 evaluaciones residirán en la tabla "SecurityRecommendation" (en las soluciones "Security"/"SecurityCenterFree"). Tenga en cuenta que, para ver los datos del área de trabajo, la solución gratuita o estándar de Log Analytics de Security Center debe estar habilitada en esa área de trabajo. Para obtener más información sobre las funcionalidades de exportación continua de Microsoft Defender for Cloud, visite https://aka.ms/ASCExportLearnMore
Nombre | Tipo | Description |
---|---|---|
actionType |
string:
Workspace |
Tipo de la acción que desencadenará Automation. |
workspaceResourceId |
string |
Identificador de recurso de Azure del área de trabajo de Log Analytics completa. |
AutomationRuleSet
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 |
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 |
Tipo de origen de evento válido. |
|
ruleSets |
Conjunto de reglas que se evalúan tras la interceptación de eventos. Se aplica una disjunció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 |
Operador de comparador válido que se va a usar. Se aplicará una comparación que no distingue mayúsculas de minúsculas para String PropertyType. |
|
propertyJPath |
string |
JPath de la propiedad del modelo de entidad que se debe comprobar. |
propertyType |
Tipo de datos de los operandos comparados (cadena, entero, número de punto flotante o booleano [true/false]] |
AutomationUpdateModel
Modelo de actualización del recurso de automatización de seguridad.
Nombre | Tipo | Description |
---|---|---|
properties.actions | AutomationAction[]: |
Una 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 |
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 |
Colección de los tipos de eventos de origen que evalúan el conjunto de reglas de automatización de seguridad. |
|
tags |
object |
Lista de pares clave-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 |
Información adicional del error. |
|
error.code |
string |
Código de error. |
error.details |
Detalles del error. |
|
error.message |
string |
Mensaje de error. |
error.target |
string |
Destino del error. |
CloudErrorBody
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Detalles del error. |
|
message |
string |
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 que no distingue mayúsculas de 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 |