Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
- más reciente
- 2023-12-01-preview
- 2020-01-01-preview
- 2017-08-01-preview
Definición de recursos de Bicep
El tipo de recurso securityContacts se puede implementar con operaciones destinadas a:
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.Security/securityContacts, agregue lo siguiente a la plantilla de Bicep.
resource symbolicname 'Microsoft.Security/securityContacts@2023-12-01-preview' = {
scope: resourceSymbolicName or scope
name: 'string'
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:
{
minimalSeverity: 'string'
sourceType: 'Alert'
}
Para AttackPath, use:
{
minimalRiskLevel: 'string'
sourceType: 'AttackPath'
}
Valores de propiedad
Microsoft.Security/securityContacts
| Nombre | Descripción | Valor |
|---|---|---|
| nombre | El nombre del recurso | 'default' (obligatorio) |
| Propiedades | Datos de contacto de seguridad | SecurityContactProperties |
| scope | Use al crear un recurso en un ámbito diferente del ámbito de implementación. | Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión . |
NotificationsSource
| Nombre | Descripción | Valor |
|---|---|---|
| tipo de fuente | Establezca en "Alerta" para el tipo NotificationsSourceAlert. Establezca en "AttackPath" para el tipo NotificationsSourceAttackPath. | "Alerta" 'AttackPath' (obligatorio) |
NotificationsSourceAlert
| Nombre | Descripción | Valor |
|---|---|---|
| minimalSeverity | Define la gravedad mínima de la alerta que se enviará como notificaciones por correo electrónico. | "Alto" "Bajo" "Medio" |
| tipo de fuente | Tipo de origen que desencadenará la notificación. | 'Alert' (obligatorio) |
NotificationsSourceAttackPath
| Nombre | Descripción | Valor |
|---|---|---|
| minimalRiskLevel | Define el nivel de riesgo mínimo de la ruta de acceso de asociación que se enviará como notificaciones por correo electrónico. | "Crítico" "Alto" "Bajo" "Medio" |
| tipo de fuente | Tipo de origen que desencadenará la notificación. | 'AttackPath' (obligatorio) |
SecurityContactProperties
| Nombre | Descripción | Valor |
|---|---|---|
| correos electrónicos | 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. | cuerda |
| isEnabled | Indica si el contacto de seguridad está habilitado. | Bool |
| notificationsByRole | Define si se envían 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[] |
| Teléfono | Número de teléfono del contacto de seguridad | cuerda |
SecurityContactPropertiesNotificationsByRole
| Nombre | Descripción | Valor |
|---|---|---|
| Papeles | 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' |
| estado | Define si se envían notificaciones por correo electrónico de AMicrosoft Defender for Cloud a personas con roles de RBAC específicos en la suscripción. | 'Desactivado' "Activado" |
Definición de recursos de plantilla de ARM
El tipo de recurso securityContacts se puede implementar con operaciones destinadas a:
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.Security/securityContacts, agregue el siguiente JSON a la plantilla.
{
"type": "Microsoft.Security/securityContacts",
"apiVersion": "2023-12-01-preview",
"name": "string",
"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:
{
"minimalSeverity": "string",
"sourceType": "Alert"
}
Para AttackPath, use:
{
"minimalRiskLevel": "string",
"sourceType": "AttackPath"
}
Valores de propiedad
Microsoft.Security/securityContacts
| Nombre | Descripción | Valor |
|---|---|---|
| apiVersion | La versión de api | '2023-12-01-preview' |
| nombre | El nombre del recurso | 'default' (obligatorio) |
| Propiedades | Datos de contacto de seguridad | SecurityContactProperties |
| tipo | El tipo de recurso | "Microsoft.Security/securityContacts" |
NotificationsSource
| Nombre | Descripción | Valor |
|---|---|---|
| tipo de fuente | Establezca en "Alerta" para el tipo NotificationsSourceAlert. Establezca en "AttackPath" para el tipo NotificationsSourceAttackPath. | "Alerta" 'AttackPath' (obligatorio) |
NotificationsSourceAlert
| Nombre | Descripción | Valor |
|---|---|---|
| minimalSeverity | Define la gravedad mínima de la alerta que se enviará como notificaciones por correo electrónico. | "Alto" "Bajo" "Medio" |
| tipo de fuente | Tipo de origen que desencadenará la notificación. | 'Alert' (obligatorio) |
NotificationsSourceAttackPath
| Nombre | Descripción | Valor |
|---|---|---|
| minimalRiskLevel | Define el nivel de riesgo mínimo de la ruta de acceso de asociación que se enviará como notificaciones por correo electrónico. | "Crítico" "Alto" "Bajo" "Medio" |
| tipo de fuente | Tipo de origen que desencadenará la notificación. | 'AttackPath' (obligatorio) |
SecurityContactProperties
| Nombre | Descripción | Valor |
|---|---|---|
| correos electrónicos | 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. | cuerda |
| isEnabled | Indica si el contacto de seguridad está habilitado. | Bool |
| notificationsByRole | Define si se envían 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[] |
| Teléfono | Número de teléfono del contacto de seguridad | cuerda |
SecurityContactPropertiesNotificationsByRole
| Nombre | Descripción | Valor |
|---|---|---|
| Papeles | 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' |
| estado | Define si se envían notificaciones por correo electrónico de AMicrosoft Defender for Cloud a personas con roles de RBAC específicos en la suscripción. | 'Desactivado' "Activado" |
Ejemplos de uso
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso securityContacts se puede implementar con operaciones destinadas a:
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
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 = "string"
parent_id = "string"
body = {
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:
{
minimalSeverity = "string"
sourceType = "Alert"
}
Para AttackPath, use:
{
minimalRiskLevel = "string"
sourceType = "AttackPath"
}
Valores de propiedad
Microsoft.Security/securityContacts
| Nombre | Descripción | Valor |
|---|---|---|
| nombre | El nombre del recurso | 'default' (obligatorio) |
| parent_id | Identificador del recurso al que se va a aplicar este recurso de extensión. | string (obligatorio) |
| Propiedades | Datos de contacto de seguridad | SecurityContactProperties |
| tipo | El tipo de recurso | "Microsoft.Security/securityContacts@2023-12-01-preview" |
NotificationsSource
| Nombre | Descripción | Valor |
|---|---|---|
| tipo de fuente | Establezca en "Alerta" para el tipo NotificationsSourceAlert. Establezca en "AttackPath" para el tipo NotificationsSourceAttackPath. | "Alerta" 'AttackPath' (obligatorio) |
NotificationsSourceAlert
| Nombre | Descripción | Valor |
|---|---|---|
| minimalSeverity | Define la gravedad mínima de la alerta que se enviará como notificaciones por correo electrónico. | "Alto" "Bajo" "Medio" |
| tipo de fuente | Tipo de origen que desencadenará la notificación. | 'Alert' (obligatorio) |
NotificationsSourceAttackPath
| Nombre | Descripción | Valor |
|---|---|---|
| minimalRiskLevel | Define el nivel de riesgo mínimo de la ruta de acceso de asociación que se enviará como notificaciones por correo electrónico. | "Crítico" "Alto" "Bajo" "Medio" |
| tipo de fuente | Tipo de origen que desencadenará la notificación. | 'AttackPath' (obligatorio) |
SecurityContactProperties
| Nombre | Descripción | Valor |
|---|---|---|
| correos electrónicos | 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. | cuerda |
| isEnabled | Indica si el contacto de seguridad está habilitado. | Bool |
| notificationsByRole | Define si se envían 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[] |
| Teléfono | Número de teléfono del contacto de seguridad | cuerda |
SecurityContactPropertiesNotificationsByRole
| Nombre | Descripción | Valor |
|---|---|---|
| Papeles | 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' |
| estado | Define si se envían notificaciones por correo electrónico de AMicrosoft Defender for Cloud a personas con roles de RBAC específicos en la suscripción. | 'Desactivado' "Activado" |
Ejemplos de uso
Ejemplos de Terraform
Un ejemplo básico de implementación del contacto del centro de seguridad de la suscripción.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
azurerm = {
source = "hashicorp/azurerm"
}
}
}
provider "azurerm" {
features {
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "eastus"
}
data "azurerm_client_config" "current" {
}
resource "azapi_resource" "securityContact" {
type = "Microsoft.Security/securityContacts@2017-08-01-preview"
parent_id = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
name = var.resource_name
body = {
properties = {
alertNotifications = "On"
alertsToAdmins = "On"
email = "basic@example.com"
phone = "+1-555-555-5555"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}