Compartilhar via

Microsoft.Security securityContacts

  • Artigo

Definição de recurso do Bicep

O tipo de recurso securityContacts pode ser implantado com operações direcionadas:

Para obter uma lista das propriedades alteradas em cada versão da API, consulte log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Security/securityContacts, adicione o Bicep a seguir ao modelo.

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'
  }
}

Objetos NotificationsSource

Defina a propriedade sourceType para especificar o tipo de objeto.

Para Alerta, use:

  sourceType: 'Alert'
  minimalSeverity: 'string'

Para AttackPath, use:

  sourceType: 'AttackPath'
  minimalRiskLevel: 'string'

Valores de propriedade

securityContacts

Nome Descrição Valor
name O nome do recurso 'default'
properties Dados de contato de segurança SecurityContactProperties

SecurityContactProperties

Nome Descrição Valor
e-mails 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. string
isEnabled Indica se o contato de segurança está habilitado. bool
notificationsByRole Define se é necessário enviar notificações por email do Microsoft Defender for Cloud 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[]
phone O número de telefone do contato de segurança string

SecurityContactPropertiesNotificationsByRole

Nome Descrição Valor
funções Define quais funções RBAC receberão notificações por email do Microsoft Defender for Cloud. Lista de funções RBAC permitidas: Matriz de cadeia de caracteres que contém qualquer um dos:
'AccountAdmin'
'Colaborador'
'Proprietário'
'ServiceAdmin'
state Define se é necessário enviar notificações por email do AMicrosoft Defender para Nuvem para pessoas com funções RBAC específicas na assinatura. 'Off'
'On'

NotificationsSource

Nome Descrição Valor
sourceType Definir o tipo de objeto Alerta
AttackPath (obrigatório)

NotificationsSourceAlert

Nome Descrição Valor
sourceType O tipo de origem que disparará a notificação 'Alert' (obrigatório)
minimalSeverity Define a severidade mínima do alerta que será enviada como notificações por email 'Alto'
'Low'
'Medium'

NotificationsSourceAttackPath

Nome Descrição Valor
sourceType O tipo de origem que disparará a notificação 'AttackPath' (obrigatório)
minimalRiskLevel Define o nível de risco mínimo do caminho de anexação que será enviado como notificações por email 'Crítico'
'Alto'
'Low'
'Medium'

Definição de recurso de modelo do ARM

O tipo de recurso securityContacts pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte 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": "default",
  "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 Alerta, use:

  "sourceType": "Alert",
  "minimalSeverity": "string"

Para AttackPath, use:

  "sourceType": "AttackPath",
  "minimalRiskLevel": "string"

Valores de propriedade

securityContacts

Nome Descrição Valor
tipo O tipo de recurso 'Microsoft.Security/securityContacts'
apiVersion A versão da API de recursos '2023-12-01-preview'
name O nome do recurso 'default'
properties Dados de contato de segurança SecurityContactProperties

SecurityContactProperties

Nome Descrição Valor
e-mails Lista de endereços de email que receberão notificações de Microsoft Defender para Nuvem pelas configurações definidas neste contato de segurança. string
isEnabled Indica se o contato de segurança está habilitado. bool
notificationsByRole Define se é necessário enviar notificações por email do Microsoft Defender for Cloud 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[]
phone O número de telefone do contato de segurança string

SecurityContactPropertiesNotificationsByRole

Nome Descrição Valor
funções Define quais funções RBAC obterão notificações por email de 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'
state Define se é necessário enviar notificações por email do AMicrosoft Defender para Nuvem para pessoas com funções RBAC específicas na assinatura. 'Desativado'
'On'

NotificationsSource

Nome Descrição Valor
sourceType Definir o tipo de objeto Alerta
AttackPath (obrigatório)

NotificationsSourceAlert

Nome Descrição Valor
sourceType O tipo de origem que disparará a notificação 'Alert' (obrigatório)
minimalSeverity Define a gravidade mínima do alerta que será enviada como notificações por email 'Alto'
'Low'
'Medium'

NotificationsSourceAttackPath

Nome Descrição Valor
sourceType O tipo de origem que disparará a notificação 'AttackPath' (obrigatório)
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'
'Low'
'Medium'

Definição de recurso do Terraform (provedor AzAPI)

O tipo de recurso securityContacts pode ser implantado com operações direcionadas:

  • Assinaturas

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Security/securityContacts, adicione o Terraform a seguir ao modelo.

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"
    }
  })
}

Objetos NotificationsSource

Defina a propriedade sourceType para especificar o tipo de objeto.

Para Alerta, use:

  sourceType = "Alert"
  minimalSeverity = "string"

Para AttackPath, use:

  sourceType = "AttackPath"
  minimalRiskLevel = "string"

Valores de propriedade

securityContacts

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Security/securityContacts@2023-12-01-preview"
name O nome do recurso "default"
parent_id Para implantar em uma assinatura, use a ID dessa assinatura. cadeia de caracteres (obrigatório)
properties Dados de contato de segurança SecurityContactProperties

SecurityContactProperties

Nome Descrição Valor
e-mails Lista de endereços de email que receberão notificações de Microsoft Defender para Nuvem pelas configurações definidas neste contato de segurança. string
isEnabled Indica se o contato de segurança está habilitado. bool
notificationsByRole Define se é necessário enviar notificações por email do Microsoft Defender for Cloud 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[]
phone O número de telefone do contato de segurança string

SecurityContactPropertiesNotificationsByRole

Nome Descrição Valor
funções Define quais funções RBAC obterão notificações por email de 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"
state Define se é necessário enviar notificações por email do AMicrosoft Defender para Nuvem para pessoas com funções RBAC específicas na assinatura. "Desativado"
"Ativado"

NotificationsSource

Nome Descrição Valor
sourceType Definir o tipo de objeto Alerta
AttackPath (obrigatório)

NotificationsSourceAlert

Nome Descrição Valor
sourceType O tipo de origem que disparará a notificação "Alerta" (obrigatório)
minimalSeverity Define a gravidade mínima do alerta que será enviada como notificações por email "High"
"Low"
"Médio"

NotificationsSourceAttackPath

Nome Descrição Valor
sourceType O tipo de origem que disparará a notificação "AttackPath" (obrigatório)
minimalRiskLevel Define o nível mínimo de risco do caminho de anexação que será enviado como notificações por email "Crítico"
"High"
"Low"
"Médio"