Microsoft.Security securityContacts
Definición de recursos de Bicep
El tipo de recurso securityContacts se puede implementar con operaciones que tienen como destino:
- Suscripciones: consulte los comandos de implementación de suscripciones.
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Security/securityContacts, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.Security/securityContacts@2023-12-01-preview' = {
name: 'default'
properties: {
emails: 'string'
isEnabled: bool
notificationsByRole: {
roles: [
'string'
]
state: 'string'
}
notificationsSources: [
{
sourceType: 'string'
// For remaining properties, see NotificationsSource objects
}
]
phone: 'string'
}
}
NotificationsSource (objetos)
Establezca la propiedad sourceType para especificar el tipo de objeto.
Para Alerta, use:
sourceType: 'Alert'
minimalSeverity: 'string'
Para AttackPath, use:
sourceType: 'AttackPath'
minimalRiskLevel: 'string'
Valores de propiedad
securityContacts
| Nombre | Descripción | Value |
|---|---|---|
| name | El nombre del recurso | 'default' |
| properties | Datos de contacto de seguridad | SecurityContactProperties |
SecurityContactProperties
| Nombre | Descripción | Valor |
|---|---|---|
| emails | Lista de direcciones de correo electrónico que recibirán notificaciones de Microsoft Defender for Cloud por las configuraciones definidas en este contacto de seguridad. | string |
| isEnabled | Indica si el contacto de seguridad está habilitado. | bool |
| notificationsByRole | Define si se van a enviar notificaciones por correo electrónico de Microsoft Defender for Cloud a personas con roles de RBAC específicos en la suscripción. | SecurityContactPropertiesNotificationsByRole |
| notificationsSources | Colección de tipos de orígenes que evalúan la notificación por correo electrónico. | NotificationsSource[] |
| phone | Número de teléfono del contacto de seguridad | string |
SecurityContactPropertiesNotificationsByRole
| Nombre | Descripción | Valor |
|---|---|---|
| roles | Define qué roles de RBAC recibirán notificaciones por correo electrónico de Microsoft Defender for Cloud. Lista de roles RBAC permitidos: | Matriz de cadenas que contiene cualquiera de: 'AccountAdmin' 'Colaborador' 'Propietario' 'ServiceAdmin' |
| state | Define si se van a enviar notificaciones por correo electrónico de AMicrosoft Defender for Cloud a personas con roles de RBAC específicos en la suscripción. | 'Desactivado' "Activado" |
NotificationsSource
| Nombre | Descripción | Valor |
|---|---|---|
| sourceType | Establecimiento del tipo de objeto | Alerta AttackPath (obligatorio) |
NotificationsSourceAlert
| Nombre | Descripción | Valor |
|---|---|---|
| sourceType | Tipo de origen que desencadenará la notificación. | 'Alert' (obligatorio) |
| minimalSeverity | Define la gravedad mínima de la alerta que se enviará como notificaciones por correo electrónico. | "Alto" "Bajo" "Medio" |
NotificationsSourceAttackPath
| Nombre | Descripción | Valor |
|---|---|---|
| sourceType | Tipo de origen que desencadenará la notificación. | 'AttackPath' (obligatorio) |
| minimalRiskLevel | Define el nivel mínimo de riesgo de la ruta de acceso de asociación que se enviará como notificaciones por correo electrónico. | "Crítico" "Alto" "Bajo" "Medio" |
Definición de recursos de plantilla de ARM
El tipo de recurso securityContacts se puede implementar con operaciones que tienen como destino:
- Suscripciones: consulte los comandos de implementación de suscripciones.
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Security/securityContacts, agregue el siguiente json a la plantilla.
{
"type": "Microsoft.Security/securityContacts",
"apiVersion": "2023-12-01-preview",
"name": "default",
"properties": {
"emails": "string",
"isEnabled": "bool",
"notificationsByRole": {
"roles": [ "string" ],
"state": "string"
},
"notificationsSources": [
{
"sourceType": "string"
// For remaining properties, see NotificationsSource objects
}
],
"phone": "string"
}
}
NotificationsSource (objetos)
Establezca la propiedad sourceType para especificar el tipo de objeto.
Para Alerta, use:
"sourceType": "Alert",
"minimalSeverity": "string"
Para AttackPath, use:
"sourceType": "AttackPath",
"minimalRiskLevel": "string"
Valores de propiedad
securityContacts
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.Security/securityContacts" |
| apiVersion | La versión de la API de recursos | "2023-12-01-preview" |
| name | El nombre del recurso | 'default' |
| properties | Datos de contacto de seguridad | SecurityContactProperties |
SecurityContactProperties
| Nombre | Descripción | Valor |
|---|---|---|
| emails | Lista de direcciones de correo electrónico que recibirán notificaciones de Microsoft Defender for Cloud por las configuraciones definidas en este contacto de seguridad. | string |
| isEnabled | Indica si el contacto de seguridad está habilitado. | bool |
| notificationsByRole | Define si se van a enviar notificaciones por correo electrónico de Microsoft Defender for Cloud a personas con roles de RBAC específicos en la suscripción. | SecurityContactPropertiesNotificationsByRole |
| notificationsSources | Colección de tipos de orígenes que evalúan la notificación por correo electrónico. | NotificationsSource[] |
| phone | Número de teléfono del contacto de seguridad | string |
SecurityContactPropertiesNotificationsByRole
| Nombre | Descripción | Valor |
|---|---|---|
| roles | Define qué roles de RBAC recibirán notificaciones por correo electrónico de Microsoft Defender for Cloud. Lista de roles RBAC permitidos: | Matriz de cadenas que contiene cualquiera de: 'AccountAdmin' 'Colaborador' 'Propietario' 'ServiceAdmin' |
| state | Define si se van a enviar notificaciones por correo electrónico de AMicrosoft Defender for Cloud a personas con roles de RBAC específicos en la suscripción. | 'Desactivado' "Activado" |
NotificationsSource
| Nombre | Descripción | Valor |
|---|---|---|
| sourceType | Establecimiento del tipo de objeto | Alerta AttackPath (obligatorio) |
NotificationsSourceAlert
| Nombre | Descripción | Valor |
|---|---|---|
| sourceType | Tipo de origen que desencadenará la notificación. | 'Alert' (obligatorio) |
| minimalSeverity | Define la gravedad mínima de la alerta que se enviará como notificaciones por correo electrónico. | "Alto" "Bajo" "Medio" |
NotificationsSourceAttackPath
| Nombre | Descripción | Valor |
|---|---|---|
| sourceType | Tipo de origen que desencadenará la notificación. | 'AttackPath' (obligatorio) |
| minimalRiskLevel | Define el nivel mínimo de riesgo de la ruta de acceso de asociación que se enviará como notificaciones por correo electrónico. | "Crítico" "Alto" "Bajo" "Medio" |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso securityContacts se puede implementar con operaciones que tienen como destino:
- Suscripciones
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.Security/securityContacts, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Security/securityContacts@2023-12-01-preview"
name = "default"
parent_id = "string"
body = jsonencode({
properties = {
emails = "string"
isEnabled = bool
notificationsByRole = {
roles = [
"string"
]
state = "string"
}
notificationsSources = [
{
sourceType = "string"
// For remaining properties, see NotificationsSource objects
}
]
phone = "string"
}
})
}
NotificationsSource (objetos)
Establezca la propiedad sourceType para especificar el tipo de objeto.
Para Alerta, use:
sourceType = "Alert"
minimalSeverity = "string"
Para AttackPath, use:
sourceType = "AttackPath"
minimalRiskLevel = "string"
Valores de propiedad
securityContacts
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.Security/securityContacts@2023-12-01-preview" |
| name | El nombre del recurso | "predeterminado" |
| parent_id | Para realizar la implementación en una suscripción, use el identificador de esa suscripción. | string (obligatorio) |
| properties | Datos de contacto de seguridad | SecurityContactProperties |
SecurityContactProperties
| Nombre | Descripción | Valor |
|---|---|---|
| emails | Lista de direcciones de correo electrónico que recibirán notificaciones de Microsoft Defender for Cloud por las configuraciones definidas en este contacto de seguridad. | string |
| isEnabled | Indica si el contacto de seguridad está habilitado. | bool |
| notificationsByRole | Define si se van a enviar notificaciones por correo electrónico de Microsoft Defender for Cloud a personas con roles de RBAC específicos en la suscripción. | SecurityContactPropertiesNotificationsByRole |
| notificationsSources | Colección de tipos de orígenes que evalúan la notificación por correo electrónico. | NotificationsSource[] |
| phone | Número de teléfono del contacto de seguridad | string |
SecurityContactPropertiesNotificationsByRole
| Nombre | Descripción | Valor |
|---|---|---|
| roles | Define qué roles de RBAC recibirán notificaciones por correo electrónico de Microsoft Defender for Cloud. Lista de roles RBAC permitidos: | Matriz de cadenas que contiene cualquiera de: "AccountAdmin" "Colaborador" "Propietario" "ServiceAdmin" |
| state | Define si se van a enviar notificaciones por correo electrónico de AMicrosoft Defender for Cloud a personas con roles de RBAC específicos en la suscripción. | "Desactivado" "Activado" |
NotificationsSource
| Nombre | Descripción | Valor |
|---|---|---|
| sourceType | Establecimiento del tipo de objeto | Alerta AttackPath (obligatorio) |
NotificationsSourceAlert
| Nombre | Descripción | Valor |
|---|---|---|
| sourceType | Tipo de origen que desencadenará la notificación. | "Alerta" (obligatorio) |
| minimalSeverity | Define la gravedad mínima de la alerta que se enviará como notificaciones por correo electrónico. | "High" "Low" "Medio" |
NotificationsSourceAttackPath
| Nombre | Descripción | Valor |
|---|---|---|
| sourceType | Tipo de origen que desencadenará la notificación. | "AttackPath" (obligatorio) |
| minimalRiskLevel | Define el nivel mínimo de riesgo de la ruta de acceso de asociación que se enviará como notificaciones por correo electrónico. | "Crítico" "High" "Low" "Medio" |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de