Segurança Microsoft.SecurityContacts 2023-12-01-preview
Definição de recurso do Bicep
O tipo de recurso securityContacts pode ser implementado com operações que visam:
- Subscrições - Veja os comandos de implementação da subscrição
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo 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' = {
name: 'default'
properties: {
emails: 'string'
isEnabled: bool
notificationsByRole: {
roles: [
'string'
]
state: 'string'
}
notificationsSources: [
{
sourceType: 'string'
// For remaining properties, see NotificationsSource objects
}
]
phone: 'string'
}
}
NotificationsSource objects (Objetos NotificationsSource)
Defina a propriedade sourceType para especificar o tipo de objeto.
Para Alerta, utilize:
sourceType: 'Alert'
minimalSeverity: 'string'
Para AttackPath, utilize:
sourceType: 'AttackPath'
minimalRiskLevel: 'string'
Valores de propriedade
securityContacts
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso | "predefinição" |
| propriedades | Dados de contacto de segurança | SecurityContactProperties |
SecurityContactProperties
| Nome | Descrição | Valor |
|---|---|---|
| e-mails | Lista de endereços de e-mail que receberão notificações de Microsoft Defender para a Cloud pelas configurações definidas neste contacto de segurança. | string |
| isEnabled | Indica se o contacto de segurança está ativado. | bool |
| notificationsByRole | Define se pretende enviar notificações por e-mail de Microsoft Defender para a Cloud a pessoas com funções RBAC específicas na subscrição. | SecurityContactPropertiesNotificationsByRole |
| notificationsSources | Uma coleção de tipos de origens que avaliam a notificação por e-mail. | NotificationsSource[] |
| telefone | O número de telefone do contacto de segurança | string |
SecurityContactPropertiesNotificationsByRole
| Nome | Descrição | Valor |
|---|---|---|
| funções | Define as funções RBAC que irão receber notificações por e-mail do Microsoft Defender para a Cloud. Lista de funções RBAC permitidas: | Matriz de cadeias que contém qualquer um dos seguintes: "AccountAdmin" "Contribuidor" "Proprietário" "ServiceAdmin" |
| state | Define se pretende enviar notificações por e-mail do AMicrosoft Defender para a Cloud a pessoas com funções RBAC específicas na subscrição. | 'Desligado' '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 irá acionar a notificação | "Alerta" (obrigatório) |
| minimalSeverity | Define a gravidade mínima do alerta que será enviada como notificações por e-mail | 'Alto' 'Baixo' "Médio" |
NotificationsSourceAttackPath
| Nome | Descrição | Valor |
|---|---|---|
| sourceType | O tipo de origem que irá acionar a notificação | "AttackPath" (obrigatório) |
| minimalRiskLevel | Define o nível de risco de caminho de anexação mínimo que será enviado como notificações por e-mail | "Crítico" 'Alto' 'Baixo' "Médio" |
Definição de recurso de modelo do ARM
O tipo de recurso securityContacts pode ser implementado com operações que visam:
- Subscrições - Veja os comandos de implementação da subscrição
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo 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": "default",
"properties": {
"emails": "string",
"isEnabled": "bool",
"notificationsByRole": {
"roles": [ "string" ],
"state": "string"
},
"notificationsSources": [
{
"sourceType": "string"
// For remaining properties, see NotificationsSource objects
}
],
"phone": "string"
}
}
NotificationsSource objects (Objetos notificationsSource)
Defina a propriedade sourceType para especificar o tipo de objeto.
Para Alerta, utilize:
"sourceType": "Alert",
"minimalSeverity": "string"
Para AttackPath, utilize:
"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 | "predefinição" |
| propriedades | Dados de contacto de segurança | SecurityContactProperties |
SecurityContactProperties
| Nome | 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 contacto de segurança. | string |
| isEnabled | Indica se o contacto de segurança está ativado. | bool |
| notificationsByRole | Define se pretende enviar notificações por e-mail do Microsoft Defender da Cloud para pessoas com funções RBAC específicas na subscrição. | SecurityContactPropertiesNotificationsByRole |
| notificationsSources | Uma coleção de tipos de origens que avaliam a notificação por e-mail. | NotificationsSource[] |
| telefone | O número de telefone do contacto de segurança | string |
SecurityContactPropertiesNotificationsByRole
| Nome | Descrição | Valor |
|---|---|---|
| funções | Define quais as funções RBAC que irão receber notificações por e-mail do Microsoft Defender para a Cloud. Lista de funções RBAC permitidas: | Matriz de cadeia que contém qualquer um dos seguintes: "AccountAdmin" "Contribuidor" 'Proprietário' "ServiceAdmin" |
| state | Define se pretende enviar notificações por e-mail do AMicrosoft Defender para a Cloud a pessoas com funções RBAC específicas na subscrição. | '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 irá acionar a notificação | "Alerta" (obrigatório) |
| minimalSeverity | Define a gravidade mínima do alerta que será enviada como notificações por e-mail | 'Alto' "Baixa" "Médio" |
NotificationsSourceAttackPath
| Nome | Descrição | Valor |
|---|---|---|
| sourceType | O tipo de origem que irá acionar a notificação | "AttackPath" (obrigatório) |
| minimalRiskLevel | Define o nível de risco de caminho de anexação mínimo que será enviado como notificações por e-mail | "Crítico" 'Alto' "Baixa" "Médio" |
Definição de recurso terraform (fornecedor AzAPI)
O tipo de recurso securityContacts pode ser implementado com operações que visam:
- Subscrições
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo 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 = "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"
}
})
}
NotificationsSource objects (Objetos notificationsSource)
Defina a propriedade sourceType para especificar o tipo de objeto.
Para Alerta, utilize:
sourceType = "Alert"
minimalSeverity = "string"
Para AttackPath, utilize:
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 | "predefinição" |
| parent_id | Para implementar numa subscrição, utilize o ID dessa subscrição. | cadeia (obrigatório) |
| propriedades | Dados de contacto de segurança | SecurityContactProperties |
SecurityContactProperties
| Nome | Descrição | Valor |
|---|---|---|
| e-mails | Lista de endereços de e-mail que receberão notificações de Microsoft Defender para a Cloud pelas configurações definidas neste contacto de segurança. | string |
| isEnabled | Indica se o contacto de segurança está ativado. | bool |
| notificationsByRole | Define se pretende enviar notificações por e-mail de Microsoft Defender para a Cloud a pessoas com funções RBAC específicas na subscrição. | SecurityContactPropertiesNotificationsByRole |
| notificationsSources | Uma coleção de tipos de origens que avaliam a notificação por e-mail. | NotificationsSource[] |
| telefone | O número de telefone do contacto de segurança | string |
SecurityContactPropertiesNotificationsByRole
| Nome | Descrição | Valor |
|---|---|---|
| funções | Define as funções RBAC que irão receber notificações por e-mail do Microsoft Defender para a Cloud. Lista de funções RBAC permitidas: | Matriz de cadeias que contém qualquer um dos seguintes: "AccountAdmin" "Contribuidor" "Proprietário" "ServiceAdmin" |
| state | Define se pretende enviar notificações por e-mail do AMicrosoft Defender para a Cloud a pessoas com funções RBAC específicas na subscrição. | "Desligado" "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 irá acionar a notificação | "Alerta" (obrigatório) |
| minimalSeverity | Define a gravidade mínima do alerta que será enviada como notificações por e-mail | "Alto" "Baixo" "Médio" |
NotificationsSourceAttackPath
| Nome | Descrição | Valor |
|---|---|---|
| sourceType | O tipo de origem que irá acionar a notificação | "AttackPath" (obrigatório) |
| minimalRiskLevel | Define o nível de risco de caminho de anexação mínimo que será enviado como notificações por e-mail | "Crítico" "Alto" "Baixo" "Médio" |
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários