Compartilhar via


Microsoft.Security securityContatos

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    = ["*"]
}