Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Definição de recursos do bíceps
O tipo de recurso securityContacts pode ser implantado com operações que visam:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.Security/securityContacts, adicione o seguinte Bicep 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, utilize:
{
minimalSeverity: 'string'
sourceType: 'Alert'
}
Para AttackPath, use:
{
minimalRiskLevel: 'string'
sourceType: 'AttackPath'
}
Valores de propriedade
Microsoft.Security/securityContactos
| Designação | Descrição | Valor |
|---|---|---|
| Designação | O nome do recurso | 'default' (obrigatório) |
| propriedades | Dados de contacto de segurança | SecurityContactProperties |
| âmbito | 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 . |
NotificaçõesOrigem
| Designação | Descrição | Valor |
|---|---|---|
| Tipo de fonte | Defina como 'Alert' para o tipo NotificationsSourceAlert. Defina como 'AttackPath' para o tipo NotificationsSourceAttackPath. | 'Alerta' 'AttackPath' (obrigatório) |
NotificationsSourceAlert
| Designação | Descrição | Valor |
|---|---|---|
| gravidade mínima | Define a severidade mínima do alerta que será enviada como notificações por e-mail | 'Alta' 'Baixa' 'Médio' |
| Tipo de fonte | O tipo de fonte que acionará a notificação | 'Alerta' (obrigatório) |
NotificationsSourceAttackPath
| Designação | Descrição | Valor |
|---|---|---|
| MinimalRiskLevel | Define o nível mínimo de risco do caminho de anexação que será enviado como notificações por e-mail | 'Crítica' 'Alta' 'Baixa' 'Médio' |
| Tipo de fonte | O tipo de fonte que acionará a notificação | 'AttackPath' (obrigatório) |
SecurityContactProperties
| Designação | Descrição | Valor |
|---|---|---|
| E-mails | Lista de endereços de e-mail que receberão notificações do Microsoft Defender for Cloud pelas configurações definidas neste contato de segurança. | cadeia (de caracteres) |
| estáAtivado | Indica se o contato de segurança está habilitado. | Bool |
| notificaçõesPorFunção | Define se as notificações por email do Microsoft Defender for Cloud devem ser enviadas para pessoas com funções RBAC específicas na assinatura. | SecurityContactPropertiesNotificationsByRole |
| notificaçõesFontes | Uma coleção de tipos de fontes que avaliam a notificação por e-mail. | NotificaçõesFonte[] |
| Telefone | O número de telefone do contacto de segurança | cadeia (de caracteres) |
SecurityContactPropertiesNotificationsByRole
| Designação | 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 contendo qualquer uma das: 'AccountAdmin' 'Contribuidor' 'Proprietário' 'ServiceAdmin' |
| Estado | Define se as notificações por e-mail devem ser enviadas do AMicrosoft Defender for Cloud para pessoas com funções RBAC específicas na assinatura. | 'Desligado' 'Ligado' |
Definição de recurso de modelo ARM
O tipo de recurso securityContacts pode ser implantado com operações que visam:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.Security/securityContacts, adicione o seguinte JSON ao seu 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, utilize:
{
"minimalSeverity": "string",
"sourceType": "Alert"
}
Para AttackPath, use:
{
"minimalRiskLevel": "string",
"sourceType": "AttackPath"
}
Valores de propriedade
Microsoft.Security/securityContactos
| Designação | Descrição | Valor |
|---|---|---|
| Versão da API | A versão api | '2023-12-01-pré-visualização' |
| Designação | O nome do recurso | 'default' (obrigatório) |
| propriedades | Dados de contacto de segurança | SecurityContactProperties |
| tipo | O tipo de recurso | 'Microsoft.Security/securityContacts' |
NotificaçõesOrigem
| Designação | Descrição | Valor |
|---|---|---|
| Tipo de fonte | Defina como 'Alert' para o tipo NotificationsSourceAlert. Defina como 'AttackPath' para o tipo NotificationsSourceAttackPath. | 'Alerta' 'AttackPath' (obrigatório) |
NotificationsSourceAlert
| Designação | Descrição | Valor |
|---|---|---|
| gravidade mínima | Define a severidade mínima do alerta que será enviada como notificações por e-mail | 'Alta' 'Baixa' 'Médio' |
| Tipo de fonte | O tipo de fonte que acionará a notificação | 'Alerta' (obrigatório) |
NotificationsSourceAttackPath
| Designação | Descrição | Valor |
|---|---|---|
| MinimalRiskLevel | Define o nível mínimo de risco do caminho de anexação que será enviado como notificações por e-mail | 'Crítica' 'Alta' 'Baixa' 'Médio' |
| Tipo de fonte | O tipo de fonte que acionará a notificação | 'AttackPath' (obrigatório) |
SecurityContactProperties
| Designação | Descrição | Valor |
|---|---|---|
| E-mails | Lista de endereços de e-mail que receberão notificações do Microsoft Defender for Cloud pelas configurações definidas neste contato de segurança. | cadeia (de caracteres) |
| estáAtivado | Indica se o contato de segurança está habilitado. | Bool |
| notificaçõesPorFunção | Define se as notificações por email do Microsoft Defender for Cloud devem ser enviadas para pessoas com funções RBAC específicas na assinatura. | SecurityContactPropertiesNotificationsByRole |
| notificaçõesFontes | Uma coleção de tipos de fontes que avaliam a notificação por e-mail. | NotificaçõesFonte[] |
| Telefone | O número de telefone do contacto de segurança | cadeia (de caracteres) |
SecurityContactPropertiesNotificationsByRole
| Designação | 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 contendo qualquer uma das: 'AccountAdmin' 'Contribuidor' 'Proprietário' 'ServiceAdmin' |
| Estado | Define se as notificações por e-mail devem ser enviadas do AMicrosoft Defender for Cloud para pessoas com funções RBAC específicas na assinatura. | 'Desligado' 'Ligado' |
Exemplos de uso
Definição de recursos Terraform (provedor AzAPI)
O tipo de recurso securityContacts pode ser implantado com operações que visam:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.Security/securityContacts, adicione o seguinte Terraform 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, utilize:
{
minimalSeverity = "string"
sourceType = "Alert"
}
Para AttackPath, use:
{
minimalRiskLevel = "string"
sourceType = "AttackPath"
}
Valores de propriedade
Microsoft.Security/securityContactos
| Designação | Descrição | Valor |
|---|---|---|
| Designação | O nome do recurso | 'default' (obrigatório) |
| parent_id | A ID do recurso ao qual aplicar esse recurso de extensão. | string (obrigatório) |
| propriedades | Dados de contacto de segurança | SecurityContactProperties |
| tipo | O tipo de recurso | "Microsoft.Security/securityContacts@2023-12-01-preview" |
NotificaçõesOrigem
| Designação | Descrição | Valor |
|---|---|---|
| Tipo de fonte | Defina como 'Alert' para o tipo NotificationsSourceAlert. Defina como 'AttackPath' para o tipo NotificationsSourceAttackPath. | 'Alerta' 'AttackPath' (obrigatório) |
NotificationsSourceAlert
| Designação | Descrição | Valor |
|---|---|---|
| gravidade mínima | Define a severidade mínima do alerta que será enviada como notificações por e-mail | 'Alta' 'Baixa' 'Médio' |
| Tipo de fonte | O tipo de fonte que acionará a notificação | 'Alerta' (obrigatório) |
NotificationsSourceAttackPath
| Designação | Descrição | Valor |
|---|---|---|
| MinimalRiskLevel | Define o nível mínimo de risco do caminho de anexação que será enviado como notificações por e-mail | 'Crítica' 'Alta' 'Baixa' 'Médio' |
| Tipo de fonte | O tipo de fonte que acionará a notificação | 'AttackPath' (obrigatório) |
SecurityContactProperties
| Designação | Descrição | Valor |
|---|---|---|
| E-mails | Lista de endereços de e-mail que receberão notificações do Microsoft Defender for Cloud pelas configurações definidas neste contato de segurança. | cadeia (de caracteres) |
| estáAtivado | Indica se o contato de segurança está habilitado. | Bool |
| notificaçõesPorFunção | Define se as notificações por email do Microsoft Defender for Cloud devem ser enviadas para pessoas com funções RBAC específicas na assinatura. | SecurityContactPropertiesNotificationsByRole |
| notificaçõesFontes | Uma coleção de tipos de fontes que avaliam a notificação por e-mail. | NotificaçõesFonte[] |
| Telefone | O número de telefone do contacto de segurança | cadeia (de caracteres) |
SecurityContactPropertiesNotificationsByRole
| Designação | 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 contendo qualquer uma das: 'AccountAdmin' 'Contribuidor' 'Proprietário' 'ServiceAdmin' |
| Estado | Define se as notificações por e-mail devem ser enviadas do AMicrosoft Defender for Cloud para pessoas com funções RBAC específicas na assinatura. | 'Desligado' 'Ligado' |
Exemplos de uso
Amostras 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 = ["*"]
}