Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Definição de recursos do bíceps
O tipo de recurso securityContacts pode ser implantado com operações que visam:
- de Subscrição - Consulte comandos de implementação de subscrição
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Exemplos de uso
Amostras de bíceps
Um exemplo básico de implantação do Contato da Central de Segurança da assinatura.
targetScope = 'subscription'
param resourceName string = 'acctest0001'
param location string = 'eastus'
resource securityContact 'Microsoft.Security/securityContacts@2017-08-01-preview' = {
name: resourceName
properties: {
alertNotifications: 'On'
alertsToAdmins: 'On'
email: 'basic@example.com'
phone: '+1-555-555-5555'
}
}
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' = {
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 |
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 para a 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 para a 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 para a 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 para a Cloud para pessoas com funções RBAC específicas na assinatura. | 'Failed' 'Desligado' 'Ligado' 'Aprovado' 'Skipped' 'Sem apoio' |
Definição de recurso de modelo ARM
O tipo de recurso securityContacts pode ser implantado com operações que visam:
- Subscrição - Consulte comandos de implementação por subscrição Para uma lista de propriedades alteradas em cada versão da API, consulte registo de alterações.
Exemplos de uso
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 para a 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 para a 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 para a 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 para a Cloud para pessoas com funções RBAC específicas na assinatura. | 'Failed' 'Desligado' 'Ligado' 'Aprovado' 'Skipped' 'Sem apoio' |
Definição de recursos Terraform (provedor AzAPI)
O tipo de recurso securityContacts pode ser implantado com operações que visam:
- Subscrição Para uma lista das propriedades alteradas em cada versão da API, veja registo de alterações.
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 = ["*"]
}
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) |
| 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 para a 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 para a 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 para a 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 para a Cloud para pessoas com funções RBAC específicas na assinatura. | 'Failed' 'Desligado' 'Ligado' 'Aprovado' 'Skipped' 'Sem apoio' |