Freigeben über


Microsoft.Security SecurityContacts

Bicep-Ressourcendefinition

Der SecurityContacts-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Security/securityContacts-Ressource zu erstellen, fügen Sie Der Vorlage den folgenden Bicep hinzu.

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

NotificationsSource-Objekte

Legen Sie die sourceType-eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für Warnungs-:

{
  minimalSeverity: 'string'
  sourceType: 'Alert'
}

Verwenden Sie für AttackPath-:

{
  minimalRiskLevel: 'string'
  sourceType: 'AttackPath'
}

Eigenschaftswerte

Microsoft.Security/securityContacts

Name Beschreibung Wert
Name Der Ressourcenname "default" (erforderlich)
Eigenschaften Sicherheitskontaktdaten SecurityContactProperties
scope Verwenden Sie diese Verwendung beim Erstellen einer Ressource in einem Bereich, der sich von dem Bereitstellungsbereich unterscheidet. Legen Sie diese Eigenschaft auf den symbolischen Namen einer Ressource fest, um die Erweiterungsressourceanzuwenden.

NotificationsSource

Name Beschreibung Wert
Quellentyp "Warnung" für den Typ "NotificationsSourceAlert" festgelegt. Legen Sie für den Typ NotificationsSourceAttackPathauf "AttackPath" fest. "Warnung"
'AttackPath' (erforderlich)

NotificationsSourceAlert

Name Beschreibung Wert
Minimalität Definiert den minimalen Warnungsschweregrad, der als E-Mail-Benachrichtigungen gesendet wird. "Hoch"
"Niedrig"
"Mittel"
Quellentyp Der Quelltyp, der die Benachrichtigung auslöst "Warnung" (erforderlich)

NotificationsSourceAttackPath

Name Beschreibung Wert
minimalRiskLevel Definiert die minimale Risikostufe des Anfügungspfads, die als E-Mail-Benachrichtigungen gesendet wird. "Kritisch"
"Hoch"
"Niedrig"
"Mittel"
Quellentyp Der Quelltyp, der die Benachrichtigung auslöst 'AttackPath' (erforderlich)

SecurityContactProperties

Name Beschreibung Wert
E-Mails Liste der E-Mail-Adressen, die Benachrichtigungen von Microsoft Defender für Cloud erhalten, anhand der konfigurationen, die in diesem Sicherheitskontakt definiert sind. Schnur
isEnabled Gibt an, ob der Sicherheitskontakt aktiviert ist. Bool
notificationsByRole Definiert, ob E-Mail-Benachrichtigungen von Microsoft Defender for Cloud an Personen mit bestimmten RBAC-Rollen im Abonnement gesendet werden sollen. SecurityContactPropertiesNotificationsByRole
notificationsSources Eine Sammlung von Quellentypen, die die E-Mail-Benachrichtigung auswerten. NotificationsSource-[]
Telefon Telefonnummer des Sicherheitskontakts Schnur

SecurityContactPropertiesNotificationsByRole

Name Beschreibung Wert
Rollen Definiert, welche RBAC-Rollen E-Mail-Benachrichtigungen von Microsoft Defender für Cloud erhalten. Liste der zulässigen RBAC-Rollen: Zeichenfolgenarray, das eine der folgenden Elemente enthält:
'AccountAdmin'
"Mitwirkender"
"Besitzer"
'ServiceAdmin'
Zustand Definiert, ob E-Mail-Benachrichtigungen von AMicrosoft Defender for Cloud an Personen mit bestimmten RBAC-Rollen im Abonnement gesendet werden sollen. 'Aus'
"Ein"

ARM-Vorlagenressourcendefinition

Der SecurityContacts-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Security/securityContacts-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.

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

NotificationsSource-Objekte

Legen Sie die sourceType-eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für Warnungs-:

{
  "minimalSeverity": "string",
  "sourceType": "Alert"
}

Verwenden Sie für AttackPath-:

{
  "minimalRiskLevel": "string",
  "sourceType": "AttackPath"
}

Eigenschaftswerte

Microsoft.Security/securityContacts

Name Beschreibung Wert
apiVersion Die API-Version "2023-12-01-preview"
Name Der Ressourcenname "default" (erforderlich)
Eigenschaften Sicherheitskontaktdaten SecurityContactProperties
Art Der Ressourcentyp "Microsoft.Security/securityContacts"

NotificationsSource

Name Beschreibung Wert
Quellentyp "Warnung" für den Typ "NotificationsSourceAlert" festgelegt. Legen Sie für den Typ NotificationsSourceAttackPathauf "AttackPath" fest. "Warnung"
'AttackPath' (erforderlich)

NotificationsSourceAlert

Name Beschreibung Wert
Minimalität Definiert den minimalen Warnungsschweregrad, der als E-Mail-Benachrichtigungen gesendet wird. "Hoch"
"Niedrig"
"Mittel"
Quellentyp Der Quelltyp, der die Benachrichtigung auslöst "Warnung" (erforderlich)

NotificationsSourceAttackPath

Name Beschreibung Wert
minimalRiskLevel Definiert die minimale Risikostufe des Anfügungspfads, die als E-Mail-Benachrichtigungen gesendet wird. "Kritisch"
"Hoch"
"Niedrig"
"Mittel"
Quellentyp Der Quelltyp, der die Benachrichtigung auslöst 'AttackPath' (erforderlich)

