مشاركة عبر


Microsoft.Security جهات الاتصال

تعريف مورد Bicep

يمكن نشر نوع مورد securityContacts مع العمليات التي تستهدف:

  • الاشتراك - راجع أوامر نشر اشتراك

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

تنسيق المورد

لإنشاء مورد Microsoft.Security/securityContacts، أضف Bicep التالي إلى القالب الخاص بك.

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

كائنات NotificationsSource

قم بتعيين الخاصية sourceType لتحديد نوع الكائن.

بالنسبة التنبيه، استخدم:

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

بالنسبة AttackPath، استخدم:

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

قيم الخصائص

Microsoft.Security/securityContacts

اسم وصف قيمة
اسم اسم المورد "افتراضي" (مطلوب)
خصائص بيانات جهة اتصال الأمان SecurityContactProperties

مصدر الإعلامات

اسم وصف قيمة
نوع المصدر تعيين إلى "تنبيه" للنوع NotificationsSourceAlert. تعيين إلى 'AttackPath' لنوع NotificationsSourceAttackPath. "تنبيه"
'AttackPath' (مطلوب)

NotificationsSourceAlert

اسم وصف قيمة
الحد الأدنى من الحد الأدنى يحدد الحد الأدنى من خطورة التنبيه التي سيتم إرسالها كإشعارات عبر البريد الإلكتروني "مرتفع"
"منخفض"
'متوسط'
نوع المصدر نوع المصدر الذي سيقوم بتشغيل الإعلام "تنبيه" (مطلوب)

NotificationsSourceAttackPath

اسم وصف قيمة
الحد الأدنى لRiskLevel تحديد الحد الأدنى من مستوى مخاطر مسار الإرفاق الذي سيتم إرساله كإشعارات عبر البريد الإلكتروني "حرج"
"مرتفع"
"منخفض"
'متوسط'
نوع المصدر نوع المصدر الذي سيقوم بتشغيل الإعلام 'AttackPath' (مطلوب)

خصائص الأمان

اسم وصف قيمة
رسائل البريد الإلكتروني قائمة عناوين البريد الإلكتروني التي ستحصل على إعلامات من Microsoft Defender for Cloud بواسطة التكوينات المحددة في جهة اتصال الأمان هذه. خيط
isEnabled يشير إلى ما إذا كان قد تم تمكين جهة اتصال الأمان. قيمة منطقية
notificationsByRole يحدد ما إذا كان يجب إرسال إشعارات البريد الإلكتروني من Microsoft Defender for Cloud إلى أشخاص ذوي أدوار RBAC محددة في الاشتراك. SecurityContactPropertiesNotificationsByRole
مصادر الإعلامات مجموعة من أنواع المصادر التي تقيم إعلام البريد الإلكتروني. NotificationsSource []
الهاتف رقم هاتف جهة اتصال الأمان خيط

SecurityContactPropertiesNotificationsByRole

اسم وصف قيمة
ادوار يحدد أدوار التحكم في الوصول استنادا إلى الدور التي ستحصل على إشعارات البريد الإلكتروني من Microsoft Defender for Cloud. قائمة بأدوار التحكم في الوصول استنادا إلى الدور المسموح بها: صفيف سلسلة يحتوي على أي من:
"مسؤول الحساب"
"المساهم"
"المالك"
"مسؤول الخدمة"
حالة يحدد ما إذا كان يجب إرسال إشعارات البريد الإلكتروني من AMicrosoft Defender for Cloud إلى الأشخاص الذين يعانون من أدوار RBAC محددة في الاشتراك. "إيقاف التشغيل"
'تشغيل'

أمثلة الاستخدام

عينات Bicep

مثال أساسي لنشر جهة اتصال مركز الأمان الخاصة بالاشتراك.

targetScope = 'subscription'

param resourceName string = 'acctest0001'

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

تعريف مورد قالب ARM

يمكن نشر نوع مورد securityContacts مع العمليات التي تستهدف:

  • الاشتراك - راجع أوامر نشر اشتراك

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

تنسيق المورد

لإنشاء مورد Microsoft.Security/securityContacts، أضف JSON التالي إلى القالب الخاص بك.

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

قم بتعيين الخاصية sourceType لتحديد نوع الكائن.

بالنسبة التنبيه، استخدم:

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

بالنسبة AttackPath، استخدم:

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

قيم الخصائص

Microsoft.Security/securityContacts

اسم وصف قيمة
apiVersion إصدار واجهة برمجة التطبيقات 'معاينة 2023-12-01'
اسم اسم المورد "افتراضي" (مطلوب)
خصائص بيانات جهة اتصال الأمان SecurityContactProperties
نوع نوع المورد 'Microsoft.Security/securityContacts'

مصدر الإعلامات

اسم وصف قيمة
نوع المصدر تعيين إلى "تنبيه" للنوع NotificationsSourceAlert. تعيين إلى 'AttackPath' لنوع NotificationsSourceAttackPath. "تنبيه"
'AttackPath' (مطلوب)

NotificationsSourceAlert

اسم وصف قيمة
الحد الأدنى من الحد الأدنى يحدد الحد الأدنى من خطورة التنبيه التي سيتم إرسالها كإشعارات عبر البريد الإلكتروني "مرتفع"
"منخفض"
'متوسط'
نوع المصدر نوع المصدر الذي سيقوم بتشغيل الإعلام "تنبيه" (مطلوب)

NotificationsSourceAttackPath

