Microsoft.Security securityContacts

  • Articolo

Definizione di risorsa Bicep

Il tipo di risorsa securityContacts può essere distribuito con operazioni destinate a:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Security/securityContacts, aggiungere il bicep seguente al modello.

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

Oggetti NotificationsSource

Impostare la proprietà sourceType per specificare il tipo di oggetto.

Per Avviso, usare:

  sourceType: 'Alert'
  minimalSeverity: 'string'

Per AttackPath, usare:

  sourceType: 'AttackPath'
  minimalRiskLevel: 'string'

Valori delle proprietà

securityContacts

Nome Descrizione valore
name Nome della risorsa 'default'
properties Dati dei contatti di sicurezza SecurityContactProperties

SecurityContactProperties

Nome Descrizione Valore
emails Elenco di indirizzi di posta elettronica che riceveranno notifiche da Microsoft Defender for Cloud dalle configurazioni definite in questo contatto di sicurezza. string
isEnabled Indica se il contatto di sicurezza è abilitato. bool
notificationsByRole Definisce se inviare notifiche tramite posta elettronica da Microsoft Defender per 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[]
phone Numero di telefono del contatto di sicurezza string

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 cloud. Elenco dei ruoli controllo degli accessi in base al ruolo consentiti: Matrice di stringhe contenente uno dei seguenti elementi:
'AccountAdmin'
'Collaboratore'
'Owner'
'ServiceAdmin'
state Definisce se inviare notifiche tramite posta elettronica da AMicrosoft Defender for Cloud a persone con ruoli RBAC specifici nella sottoscrizione. 'Off'
'On'

NotificationsSource

Nome Descrizione Valore
sourceType Impostare il tipo di oggetto Avviso
AttackPath (obbligatorio)

NotificationsSourceAlert

Nome Descrizione Valore
sourceType Tipo di origine che attiverà la notifica 'Alert' (obbligatorio)
minimalSeverity Definisce la gravità minima dell'avviso che verrà inviata come notifiche tramite posta elettronica 'Alto'
'Low'
'Medium'

NotificationsSourceAttackPath

Nome Descrizione Valore
sourceType Tipo di origine che attiverà la notifica 'AttackPath' (obbligatorio)
minimalRiskLevel Definisce il livello di rischio minimo del percorso di collegamento che verrà inviato come notifiche tramite posta elettronica 'Critico'
'Alto'
'Low'
'Medium'

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa securityContacts può essere distribuito con operazioni destinate a:

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di 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": "default",
  "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 specificare il tipo di oggetto.

Per Avviso, usare:

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

Per AttackPath, usare:

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

Valori delle proprietà

securityContacts

Nome Descrizione Valore
tipo Tipo di risorsa 'Microsoft.Security/securityContacts'
apiVersion Versione dell'API risorsa '2023-12-01-preview'
name Nome della risorsa 'default'
properties Dati dei contatti di sicurezza SecurityContactProperties

SecurityContactProperties

Nome Descrizione Valore
emails Elenco di indirizzi di posta elettronica che riceveranno notifiche da Microsoft Defender per Cloud dalle configurazioni definite in questo contatto di sicurezza. string
isEnabled Indica se il contatto di sicurezza è abilitato. bool
notificationsByRole Definisce se inviare notifiche tramite posta elettronica da Microsoft Defender per 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 di posta elettronica. NotificationsSource[]
phone Numero di telefono del contatto di sicurezza string

SecurityContactPropertiesNotificationsByRole

Nome Descrizione Valore
Ruoli Definisce i ruoli di controllo degli accessi in base al ruolo che riceveranno notifiche tramite posta elettronica da Microsoft Defender per Cloud. Elenco dei ruoli di controllo degli accessi in base al ruolo consentiti: Matrice di stringhe contenente uno qualsiasi di:
'AccountAdmin'
'Collaboratore'
'Proprietario'
'ServiceAdmin'
state Definisce se inviare notifiche di posta elettronica da AMicrosoft Defender for Cloud a persone con ruoli di controllo degli accessi in base al ruolo specifici nella sottoscrizione. 'Off'
'On'

NotificationsSource

Nome Descrizione Valore
sourceType Impostare il tipo di oggetto Avviso
AttackPath (obbligatorio)

NotificationsSourceAlert

Nome Descrizione Valore
sourceType Tipo di origine che attiverà la notifica 'Avviso' (obbligatorio)
minimalSeverity Definisce la gravità minima dell'avviso che verrà inviata come notifiche tramite posta elettronica 'High'
'Basso'
'Medium'

NotificationsSourceAttackPath

Nome Descrizione Valore
sourceType Tipo di origine che attiverà la notifica 'AttackPath' (obbligatorio)
minimalRiskLevel Definisce il livello di rischio minimo del percorso di collegamento che verrà inviato come notifiche tramite posta elettronica 'Critico'
'High'
'Basso'
'Medium'

Definizione della risorsa Terraform (provider AzAPI)

Il tipo di risorsa securityContacts può essere distribuito con operazioni destinate:

  • Sottoscrizioni

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato di risorsa

Per creare una risorsa Microsoft.Security/securityContacts, aggiungere il modello terraform seguente.

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

Oggetti NotificationsSource

Impostare la proprietà sourceType per specificare il tipo di oggetto.

Per Avviso, usare:

  sourceType = "Alert"
  minimalSeverity = "string"

Per AttackPath, usare:

  sourceType = "AttackPath"
  minimalRiskLevel = "string"

Valori delle proprietà

securityContacts

Nome Descrizione Valore
tipo Tipo di risorsa "Microsoft.Security/securityContacts@2023-12-01-preview"
name Nome della risorsa "default"
parent_id Per eseguire la distribuzione in una sottoscrizione, usare l'ID della sottoscrizione. stringa (obbligatorio)
properties Dati dei contatti di sicurezza SecurityContactProperties

SecurityContactProperties

Nome Descrizione Valore
emails Elenco di indirizzi di posta elettronica che riceveranno notifiche da Microsoft Defender for Cloud dalle configurazioni definite in questo contatto di sicurezza. string
isEnabled Indica se il contatto di sicurezza è abilitato. bool
notificationsByRole Definisce se inviare notifiche tramite posta elettronica da Microsoft Defender per 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[]
phone Numero di telefono del contatto di sicurezza string

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 cloud. Elenco dei ruoli controllo degli accessi in base al ruolo consentiti: Matrice di stringhe contenente uno dei seguenti elementi:
"AccountAdmin"
"Collaboratore"
"Proprietario"
"ServiceAdmin"
state Definisce se inviare notifiche tramite posta elettronica da AMicrosoft Defender for Cloud a persone con ruoli RBAC specifici nella sottoscrizione. "Off"
"Attivato"

NotificationsSource

Nome Descrizione Valore
sourceType Impostare il tipo di oggetto Avviso
AttackPath (obbligatorio)

NotificationsSourceAlert

Nome Descrizione Valore
sourceType Tipo di origine che attiverà la notifica "Avviso" (obbligatorio)
minimalSeverity Definisce la gravità minima dell'avviso che verrà inviata come notifiche tramite posta elettronica "High"
"Low"
"Medio"

NotificationsSourceAttackPath

Nome Descrizione Valore
sourceType Tipo di origine che attiverà la notifica "AttackPath" (obbligatorio)
minimalRiskLevel Definisce il livello di rischio minimo del percorso di collegamento che verrà inviato come notifiche tramite posta elettronica "Critico"
"High"
"Low"
"Medio"