다음을 통해 공유

Security Contacts - Create

  • 참조
Service:
Defender for Cloud
API Version:
2023-12-01-preview

구독에 대한 보안 연락처 구성 Create

PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/securityContacts/default?api-version=2023-12-01-preview

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
securityContactName
 path True

securityContactName

보안 연락처 개체의 이름

Regex pattern: ^(default)$
subscriptionId
 path True

string

Azure 구독 ID입니다.

Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$
api-version
 query True

string

작업에 대한 API 버전

요청 본문

Name 형식 Description
properties.emails

string

이 보안 연락처에 정의된 구성을 통해 클라우드용 Microsoft Defender 알림을 받을 이메일 주소 목록입니다.
properties.isEnabled

boolean

보안 연락처를 사용할 수 있는지 여부를 나타냅니다.
properties.notificationsByRole

NotificationsByRole

메일 알림 Microsoft Defender 구독의 특정 RBAC 역할이 있는 사용자에게 보낼지 여부를 정의합니다.
properties.notificationsSources NotificationsSource[]:

이메일 알림을 평가하는 원본 유형의 컬렉션입니다.
properties.phone

string

보안 연락처의 전화 번호

응답

Name 형식 Description
200 OK

SecurityContact

정상
201 Created

SecurityContact

생성일
Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

Create security contact data

Sample Request

PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityContacts/default?api-version=2023-12-01-preview

{
  "properties": {
    "notificationsByRole": {
      "state": "On",
      "roles": [
        "Owner"
      ]
    },
    "isEnabled": true,
    "emails": "john@contoso.com;jane@contoso.com",
    "phone": "(214)275-4038",
    "notificationsSources": [
      {
        "sourceType": "AttackPath",
        "minimalRiskLevel": "Critical"
      },
      {
        "sourceType": "Alert",
        "minimalSeverity": "Medium"
      }
    ]
  }
}

Sample Response

Status code:
201 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityContacts/default",
  "name": "default",
  "type": "Microsoft.Security/securityContact",
  "properties": {
    "notificationsByRole": {
      "roles": [
        "Owner"
      ]
    },
    "isEnabled": true,
    "emails": "john@microsoft.com;jane@microsoft.com",
    "phone": "(214)275-4038",
    "notificationsSources": [
      {
        "sourceType": "AttackPath",
        "minimalRiskLevel": "Critical"
      },
      {
        "sourceType": "Alert",
        "minimalSeverity": "Medium"
      }
    ]
  }
}
Status code:
200 
{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityContacts/default",
  "name": "default",
  "type": "Microsoft.Security/securityContact",
  "properties": {
    "notificationsByRole": {
      "state": "On",
      "roles": [
        "Owner"
      ]
    },
    "isEnabled": true,
    "emails": "john@microsoft.com;jane@microsoft.com",
    "phone": "(214)275-4038",
    "notificationsSources": [
      {
        "sourceType": "AttackPath",
        "minimalRiskLevel": "Critical"
      },
      {
        "sourceType": "Alert",
        "minimalSeverity": "Medium"
      }
    ]
  }
}

정의

Name Description
CloudError

실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. OData 오류 응답 형식도 따릅니다.
CloudErrorBody

오류 세부 정보입니다.
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.
minimalRiskLevel

메일 알림 전송될 최소 연결 경로 위험 수준을 정의합니다.
minimalSeverity
NotificationsByRole

메일 알림 Microsoft Defender 구독의 특정 RBAC 역할이 있는 사용자에게 보낼지 여부를 정의합니다.
NotificationsSourceAlert

경고 알림 원본
NotificationsSourceAttackPath

공격 경로 알림 원본
SecurityContact

클라우드용 Microsoft Defender 제공되는 알림에 대한 연락처 세부 정보 및 구성입니다.
securityContactName

보안 연락처 개체의 이름
securityContactRole

클라우드용 Microsoft Defender 메일 알림 가져올 RBAC 역할을 정의합니다. 허용되는 RBAC 역할 목록:
state

AMicrosoft Defender for Cloud에서 구독의 특정 RBAC 역할이 있는 사용자에게 메일 알림 보낼지 여부를 정의합니다.

CloudError

실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. OData 오류 응답 형식도 따릅니다.

Name 형식 Description
error.additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
error.code

string

오류 코드입니다.
error.details