SecurityContactProperties

Name Beschreibung Wert
E-Mails Liste der E-Mail-Adressen, die Benachrichtigungen von Microsoft Defender für Cloud erhalten, anhand der konfigurationen, die in diesem Sicherheitskontakt definiert sind. Schnur
isEnabled Gibt an, ob der Sicherheitskontakt aktiviert ist. Bool
notificationsByRole Definiert, ob E-Mail-Benachrichtigungen von Microsoft Defender for Cloud an Personen mit bestimmten RBAC-Rollen im Abonnement gesendet werden sollen. SecurityContactPropertiesNotificationsByRole
notificationsSources Eine Sammlung von Quellentypen, die die E-Mail-Benachrichtigung auswerten. NotificationsSource-[]
Telefon Telefonnummer des Sicherheitskontakts Schnur

SecurityContactPropertiesNotificationsByRole

Name Beschreibung Wert
Rollen Definiert, welche RBAC-Rollen E-Mail-Benachrichtigungen von Microsoft Defender für Cloud erhalten. Liste der zulässigen RBAC-Rollen: Zeichenfolgenarray, das eine der folgenden Elemente enthält:
'AccountAdmin'
"Mitwirkender"
"Besitzer"
'ServiceAdmin'
Zustand Definiert, ob E-Mail-Benachrichtigungen von AMicrosoft Defender for Cloud an Personen mit bestimmten RBAC-Rollen im Abonnement gesendet werden sollen. 'Aus'
"Ein"

Verwendungsbeispiele

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der SecurityContacts-Ressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.Security/securityContacts-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

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

NotificationsSource-Objekte

Legen Sie die sourceType-eigenschaft fest, um den Objekttyp anzugeben.

Verwenden Sie für Warnungs-:

{
  minimalSeverity = "string"
  sourceType = "Alert"
}

Verwenden Sie für AttackPath-:

{
  minimalRiskLevel = "string"
  sourceType = "AttackPath"
}

Eigenschaftswerte

Microsoft.Security/securityContacts

Name Beschreibung Wert
Name Der Ressourcenname "default" (erforderlich)
parent_id Die ID der Ressource, auf die diese Erweiterungsressource angewendet werden soll. Zeichenfolge (erforderlich)
Eigenschaften Sicherheitskontaktdaten SecurityContactProperties
Art Der Ressourcentyp "Microsoft.Security/securityContacts@2023-12-01-preview"

NotificationsSource

Name Beschreibung Wert
Quellentyp "Warnung" für den Typ "NotificationsSourceAlert" festgelegt. Legen Sie für den Typ NotificationsSourceAttackPathauf "AttackPath" fest. "Warnung"
'AttackPath' (erforderlich)

NotificationsSourceAlert

Name Beschreibung Wert
Minimalität Definiert den minimalen Warnungsschweregrad, der als E-Mail-Benachrichtigungen gesendet wird. "Hoch"
"Niedrig"
"Mittel"
Quellentyp Der Quelltyp, der die Benachrichtigung auslöst "Warnung" (erforderlich)

NotificationsSourceAttackPath

Name Beschreibung Wert
minimalRiskLevel Definiert die minimale Risikostufe des Anfügungspfads, die als E-Mail-Benachrichtigungen gesendet wird. "Kritisch"
"Hoch"
"Niedrig"
"Mittel"
Quellentyp Der Quelltyp, der die Benachrichtigung auslöst 'AttackPath' (erforderlich)

SecurityContactProperties

Name Beschreibung Wert
E-Mails Liste der E-Mail-Adressen, die Benachrichtigungen von Microsoft Defender für Cloud erhalten, anhand der konfigurationen, die in diesem Sicherheitskontakt definiert sind. Schnur
isEnabled Gibt an, ob der Sicherheitskontakt aktiviert ist. Bool
notificationsByRole Definiert, ob E-Mail-Benachrichtigungen von Microsoft Defender for Cloud an Personen mit bestimmten RBAC-Rollen im Abonnement gesendet werden sollen. SecurityContactPropertiesNotificationsByRole
notificationsSources Eine Sammlung von Quellentypen, die die E-Mail-Benachrichtigung auswerten. NotificationsSource-[]
Telefon Telefonnummer des Sicherheitskontakts Schnur

SecurityContactPropertiesNotificationsByRole

Name Beschreibung Wert
Rollen Definiert, welche RBAC-Rollen E-Mail-Benachrichtigungen von Microsoft Defender für Cloud erhalten. Liste der zulässigen RBAC-Rollen: Zeichenfolgenarray, das eine der folgenden Elemente enthält:
'AccountAdmin'
"Mitwirkender"
"Besitzer"
'ServiceAdmin'
Zustand Definiert, ob E-Mail-Benachrichtigungen von AMicrosoft Defender for Cloud an Personen mit bestimmten RBAC-Rollen im Abonnement gesendet werden sollen. 'Aus'
"Ein"

Verwendungsbeispiele

Terraform-Beispiele

Ein grundlegendes Beispiel für die Bereitstellung des Security Center-Kontakts eines Abonnements.

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    = ["*"]
}