Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Definição de recurso do Bicep
O tipo de recurso securityContacts pode ser implantado com operações de destino:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Formato de recurso
Para criar um recurso Microsoft.Security/securityContacts, adicione o Bicep a seguir ao seu modelo.
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'
}
}
Objetos NotificationsSource
Defina a propriedade sourceType para especificar o tipo de objeto.
Para de Alerta, use:
{
minimalSeverity: 'string'
sourceType: 'Alert'
}
Para do AttackPath, use:
{
minimalRiskLevel: 'string'
sourceType: 'AttackPath'
}
Valores de propriedade
Microsoft.Security/securityContacts
| Nome | Descrição | Valor |
|---|---|---|
| nome | O nome do recurso | 'default' (obrigatório) |
| propriedades | Dados de contato de segurança | SecurityContactProperties |
| escopo | Use ao criar um recurso em um escopo diferente do escopo de implantação. | Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão . |
NotificationsSource
| Nome | Descrição | Valor |
|---|---|---|
| tipoDeFonte | Defina como "Alerta" para o tipo NotificationsSourceAlert. Defina como 'AttackPath' para o tipo NotificationsSourceAttackPath. | 'Alerta' 'AttackPath' (obrigatório) |
NotificationsSourceAlert
| Nome | Descrição | Valor |
|---|---|---|
| minimalSeverity | Define a gravidade mínima do alerta que será enviada como notificações por email | 'Alto' 'Baixo' 'Médio' |
| tipoDeFonte | O tipo de origem que disparará a notificação | 'Alerta' (obrigatório) |
NotificationsSourceAttackPath
| Nome | Descrição | Valor |
|---|---|---|
| minimalRiskLevel | Define o nível mínimo de risco do caminho de anexação que será enviado como notificações por email | 'Crítico' 'Alto' 'Baixo' 'Médio' |
| tipoDeFonte | O tipo de origem que disparará a notificação | 'AttackPath' (obrigatório) |
SecurityContactProperties
| Nome | Descrição | Valor |
|---|---|---|
| emails | Lista de endereços de email que receberão notificações do Microsoft Defender para Nuvem pelas configurações definidas neste contato de segurança. | cadeia |
| isEnabled | Indica se o contato de segurança está habilitado. | Bool |
| notificationsByRole | Define se enviar notificações por email do Microsoft Defender para Nuvem para pessoas com funções RBAC específicas na assinatura. | SecurityContactPropertiesNotificationsByRole |
| notificationsSources | Uma coleção de tipos de fontes que avaliam a notificação por email. | NotificationsSource[] |
| Telefone | O número de telefone do contato de segurança | cadeia |
SecurityContactPropertiesNotificationsByRole
| Nome | Descrição | Valor |
|---|---|---|
| Papéis | Define quais funções RBAC receberão notificações por email do Microsoft Defender para Nuvem. Lista de funções RBAC permitidas: | Matriz de cadeia de caracteres que contém qualquer um dos: 'AccountAdmin' 'Colaborador' 'Proprietário' 'ServiceAdmin' |
| estado | Define se enviar notificações por email do AMicrosoft Defender para Nuvem para pessoas com funções RBAC específicas na assinatura. | 'Desativado' 'Ativado' |
Definição de recurso de modelo do ARM
O tipo de recurso securityContacts pode ser implantado com operações de destino:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Formato de recurso
Para criar um recurso Microsoft.Security/securityContacts, adicione o JSON a seguir ao modelo.
{
"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"
}
}
Objetos NotificationsSource
Defina a propriedade sourceType para especificar o tipo de objeto.
Para de Alerta, use:
{
"minimalSeverity": "string",
"sourceType": "Alert"
}
Para do AttackPath, use:
{
"minimalRiskLevel": "string",
"sourceType": "AttackPath"
}
Valores de propriedade
Microsoft.Security/securityContacts
| Nome | Descrição | Valor |
|---|---|---|
| apiVersion | A versão da API | '2023-12-01-preview' |
| nome | O nome do recurso | 'default' (obrigatório) |
| propriedades | Dados de contato de segurança | SecurityContactProperties |
| tipo | O tipo de recurso | 'Microsoft.Security/securityContacts' |
NotificationsSource
| Nome | Descrição | Valor |
|---|---|---|
| tipoDeFonte | Defina como "Alerta" para o tipo NotificationsSourceAlert. Defina como 'AttackPath' para o tipo NotificationsSourceAttackPath. | 'Alerta' 'AttackPath' (obrigatório) |
NotificationsSourceAlert
| Nome | Descrição | Valor |
|---|---|---|
| minimalSeverity | Define a gravidade mínima do alerta que será enviada como notificações por email | 'Alto' 'Baixo' 'Médio' |
| tipoDeFonte | O tipo de origem que disparará a notificação | 'Alerta' (obrigatório) |
NotificationsSourceAttackPath
| Nome | Descrição | Valor |
|---|---|---|
| minimalRiskLevel | Define o nível mínimo de risco do caminho de anexação que será enviado como notificações por email | 'Crítico' 'Alto' 'Baixo' 'Médio' |
| tipoDeFonte | O tipo de origem que disparará a notificação | 'AttackPath' (obrigatório) |
SecurityContactProperties
| Nome | Descrição | Valor |
|---|---|---|
| emails | Lista de endereços de email que receberão notificações do Microsoft Defender para Nuvem pelas configurações definidas neste contato de segurança. | cadeia |
| isEnabled | Indica se o contato de segurança está habilitado. | Bool |
| notificationsByRole | Define se enviar notificações por email do Microsoft Defender para Nuvem para pessoas com funções RBAC específicas na assinatura. | SecurityContactPropertiesNotificationsByRole |
| notificationsSources | Uma coleção de tipos de fontes que avaliam a notificação por email. | NotificationsSource[] |
| Telefone | O número de telefone do contato de segurança | cadeia |
SecurityContactPropertiesNotificationsByRole
| Nome | Descrição | Valor |
|---|---|---|
| Papéis | Define quais funções RBAC receberão notificações por email do Microsoft Defender para Nuvem. Lista de funções RBAC permitidas: | Matriz de cadeia de caracteres que contém qualquer um dos: 'AccountAdmin' 'Colaborador' 'Proprietário' 'ServiceAdmin' |
| estado | Define se enviar notificações por email do AMicrosoft Defender para Nuvem para pessoas com funções RBAC específicas na assinatura. | 'Desativado' 'Ativado' |
Exemplos de uso
Definição de recurso do Terraform (provedor de AzAPI)
O tipo de recurso securityContacts pode ser implantado com operações de destino:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Formato de recurso
Para criar um recurso Microsoft.Security/securityContacts, adicione o Terraform a seguir ao seu modelo.
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"
}
}
}
Objetos NotificationsSource
Defina a propriedade sourceType para especificar o tipo de objeto.
Para de Alerta, use:
{
minimalSeverity = "string"
sourceType = "Alert"
}
Para do AttackPath, use:
{
minimalRiskLevel = "string"
sourceType = "AttackPath"
}
Valores de propriedade
Microsoft.Security/securityContacts
| Nome | Descrição | Valor |
|---|---|---|
| nome | O nome do recurso | 'default' (obrigatório) |
| parent_id | A ID do recurso ao qual aplicar esse recurso de extensão. | cadeia de caracteres (obrigatório) |
| propriedades | Dados de contato de segurança | SecurityContactProperties |
| tipo | O tipo de recurso | "Microsoft.Security/securityContacts@2023-12-01-preview" |
NotificationsSource
| Nome | Descrição | Valor |
|---|---|---|
| tipoDeFonte | Defina como "Alerta" para o tipo NotificationsSourceAlert. Defina como 'AttackPath' para o tipo NotificationsSourceAttackPath. | 'Alerta' 'AttackPath' (obrigatório) |
NotificationsSourceAlert
| Nome | Descrição | Valor |
|---|---|---|
| minimalSeverity | Define a gravidade mínima do alerta que será enviada como notificações por email | 'Alto' 'Baixo' 'Médio' |
| tipoDeFonte | O tipo de origem que disparará a notificação | 'Alerta' (obrigatório) |
NotificationsSourceAttackPath
| Nome | Descrição | Valor |
|---|---|---|
| minimalRiskLevel | Define o nível mínimo de risco do caminho de anexação que será enviado como notificações por email | 'Crítico' 'Alto' 'Baixo' 'Médio' |
| tipoDeFonte | O tipo de origem que disparará a notificação | 'AttackPath' (obrigatório) |
SecurityContactProperties
| Nome | Descrição | Valor |
|---|---|---|
| emails | Lista de endereços de email que receberão notificações do Microsoft Defender para Nuvem pelas configurações definidas neste contato de segurança. | cadeia |
| isEnabled | Indica se o contato de segurança está habilitado. | Bool |
| notificationsByRole | Define se enviar notificações por email do Microsoft Defender para Nuvem para pessoas com funções RBAC específicas na assinatura. | SecurityContactPropertiesNotificationsByRole |
| notificationsSources | Uma coleção de tipos de fontes que avaliam a notificação por email. | NotificationsSource[] |
| Telefone | O número de telefone do contato de segurança | cadeia |
SecurityContactPropertiesNotificationsByRole
| Nome | Descrição | Valor |
|---|---|---|
| Papéis | Define quais funções RBAC receberão notificações por email do Microsoft Defender para Nuvem. Lista de funções RBAC permitidas: | Matriz de cadeia de caracteres que contém qualquer um dos: 'AccountAdmin' 'Colaborador' 'Proprietário' 'ServiceAdmin' |
| estado | Define se enviar notificações por email do AMicrosoft Defender para Nuvem para pessoas com funções RBAC específicas na assinatura. | 'Desativado' 'Ativado' |
Exemplos de uso
Exemplos do Terraform
Um exemplo básico de implantação do Contato da Central de Segurança da assinatura.
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 = ["*"]
}