اسم وصف قيمة
الحد الأدنى لRiskLevel تحديد الحد الأدنى من مستوى مخاطر مسار الإرفاق الذي سيتم إرساله كإشعارات عبر البريد الإلكتروني "حرج"
"مرتفع"
"منخفض"
'متوسط'
نوع المصدر نوع المصدر الذي سيقوم بتشغيل الإعلام 'AttackPath' (مطلوب)

خصائص الأمان

اسم وصف قيمة
رسائل البريد الإلكتروني قائمة عناوين البريد الإلكتروني التي ستحصل على إعلامات من Microsoft Defender for Cloud بواسطة التكوينات المحددة في جهة اتصال الأمان هذه. خيط
isEnabled يشير إلى ما إذا كان قد تم تمكين جهة اتصال الأمان. قيمة منطقية
notificationsByRole يحدد ما إذا كان يجب إرسال إشعارات البريد الإلكتروني من Microsoft Defender for Cloud إلى أشخاص ذوي أدوار RBAC محددة في الاشتراك. SecurityContactPropertiesNotificationsByRole
مصادر الإعلامات مجموعة من أنواع المصادر التي تقيم إعلام البريد الإلكتروني. NotificationsSource []
الهاتف رقم هاتف جهة اتصال الأمان خيط

SecurityContactPropertiesNotificationsByRole

اسم وصف قيمة
ادوار يحدد أدوار التحكم في الوصول استنادا إلى الدور التي ستحصل على إشعارات البريد الإلكتروني من Microsoft Defender for Cloud. قائمة بأدوار التحكم في الوصول استنادا إلى الدور المسموح بها: صفيف سلسلة يحتوي على أي من:
"مسؤول الحساب"
"المساهم"
"المالك"
"مسؤول الخدمة"
حالة يحدد ما إذا كان يجب إرسال إشعارات البريد الإلكتروني من AMicrosoft Defender for Cloud إلى الأشخاص الذين يعانون من أدوار RBAC محددة في الاشتراك. "إيقاف التشغيل"
'تشغيل'

أمثلة الاستخدام

تعريف مورد Terraform (موفر AzAPI)

يمكن نشر نوع مورد securityContacts مع العمليات التي تستهدف:

  • اشتراك

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

تنسيق المورد

لإنشاء مورد Microsoft.Security/securityContacts، أضف Terraform التالي إلى القالب الخاص بك.

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

قم بتعيين الخاصية sourceType لتحديد نوع الكائن.

بالنسبة التنبيه، استخدم:

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

بالنسبة AttackPath، استخدم:

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

قيم الخصائص

Microsoft.Security/securityContacts

اسم وصف قيمة
اسم اسم المورد "افتراضي" (مطلوب)
خصائص بيانات جهة اتصال الأمان SecurityContactProperties
نوع نوع المورد "Microsoft.Security/securityContacts@2023-12-01-preview"

مصدر الإعلامات

اسم وصف قيمة
نوع المصدر تعيين إلى "تنبيه" للنوع NotificationsSourceAlert. تعيين إلى 'AttackPath' لنوع NotificationsSourceAttackPath. "تنبيه"
'AttackPath' (مطلوب)

NotificationsSourceAlert

اسم وصف قيمة
الحد الأدنى من الحد الأدنى يحدد الحد الأدنى من خطورة التنبيه التي سيتم إرسالها كإشعارات عبر البريد الإلكتروني "مرتفع"
"منخفض"
'متوسط'
نوع المصدر نوع المصدر الذي سيقوم بتشغيل الإعلام "تنبيه" (مطلوب)

NotificationsSourceAttackPath

اسم وصف قيمة
الحد الأدنى لRiskLevel تحديد الحد الأدنى من مستوى مخاطر مسار الإرفاق الذي سيتم إرساله كإشعارات عبر البريد الإلكتروني "حرج"
"مرتفع"
"منخفض"
'متوسط'
نوع المصدر نوع المصدر الذي سيقوم بتشغيل الإعلام 'AttackPath' (مطلوب)

خصائص الأمان

اسم وصف قيمة
رسائل البريد الإلكتروني قائمة عناوين البريد الإلكتروني التي ستحصل على إعلامات من Microsoft Defender for Cloud بواسطة التكوينات المحددة في جهة اتصال الأمان هذه. خيط
isEnabled يشير إلى ما إذا كان قد تم تمكين جهة اتصال الأمان. قيمة منطقية
notificationsByRole يحدد ما إذا كان يجب إرسال إشعارات البريد الإلكتروني من Microsoft Defender for Cloud إلى أشخاص ذوي أدوار RBAC محددة في الاشتراك. SecurityContactPropertiesNotificationsByRole
مصادر الإعلامات مجموعة من أنواع المصادر التي تقيم إعلام البريد الإلكتروني. NotificationsSource []
الهاتف رقم هاتف جهة اتصال الأمان خيط

SecurityContactPropertiesNotificationsByRole

اسم وصف قيمة
ادوار يحدد أدوار التحكم في الوصول استنادا إلى الدور التي ستحصل على إشعارات البريد الإلكتروني من Microsoft Defender for Cloud. قائمة بأدوار التحكم في الوصول استنادا إلى الدور المسموح بها: صفيف سلسلة يحتوي على أي من:
"مسؤول الحساب"
"المساهم"
"المالك"
"مسؤول الخدمة"
حالة يحدد ما إذا كان يجب إرسال إشعارات البريد الإلكتروني من AMicrosoft Defender for Cloud إلى الأشخاص الذين يعانون من أدوار RBAC محددة في الاشتراك. "إيقاف التشغيل"
'تشغيل'

أمثلة الاستخدام

عينات Terraform

مثال أساسي لنشر جهة اتصال مركز الأمان الخاصة بالاشتراك.

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