Security Contacts - Get
Získání výchozích konfigurací kontaktů zabezpečení pro předplatné
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/securityContacts/default?api-version=2023-12-01-preview
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
security
|
path | True |
Název objektu kontaktu zabezpečení Regex pattern: |
|
subscription
|
path | True |
string |
ID předplatného Azure Regex pattern: |
api-version
|
query | True |
string |
Verze rozhraní API pro operaci |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
Get a security contact
Sample Request
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityContacts/default?api-version=2023-12-01-preview
Sample Response
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/securityContacts/default",
"name": "default",
"type": "Microsoft.Security/securityContacts",
"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"
}
]
}
}
Definice
Name | Description |
---|---|
Cloud |
Běžná odpověď na chybu pro všechna rozhraní API azure Resource Manager, která vrací podrobnosti o chybě pro neúspěšné operace. (To také odpovídá formátu odpovědi na chybu OData.) |
Cloud |
Podrobnosti o chybě. |
Error |
Další informace o chybě správy prostředků |
minimal |
Definuje minimální úroveň rizika cesty připojení, která se bude odesílat jako e-mailová oznámení. |
minimal |
|
Notifications |
Definuje, jestli se mají odesílat e-mailová oznámení z Microsoft Defender pro cloud osobám s konkrétními rolemi RBAC v předplatném. |
Notifications |
Zdroj upozornění |
Notifications |
Zdroj oznámení o cestě útoku |
Security |
Kontaktní údaje a konfigurace pro oznámení přicházející z Microsoft Defender pro cloud |
security |
Název objektu kontaktu zabezpečení |
security |
Definuje, které role RBAC budou dostávat e-mailová oznámení z Microsoft Defender pro cloud. Seznam povolených rolí RBAC: |
state |
Definuje, jestli se mají odesílat e-mailová oznámení z AMicrosoft Defenderu for Cloud osobám s konkrétními rolemi RBAC v předplatném. |
CloudError
Běžná odpověď na chybu pro všechna rozhraní API azure Resource Manager, která vrací podrobnosti o chybě pro neúspěšné operace. (To také odpovídá formátu odpovědi na chybu OData.)
Name | Typ | Description |
---|---|---|
error.additionalInfo |
Další informace o chybě |
|
error.code |
string |
Kód chyby |
error.details |
Podrobnosti o chybě |
|
error.message |
string |
Chybová zpráva |
error.target |
string |
Cíl chyby. |
CloudErrorBody
Podrobnosti o chybě.
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Další typ informací. |
minimalRiskLevel
Definuje minimální úroveň rizika cesty připojení, která se bude odesílat jako e-mailová oznámení.
Name | Typ | Description |
---|---|---|
Critical |
string |
Získání oznámení o nových cestách útoku s úrovní kritického rizika |
High |
string |
Získání oznámení o nových cestách útoku s vysokou nebo kritickou úrovní rizika |
Low |
string |
Dostávat oznámení o nových cestách připojení s nízkou, střední, vysokou nebo kritickou úrovní rizika |
Medium |
string |
Dostávat oznámení o nových cestách připojení se střední, vysokou nebo kritickou úrovní rizika |
minimalSeverity
Name | Typ | Description |
---|---|---|
High |
string |
Získání oznámení o nových upozorněních s vysokou závažností |
Low |
string |
Dostávat oznámení o nových upozorněních s nízkou, střední nebo vysokou závažností |
Medium |
string |
Dostávat oznámení o nových upozorněních se střední nebo vysokou závažností |
NotificationsByRole
Definuje, jestli se mají odesílat e-mailová oznámení z Microsoft Defender pro cloud osobám s konkrétními rolemi RBAC v předplatném.
Name | Typ | Description |
---|---|---|
roles |
Definuje, které role RBAC budou dostávat e-mailová oznámení z Microsoft Defender pro cloud. Seznam povolených rolí RBAC: |
|
state |
Definuje, jestli se mají odesílat e-mailová oznámení z AMicrosoft Defenderu for Cloud osobám s konkrétními rolemi RBAC v předplatném. |
NotificationsSourceAlert
Zdroj upozornění
Name | Typ | Description |
---|---|---|
minimalSeverity | ||
sourceType |
string:
Alert |
Typ zdroje, který aktivuje oznámení |
NotificationsSourceAttackPath
Zdroj oznámení o cestě útoku
Name | Typ | Description |
---|---|---|
minimalRiskLevel |
Definuje minimální úroveň rizika cesty připojení, která se bude odesílat jako e-mailová oznámení. |
|
sourceType |
string:
Attack |
Typ zdroje, který aktivuje oznámení |
SecurityContact
Kontaktní údaje a konfigurace pro oznámení přicházející z Microsoft Defender pro cloud
Name | Typ | Description |
---|---|---|
id |
string |
ID prostředku |
name |
string |
Název prostředku |
properties.emails |
string |
Seznam e-mailových adres, které budou dostávat oznámení z Microsoft Defender pro cloud podle konfigurací definovaných v tomto kontaktu zabezpečení. |
properties.isEnabled |
boolean |
Označuje, jestli je povolený kontakt zabezpečení. |
properties.notificationsByRole |
Definuje, jestli se mají odesílat e-mailová oznámení z Microsoft Defender pro cloud osobám s konkrétními rolemi RBAC v předplatném. |
|
properties.notificationsSources | NotificationsSource[]: |
Kolekce typů zdrojů, které vyhodnocují e-mailové oznámení. |
properties.phone |
string |
Telefonní číslo bezpečnostního kontaktu |
type |
string |
Typ prostředku |
securityContactName
Název objektu kontaktu zabezpečení
Name | Typ | Description |
---|---|---|
default |
string |
Jediný použitelný název objektu kontaktu zabezpečení |
securityContactRole
Definuje, které role RBAC budou dostávat e-mailová oznámení z Microsoft Defender pro cloud. Seznam povolených rolí RBAC:
Name | Typ | Description |
---|---|---|
AccountAdmin |
string |
Pokud je tato možnost povolená, odešlete oznámení o nových upozorněních správcům účtu. |
Contributor |
string |
Pokud je tato možnost povolená, odešlete oznámení o nových upozorněních přispěvatelům předplatného. |
Owner |
string |
Pokud je tato možnost povolená, odešlete oznámení o nových upozorněních vlastníkům předplatného. |
ServiceAdmin |
string |
Pokud je tato možnost povolená, odešlete oznámení o nových upozorněních správcům služby. |
state
Definuje, jestli se mají odesílat e-mailová oznámení z AMicrosoft Defenderu for Cloud osobám s konkrétními rolemi RBAC v předplatném.
Name | Typ | Description |
---|---|---|
Off |
string |
Neposílejte oznámení o nových upozorněních správcům předplatného. |
On |
string |
Odeslání oznámení o nových upozorněních správcům předplatného |