External Security Solutions - List
Gets a list of external security solutions for the subscription.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/externalSecuritySolutions?api-version=2020-01-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
subscription
|
path | True |
string |
Azure subscription ID Regex pattern: |
api-version
|
query | True |
string |
API version for the operation |
Responses
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Error response describing why the operation failed. |
Security
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 | impersonate your user account |
Examples
Get external security solutions on a subscription
Sample request
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/providers/Microsoft.Security/externalSecuritySolutions?api-version=2020-01-01
Sample response
{
"value": [
{
"kind": "AAD",
"properties": {
"connectivityState": "Discovered",
"deviceVendor": "Microsoft",
"deviceType": "Azure Active Directory Identity Protection",
"workspace": {
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/defaultresourcegroup-eus/providers/Microsoft.OperationalInsights/workspaces/defaultworkspace-20ff7fc3-e762-44dd-bd96-b71116dcdc23-eus"
}
},
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/defaultresourcegroup-eus/providers/Microsoft.Security/locations/centralus/externalSecuritySolutions/aad_defaultworkspace-20ff7fc3-e762-44dd-bd96-b71116dcdc23-eus",
"name": "aad_defaultworkspace-20ff7fc3-e762-44dd-bd96-b71116dcdc23-eus",
"type": "Microsoft.Security/locations/externalSecuritySolutions",
"location": "eastus"
},
{
"kind": "AAD",
"properties": {
"connectivityState": "Discovered",
"deviceVendor": "Microsoft",
"deviceType": "Azure Active Directory Identity Protection",
"workspace": {
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/defaultresourcegroup-weu/providers/Microsoft.OperationalInsights/workspaces/defaultworkspace-20ff7fc3-e762-44dd-bd96-b71116dcdc23-weu"
}
},
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/defaultresourcegroup-weu/providers/Microsoft.Security/locations/centralus/externalSecuritySolutions/aad_defaultworkspace-20ff7fc3-e762-44dd-bd96-b71116dcdc23-weu",
"name": "aad_defaultworkspace-20ff7fc3-e762-44dd-bd96-b71116dcdc23-weu",
"type": "Microsoft.Security/locations/externalSecuritySolutions",
"location": "westeurope"
},
{
"kind": "CEF",
"properties": {
"lastEventReceived": "2018-05-09T10:30:11.523Z",
"hostname": "barracuda",
"deviceVendor": "barracudanetworks",
"deviceType": "WAF",
"workspace": {
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/unificationprod/providers/Microsoft.OperationalInsights/workspaces/omsprd"
}
},
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/unificationprod/providers/Microsoft.Security/locations/centralus/externalSecuritySolutions/cef_omsprd_barracudanetworks_waf_barracuda",
"name": "cef_omsprd_barracudanetworks_waf_barracuda",
"type": "Microsoft.Security/locations/externalSecuritySolutions",
"location": "westcentralus"
},
{
"kind": "CEF",
"properties": {
"lastEventReceived": "2018-05-08T15:42:22.57Z",
"hostname": "demovm20",
"deviceVendor": "virtualHoneypot",
"deviceType": "Microsoft",
"workspace": {
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/unificationprod/providers/Microsoft.OperationalInsights/workspaces/omsprd"
}
},
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/unificationprod/providers/Microsoft.Security/locations/centralus/externalSecuritySolutions/cef_omsprd_virtualhoneypot_Microsoft_demovm20",
"name": "cef_omsprd_virtualhoneypot_Microsoft_demovm20",
"type": "Microsoft.Security/locations/externalSecuritySolutions",
"location": "westcentralus"
},
{
"kind": "CEF",
"properties": {
"lastEventReceived": "2018-05-08T10:38:53.423Z",
"hostname": "demovm10",
"deviceVendor": "virtualHoneypot",
"deviceType": "Microsoft",
"workspace": {
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/unificationprod/providers/Microsoft.OperationalInsights/workspaces/omsprd"
}
},
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/unificationprod/providers/Microsoft.Security/locations/centralus/externalSecuritySolutions/cef_omsprd_virtualhoneypot_Microsoft_demovm10",
"name": "cef_omsprd_virtualhoneypot_Microsoft_demovm10",
"type": "Microsoft.Security/locations/externalSecuritySolutions",
"location": "westcentralus"
},
{
"kind": "AAD",
"properties": {
"connectivityState": "Discovered",
"deviceVendor": "Microsoft",
"deviceType": "Azure Active Directory Identity Protection",
"workspace": {
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/unificationprod/providers/Microsoft.OperationalInsights/workspaces/omsprd"
}
},
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/unificationprod/providers/Microsoft.Security/locations/centralus/externalSecuritySolutions/aad_omsprd",
"name": "aad_omsprd",
"type": "Microsoft.Security/locations/externalSecuritySolutions",
"location": "westcentralus"
},
{
"kind": "AAD",
"properties": {
"connectivityState": "Discovered",
"deviceVendor": "Microsoft",
"deviceType": "Azure Active Directory Identity Protection",
"workspace": {
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourcegroups/defaultresourcegroup-ejp/providers/Microsoft.OperationalInsights/workspaces/defaultworkspace-20ff7fc3-e762-44dd-bd96-b71116dcdc23-ejp"
}
},
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/defaultresourcegroup-ejp/providers/Microsoft.Security/locations/centralus/externalSecuritySolutions/aad_defaultworkspace-20ff7fc3-e762-44dd-bd96-b71116dcdc23-ejp",
"name": "aad_defaultworkspace-20ff7fc3-e762-44dd-bd96-b71116dcdc23-ejp",
"type": "Microsoft.Security/locations/externalSecuritySolutions",
"location": "japaneast"
}
]
}
Definitions
Name | Description |
---|---|
Aad |
Describes an Azure resource with kind |
Aad |
Represents an AAD identity protection solution which sends logs to an OMS workspace. |
Aad |
The external security solution properties for AAD solutions |
Ata |
Represents an ATA security solution which sends logs to an OMS workspace |
Ata |
The external security solution properties for ATA solutions |
Cef |
Represents a security solution which sends CEF logs to an OMS workspace |
Cef |
The external security solution properties for CEF solutions |
Cloud |
Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.). |
Cloud |
The error detail. |
Connected |
Represents an OMS workspace to which the solution is connected |
Error |
The resource management error additional info. |
External |
Describes an Azure resource with kind |
External |
AadConnectivityState
Describes an Azure resource with kind
Name | Type | Description |
---|---|---|
connectivityState |
The connectivity state of the external AAD solution |
AadExternalSecuritySolution
Represents an AAD identity protection solution which sends logs to an OMS workspace.
Name | Type | Description |
---|---|---|
id |
string |
Resource Id |
kind |
The kind of the external solution |
|
location |
string |
Location where the resource is stored |
name |
string |
Resource name |
properties |
The external security solution properties for AAD solutions |
|
type |
string |
Resource type |
AadSolutionProperties
The external security solution properties for AAD solutions
Name | Type | Description |
---|---|---|
connectivityState |
The connectivity state of the external AAD solution |
|
deviceType |
string |
|
deviceVendor |
string |
|
workspace |
Represents an OMS workspace to which the solution is connected |
AtaExternalSecuritySolution
Represents an ATA security solution which sends logs to an OMS workspace
Name | Type | Description |
---|---|---|
id |
string |
Resource Id |
kind |
The kind of the external solution |
|
location |
string |
Location where the resource is stored |
name |
string |
Resource name |
properties |
The external security solution properties for ATA solutions |
|
type |
string |
Resource type |
AtaSolutionProperties
The external security solution properties for ATA solutions
Name | Type | Description |
---|---|---|
deviceType |
string |
|
deviceVendor |
string |
|
lastEventReceived |
string |
|
workspace |
Represents an OMS workspace to which the solution is connected |
CefExternalSecuritySolution
Represents a security solution which sends CEF logs to an OMS workspace
Name | Type | Description |
---|---|---|
id |
string |
Resource Id |
kind |
The kind of the external solution |
|
location |
string |
Location where the resource is stored |
name |
string |
Resource name |
properties |
The external security solution properties for CEF solutions |
|
type |
string |
Resource type |
CefSolutionProperties
The external security solution properties for CEF solutions
Name | Type | Description |
---|---|---|
agent |
string |
|
deviceType |
string |
|
deviceVendor |
string |
|
hostname |
string |
|
lastEventReceived |
string |
|
workspace |
Represents an OMS workspace to which the solution is connected |
CloudError
Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).
Name | Type | Description |
---|---|---|
error.additionalInfo |
The error additional info. |
|
error.code |
string |
The error code. |
error.details |
The error details. |
|
error.message |
string |
The error message. |
error.target |
string |
The error target. |
CloudErrorBody
The error detail.
Name | Type | Description |
---|---|---|
additionalInfo |
The error additional info. |
|
code |
string |
The error code. |
details |
The error details. |
|
message |
string |
The error message. |
target |
string |
The error target. |
ConnectedWorkspace
Represents an OMS workspace to which the solution is connected
Name | Type | Description |
---|---|---|
id |
string |
Azure resource ID of the connected OMS workspace |
ErrorAdditionalInfo
The resource management error additional info.
Name | Type | Description |
---|---|---|
info |
object |
The additional info. |
type |
string |
The additional info type. |
ExternalSecuritySolutionKind
Describes an Azure resource with kind
Name | Type | Description |
---|---|---|
kind |
The kind of the external solution |
ExternalSecuritySolutionList
Name | Type | Description |
---|---|---|
nextLink |
string |
The URI to fetch the next page. |
value | ExternalSecuritySolution[]: |
Represents a security solution external to Microsoft Defender for Cloud which sends information to an OMS workspace and whose data is displayed by Microsoft Defender for Cloud. |