Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
- più recenti
- 2023-12-01-preview
- 2020-01-01-preview
- Anteprima 2017-08-01
Definizione di risorsa Bicep
Il tipo di risorsa securityContacts può essere distribuito con operazioni destinate a:
- sottoscrizione di
- Vedere i comandi di distribuzione delle sottoscrizioni
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.Security/securityContacts, aggiungere il bicep seguente al modello.
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'
}
}
Oggetti NotificationsSource
Impostare la proprietà sourceType
Per Avviso, usare:
{
minimalSeverity: 'string'
sourceType: 'Alert'
}
Per AttackPath, usare:
{
minimalRiskLevel: 'string'
sourceType: 'AttackPath'
}
Valori delle proprietà
Microsoft.Security/securityContacts
| Nome | Descrizione | Valore |
|---|---|---|
| nome | Nome della risorsa | 'default' (obbligatorio) |
| proprietà | Dati dei contatti di sicurezza | SecurityContactProperties |
NotificationsSource
| Nome | Descrizione | Valore |
|---|---|---|
| tipo di sorgente | Impostare su "Avviso" per il tipo NotificationsSourceAlert. Impostare su "AttackPath" per il tipo NotificationsSourceAttackPath. | 'Alert' 'AttackPath' (obbligatorio) |
NotificationsSourceAlert
| Nome | Descrizione | Valore |
|---|---|---|
| minimalSeverity | Definisce la gravità minima dell'avviso che verrà inviata come notifiche tramite posta elettronica | 'Alto' 'Basso' 'Medium' |
| tipo di sorgente | Tipo di origine che attiverà la notifica | 'Alert' (obbligatorio) |
NotificationsSourceAttackPath
| Nome | Descrizione | Valore |
|---|---|---|
| minimalRiskLevel | Definisce il livello di rischio minimo del percorso di collegamento che verrà inviato come notifiche tramite posta elettronica | 'Critico' 'Alto' 'Basso' 'Medium' |
| tipo di sorgente | Tipo di origine che attiverà la notifica | 'AttackPath' (obbligatorio) |
SecurityContactProperties
| Nome | Descrizione | Valore |
|---|---|---|
| messaggi di posta elettronica | Elenco di indirizzi di posta elettronica che riceveranno notifiche da Microsoft Defender per il cloud dalle configurazioni definite in questo contatto di sicurezza. | corda |
| èAbilitato | Indica se il contatto di sicurezza è abilitato. | Bool |
| notificationsByRole | Definisce se inviare notifiche tramite posta elettronica da Microsoft Defender per il cloud a persone con ruoli di controllo degli accessi in base al ruolo specifici nella sottoscrizione. | SecurityContactPropertiesNotificationsByRole |
| notificationsSources | Raccolta di tipi di origini che valutano la notifica tramite posta elettronica. | NotificationsSource[] |
| Telefono | Numero di telefono del contatto di sicurezza | corda |
SecurityContactPropertiesNotificationsByRole
| Nome | Descrizione | Valore |
|---|---|---|
| Ruoli | Definisce i ruoli controllo degli accessi in base al ruolo che riceveranno notifiche tramite posta elettronica da Microsoft Defender per il cloud. Elenco dei ruoli controllo degli accessi in base al ruolo consentiti: | Matrice di stringhe contenente uno dei seguenti elementi: 'AccountAdmin' 'Collaboratore' 'Owner' 'ServiceAdmin' |
| stato | Definisce se inviare notifiche tramite posta elettronica da AMicrosoft Defender per il cloud a persone con ruoli di controllo degli accessi in base al ruolo specifici nella sottoscrizione. | 'Failed' 'Off' 'On' 'Passato' 'Skipped' 'Non supportato' |
Esempi di utilizzo
Esempi bicep
Esempio di base della distribuzione del contatto del Centro sicurezza della sottoscrizione.
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'
}
}
Definizione di risorsa del modello di Resource Manager
Il tipo di risorsa securityContacts può essere distribuito con operazioni destinate a:
- sottoscrizione di
- Vedere i comandi di distribuzione delle sottoscrizioni
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.Security/securityContacts, aggiungere il codice JSON seguente al modello.
{
"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"
}
}
Oggetti NotificationsSource
Impostare la proprietà sourceType
Per Avviso, usare:
{
"minimalSeverity": "string",
"sourceType": "Alert"
}
Per AttackPath, usare:
{
"minimalRiskLevel": "string",
"sourceType": "AttackPath"
}
Valori delle proprietà
Microsoft.Security/securityContacts
| Nome | Descrizione | Valore |
|---|---|---|
| apiVersion | Versione dell'API | '2023-12-01-preview' |
| nome | Nome della risorsa | 'default' (obbligatorio) |
| proprietà | Dati dei contatti di sicurezza | SecurityContactProperties |
| digitare | Tipo di risorsa | 'Microsoft.Security/securityContacts' |
NotificationsSource
| Nome | Descrizione | Valore |
|---|---|---|
| tipo di sorgente | Impostare su "Avviso" per il tipo NotificationsSourceAlert. Impostare su "AttackPath" per il tipo NotificationsSourceAttackPath. | 'Alert' 'AttackPath' (obbligatorio) |
NotificationsSourceAlert
| Nome | Descrizione | Valore |
|---|---|---|
| minimalSeverity | Definisce la gravità minima dell'avviso che verrà inviata come notifiche tramite posta elettronica | 'Alto' 'Basso' 'Medium' |
| tipo di sorgente | Tipo di origine che attiverà la notifica | 'Alert' (obbligatorio) |
NotificationsSourceAttackPath
| Nome | Descrizione | Valore |
|---|---|---|
| minimalRiskLevel | Definisce il livello di rischio minimo del percorso di collegamento che verrà inviato come notifiche tramite posta elettronica | 'Critico' 'Alto' 'Basso' 'Medium' |
| tipo di sorgente | Tipo di origine che attiverà la notifica | 'AttackPath' (obbligatorio) |
SecurityContactProperties
| Nome | Descrizione | Valore |
|---|---|---|
| messaggi di posta elettronica | Elenco di indirizzi di posta elettronica che riceveranno notifiche da Microsoft Defender per il cloud dalle configurazioni definite in questo contatto di sicurezza. | corda |
| èAbilitato | Indica se il contatto di sicurezza è abilitato. | Bool |
| notificationsByRole | Definisce se inviare notifiche tramite posta elettronica da Microsoft Defender per il cloud a persone con ruoli di controllo degli accessi in base al ruolo specifici nella sottoscrizione. | SecurityContactPropertiesNotificationsByRole |
| notificationsSources | Raccolta di tipi di origini che valutano la notifica tramite posta elettronica. | NotificationsSource[] |
| Telefono | Numero di telefono del contatto di sicurezza | corda |
SecurityContactPropertiesNotificationsByRole
| Nome | Descrizione | Valore |
|---|---|---|
| Ruoli | Definisce i ruoli controllo degli accessi in base al ruolo che riceveranno notifiche tramite posta elettronica da Microsoft Defender per il cloud. Elenco dei ruoli controllo degli accessi in base al ruolo consentiti: | Matrice di stringhe contenente uno dei seguenti elementi: 'AccountAdmin' 'Collaboratore' 'Owner' 'ServiceAdmin' |
| stato | Definisce se inviare notifiche tramite posta elettronica da AMicrosoft Defender per il cloud a persone con ruoli di controllo degli accessi in base al ruolo specifici nella sottoscrizione. | 'Failed' 'Off' 'On' 'Passato' 'Skipped' 'Non supportato' |
Esempi di utilizzo
Definizione di risorsa Terraform (provider AzAPI)
Il tipo di risorsa securityContacts può essere distribuito con operazioni destinate a:
- Subscription
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.Security/securityContacts, aggiungere il codice Terraform seguente al modello.
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"
}
}
}
Oggetti NotificationsSource
Impostare la proprietà sourceType
Per Avviso, usare:
{
minimalSeverity = "string"
sourceType = "Alert"
}
Per AttackPath, usare:
{
minimalRiskLevel = "string"
sourceType = "AttackPath"
}
Valori delle proprietà
Microsoft.Security/securityContacts
| Nome | Descrizione | Valore |
|---|---|---|
| nome | Nome della risorsa | 'default' (obbligatorio) |
| proprietà | Dati dei contatti di sicurezza | SecurityContactProperties |
| digitare | Tipo di risorsa | "Microsoft.Security/securityContacts@2023-12-01-preview" |
NotificationsSource
| Nome | Descrizione | Valore |
|---|---|---|
| tipo di sorgente | Impostare su "Avviso" per il tipo NotificationsSourceAlert. Impostare su "AttackPath" per il tipo NotificationsSourceAttackPath. | 'Alert' 'AttackPath' (obbligatorio) |
NotificationsSourceAlert
| Nome | Descrizione | Valore |
|---|---|---|
| minimalSeverity | Definisce la gravità minima dell'avviso che verrà inviata come notifiche tramite posta elettronica | 'Alto' 'Basso' 'Medium' |
| tipo di sorgente | Tipo di origine che attiverà la notifica | 'Alert' (obbligatorio) |
NotificationsSourceAttackPath
| Nome | Descrizione | Valore |
|---|---|---|
| minimalRiskLevel | Definisce il livello di rischio minimo del percorso di collegamento che verrà inviato come notifiche tramite posta elettronica | 'Critico' 'Alto' 'Basso' 'Medium' |
| tipo di sorgente | Tipo di origine che attiverà la notifica | 'AttackPath' (obbligatorio) |
SecurityContactProperties
| Nome | Descrizione | Valore |
|---|---|---|
| messaggi di posta elettronica | Elenco di indirizzi di posta elettronica che riceveranno notifiche da Microsoft Defender per il cloud dalle configurazioni definite in questo contatto di sicurezza. | corda |
| èAbilitato | Indica se il contatto di sicurezza è abilitato. | Bool |
| notificationsByRole | Definisce se inviare notifiche tramite posta elettronica da Microsoft Defender per il cloud a persone con ruoli di controllo degli accessi in base al ruolo specifici nella sottoscrizione. | SecurityContactPropertiesNotificationsByRole |
| notificationsSources | Raccolta di tipi di origini che valutano la notifica tramite posta elettronica. | NotificationsSource[] |
| Telefono | Numero di telefono del contatto di sicurezza | corda |
SecurityContactPropertiesNotificationsByRole
| Nome | Descrizione | Valore |
|---|---|---|
| Ruoli | Definisce i ruoli controllo degli accessi in base al ruolo che riceveranno notifiche tramite posta elettronica da Microsoft Defender per il cloud. Elenco dei ruoli controllo degli accessi in base al ruolo consentiti: | Matrice di stringhe contenente uno dei seguenti elementi: 'AccountAdmin' 'Collaboratore' 'Owner' 'ServiceAdmin' |
| stato | Definisce se inviare notifiche tramite posta elettronica da AMicrosoft Defender per il cloud a persone con ruoli di controllo degli accessi in base al ruolo specifici nella sottoscrizione. | 'Failed' 'Off' 'On' 'Passato' 'Skipped' 'Non supportato' |
Esempi di utilizzo
Esempi di Terraform
Esempio di base della distribuzione del contatto del Centro sicurezza della sottoscrizione.
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 = ["*"]
}