Microsoft.Security securityContacts 2023-12-01-preview
Bicep リソース定義
securityContacts リソースの種類は、次をターゲットとする操作と共にデプロイできます。
- サブスクリプション - サブスクリプションのデプロイ コマンドに関するページを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.Security/securityContacts リソースを作成するには、次の Bicep をテンプレートに追加します。
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 オブジェクト
sourceType プロパティを設定して、オブジェクトの種類を指定します。
[アラート] には、次の値を使用します。
sourceType: 'Alert'
minimalSeverity: 'string'
AttackPath の場合は、次の値を使用します。
sourceType: 'AttackPath'
minimalRiskLevel: 'string'
プロパティ値
securityContacts
| 名前 | 説明 | 値 |
|---|---|---|
| name | リソース名 | 'default' |
| properties | セキュリティ連絡先データ | SecurityContactProperties |
SecurityContactProperties
| 名前 | 説明 | 値 |
|---|---|---|
| emails | このセキュリティ連絡先で定義されている構成によって、Microsoft Defender for Cloud から通知を受け取る電子メール アドレスの一覧。 | string |
| isEnabled | セキュリティ連絡先が有効かどうかを示します。 | [bool] |
| notificationsByRole | Microsoft Defender for Cloud から、サブスクリプション上の特定の RBAC ロールを持つユーザーに電子メール通知を送信するかどうかを定義します。 | SecurityContactPropertiesNotificationsByRole |
| notificationsSources | 電子メール通知を評価するソースの種類のコレクション。 | NotificationsSource[] |
| phone | セキュリティ連絡先の電話番号 | string |
SecurityContactPropertiesNotificationsByRole
| 名前 | 説明 | 値 |
|---|---|---|
| roles | Microsoft Defender for Cloud から電子メール通知を受け取る RBAC ロールを定義します。 許可される RBAC ロールの一覧: | 次のいずれかを含む文字列配列: 'AccountAdmin' 'Contributor' 'Owner' 'ServiceAdmin' |
| state | AMicrosoft Defender for Cloud から、サブスクリプション上の特定の RBAC ロールを持つユーザーに電子メール通知を送信するかどうかを定義します。 | 'Off' 'On' |
NotificationsSource
| 名前 | 説明 | 値 |
|---|---|---|
| sourceType | オブジェクトの種類を設定する | Alert AttackPath (必須) |
NotificationsSourceAlert
| 名前 | 説明 | 値 |
|---|---|---|
| sourceType | 通知をトリガーするソースの種類 | 'Alert' (必須) |
| minimalSeverity | 電子メール通知として送信される最小限のアラートの重大度を定義します | 'High' 'Low' 'Medium' |
NotificationsSourceAttackPath
| 名前 | 説明 | 値 |
|---|---|---|
| sourceType | 通知をトリガーするソースの種類 | 'AttackPath' (必須) |
| minimalRiskLevel | 電子メール通知として送信される最小添付パス リスク レベルを定義します | 'Critical' 'High' 'Low' 'Medium' |
ARM テンプレート リソース定義
securityContacts リソースの種類は、次をターゲットとする操作と共にデプロイできます。
- サブスクリプション - サブスクリプションのデプロイ コマンドに関するページを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.Security/securityContacts リソースを作成するには、次の JSON をテンプレートに追加します。
{
"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 オブジェクト
sourceType プロパティを設定して、オブジェクトの種類を指定します。
[アラート] には、次の値を使用します。
"sourceType": "Alert",
"minimalSeverity": "string"
AttackPath の場合は、次の値を使用します。
"sourceType": "AttackPath",
"minimalRiskLevel": "string"
プロパティ値
securityContacts
| 名前 | 説明 | 値 |
|---|---|---|
| type | リソースの種類 | 'Microsoft.Security/securityContacts' |
| apiVersion | リソース API のバージョン | '2023-12-01-preview' |
| name | リソース名 | 'default' |
| properties | セキュリティ連絡先データ | SecurityContactProperties |
SecurityContactProperties
| 名前 | 説明 | 値 |
|---|---|---|
| emails | このセキュリティ連絡先で定義されている構成によって、Microsoft Defender for Cloud から通知を受け取る電子メール アドレスの一覧。 | string |
| isEnabled | セキュリティ連絡先が有効かどうかを示します。 | [bool] |
| notificationsByRole | Microsoft Defender for Cloud からサブスクリプション上の特定の RBAC ロールを持つユーザーに電子メール通知を送信するかどうかを定義します。 | SecurityContactPropertiesNotificationsByRole |
| notificationsSources | 電子メール通知を評価するソースの種類のコレクション。 | NotificationsSource[] |
| phone | セキュリティ連絡先の電話番号 | string |
SecurityContactPropertiesNotificationsByRole
| 名前 | 説明 | 値 |
|---|---|---|
| roles | Microsoft Defender for Cloud から電子メール通知を受け取る RBAC ロールを定義します。 許可されている RBAC ロールの一覧: | 次のいずれかを含む文字列配列: 'AccountAdmin' '共同作成者' 'Owner' 'ServiceAdmin' |
| state | AMicrosoft Defender for Cloud からサブスクリプションの特定の RBAC ロールを持つユーザーに電子メール通知を送信するかどうかを定義します。 | 'Off' 'On' |
NotificationsSource
| 名前 | 説明 | 値 |
|---|---|---|
| sourceType | オブジェクトの種類を設定する | Alert AttackPath (必須) |
NotificationsSourceAlert
| 名前 | 説明 | 値 |
|---|---|---|
| sourceType | 通知をトリガーするソースの種類 | 'Alert' (必須) |
| minimalSeverity | 電子メール通知として送信される最小限のアラートの重大度を定義します | 'High' 'Low' 'Medium' |
NotificationsSourceAttackPath
| 名前 | 説明 | 値 |
|---|---|---|
| sourceType | 通知をトリガーするソースの種類 | 'AttackPath' (必須) |
| minimalRiskLevel | 電子メール通知として送信される最小限の添付パス リスク レベルを定義します | 'Critical' 'High' 'Low' 'Medium' |
Terraform (AzAPI プロバイダー) リソース定義
securityContacts リソースの種類は、次を対象とする操作でデプロイできます。
- サブスクリプション
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.Security/securityContacts リソースを作成するには、次の Terraform をテンプレートに追加します。
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 オブジェクト
sourceType プロパティを設定して、オブジェクトの種類を指定します。
[アラート] には、次の値を使用します。
sourceType = "Alert"
minimalSeverity = "string"
AttackPath の場合は、次の値を使用します。
sourceType = "AttackPath"
minimalRiskLevel = "string"
プロパティ値
securityContacts
| 名前 | 説明 | 値 |
|---|---|---|
| type | リソースの種類 | "Microsoft.Security/securityContacts@2023-12-01-preview" |
| name | リソース名 | "default" |
| parent_id | サブスクリプションにデプロイするには、そのサブスクリプションの ID を使用します。 | string (必須) |
| properties | セキュリティ連絡先データ | SecurityContactProperties |
SecurityContactProperties
| 名前 | 説明 | 値 |
|---|---|---|
| emails | このセキュリティ連絡先で定義されている構成によって、Microsoft Defender for Cloud から通知を受け取る電子メール アドレスの一覧。 | string |
| isEnabled | セキュリティ連絡先が有効かどうかを示します。 | [bool] |
| notificationsByRole | Microsoft Defender for Cloud からサブスクリプション上の特定の RBAC ロールを持つユーザーに電子メール通知を送信するかどうかを定義します。 | SecurityContactPropertiesNotificationsByRole |
| notificationsSources | 電子メール通知を評価するソースの種類のコレクション。 | NotificationsSource[] |
| phone | セキュリティ連絡先の電話番号 | string |
SecurityContactPropertiesNotificationsByRole
| 名前 | 説明 | 値 |
|---|---|---|
| roles | Microsoft Defender for Cloud から電子メール通知を受け取る RBAC ロールを定義します。 許可されている RBAC ロールの一覧: | 次のいずれかを含む文字列配列: "AccountAdmin" "共同作成者" "所有者" "ServiceAdmin" |
| state | AMicrosoft Defender for Cloud からサブスクリプションの特定の RBAC ロールを持つユーザーに電子メール通知を送信するかどうかを定義します。 | "Off" "On" |
NotificationsSource
| 名前 | 説明 | 値 |
|---|---|---|
| sourceType | オブジェクトの種類を設定する | Alert AttackPath (必須) |
NotificationsSourceAlert
| 名前 | 説明 | 値 |
|---|---|---|
| sourceType | 通知をトリガーするソースの種類 | "アラート" (必須) |
| minimalSeverity | 電子メール通知として送信される最小限のアラートの重大度を定義します | "High" "Low" "Medium" |
NotificationsSourceAttackPath
| 名前 | 説明 | 値 |
|---|---|---|
| sourceType | 通知をトリガーするソースの種類 | "AttackPath" (必須) |
| minimalRiskLevel | 電子メール通知として送信される最小限の添付パス リスク レベルを定義します | "Critical" "High" "Low" "Medium" |
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示