CloudErrorBody[]

오류 세부 정보입니다.
error.message

string

오류 메시지입니다.
error.target

string

오류 대상입니다.

CloudErrorBody

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
code

string

오류 코드입니다.
details

CloudErrorBody[]

오류 세부 정보입니다.
message

string

오류 메시지입니다.
target

string

오류 대상입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.
type

string

추가 정보 유형입니다.

minimalRiskLevel

메일 알림 전송될 최소 연결 경로 위험 수준을 정의합니다.

Name 형식 Description
Critical

string

위험 수준이 중요한 새 공격 경로에 대한 알림 받기
High

string

높음 또는 위험 수준이 높은 새 공격 경로에 대한 알림 받기
Low

string

낮음, 중간, 높음 또는 위험 수준이 있는 새 연결 경로에 대한 알림 받기
Medium

string

중간, 높음 또는 위험 수준이 있는 새 연결 경로에 대한 알림 받기

minimalSeverity

Name 형식 Description
High

string

심각도가 높은 새 경고에 대한 알림 받기
Low

string

심각도가 낮음, 중간 또는 높은 새 경고에 대한 알림 받기
Medium

string

심각도가 보통 또는 높음인 새 경고에 대한 알림 받기

NotificationsByRole

메일 알림 Microsoft Defender 구독의 특정 RBAC 역할이 있는 사용자에게 보낼지 여부를 정의합니다.

Name 형식 Description
roles

securityContactRole[]

클라우드용 Microsoft Defender 메일 알림 가져올 RBAC 역할을 정의합니다. 허용되는 RBAC 역할 목록:
state

state

AMicrosoft Defender for Cloud에서 구독의 특정 RBAC 역할이 있는 사용자에게 메일 알림 보낼지 여부를 정의합니다.

NotificationsSourceAlert

경고 알림 원본

Name 형식 Description
minimalSeverity

minimalSeverity

sourceType string:

Alert

알림을 트리거할 원본 유형

NotificationsSourceAttackPath

공격 경로 알림 원본

Name 형식 Description
minimalRiskLevel

minimalRiskLevel

메일 알림 전송될 최소 연결 경로 위험 수준을 정의합니다.
sourceType string:

AttackPath

알림을 트리거할 원본 유형

SecurityContact

클라우드용 Microsoft Defender 제공되는 알림에 대한 연락처 세부 정보 및 구성입니다.

Name 형식 Description
id

string

리소스 ID
name

string

리소스 이름
properties.emails

string

이 보안 연락처에 정의된 구성을 통해 클라우드용 Microsoft Defender 알림을 받을 이메일 주소 목록입니다.
properties.isEnabled

boolean

보안 연락처를 사용할 수 있는지 여부를 나타냅니다.
properties.notificationsByRole

NotificationsByRole

메일 알림 Microsoft Defender 구독의 특정 RBAC 역할이 있는 사용자에게 보낼지 여부를 정의합니다.
properties.notificationsSources NotificationsSource[]:

이메일 알림을 평가하는 원본 유형의 컬렉션입니다.
properties.phone

string

보안 연락처의 전화 번호
type

string

리소스 유형

securityContactName

보안 연락처 개체의 이름

Name 형식 Description
default

string

보안 연락처 개체의 적용 가능한 단일 이름

securityContactRole

클라우드용 Microsoft Defender 메일 알림 가져올 RBAC 역할을 정의합니다. 허용되는 RBAC 역할 목록:

Name 형식 Description
AccountAdmin

string

사용하도록 설정된 경우 계정 관리자에게 새 경고에 대한 알림을 보냅니다.
Contributor

string

사용하도록 설정된 경우 구독 기여자에게 새 경고에 대한 알림을 보냅니다.
Owner

string

사용하도록 설정된 경우 구독 소유자에게 새 경고에 대한 알림을 보냅니다.
ServiceAdmin

string

사용하도록 설정된 경우 서비스 관리자에게 새 경고에 대한 알림을 보냅니다.

state

AMicrosoft Defender for Cloud에서 구독의 특정 RBAC 역할이 있는 사용자에게 메일 알림 보낼지 여부를 정의합니다.

Name 형식 Description
Off

string

구독 관리자에게 새 경고에 대한 알림을 보내지 마세요.
On

string

구독 관리자에게 새 경고에 대한 알림 보내기