Iot Security Solution - List By Resource Group
Use esse método para obter a lista de soluções de Segurança IoT organizadas por grupo de recursos.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/iotSecuritySolutions?api-version=2019-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Security/iotSecuritySolutions?api-version=2019-08-01&$filter={$filter}
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
O nome do grupo de recursos na assinatura do usuário. O nome não diferencia maiúsculas de minúsculas. Padrão Regex: |
subscription
|
path | True |
string |
ID da assinatura do Azure Padrão Regex: |
api-version
|
query | True |
string |
Versão da API para a operação |
$filter
|
query |
string |
Filtre a solução de Segurança IoT com a sintaxe OData. Dá suporte à filtragem por iotHubs. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
OKEY |
|
Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
List IoT Security solutions by resource group |
List IoT Security solutions by resource group and IoT Hub |
List IoT Security solutions by resource group
Solicitação de exemplo
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/MyGroup/providers/Microsoft.Security/iotSecuritySolutions?api-version=2019-08-01
Resposta de exemplo
{
"value": [
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/MyGroup/providers/Microsoft.Security/IoTSecuritySolutions/Locations/eastus/default",
"name": "default",
"location": "East Us",
"type": "Microsoft.Security/IoTSecuritySolutions",
"tags": {},
"properties": {
"workspace": "/subscriptions/c4930e90-cd72-4aa5-93e9-2d081d129569/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace1",
"status": "Enabled",
"export": [],
"disabledDataSources": [],
"displayName": "Solution Default",
"iotHubs": [
"/subscriptions/075423e9-7d33-4166-8bdf-3920b04e3735/resourceGroups/myRg/providers/Microsoft.Devices/IotHubs/FirstIotHub"
],
"userDefinedResources": {
"query": "where type != \"microsoft.devices/iothubs\" | where name contains \"iot\"",
"querySubscriptions": [
"075423e9-7d33-4166-8bdf-3920b04e3735"
]
},
"autoDiscoveredResources": [
"/subscriptions/075423e9-7d33-4166-8bdf-3920b04e3735",
"/subscriptions/075423e9-7d33-4166-8bdf-3920b04e3735/resourceGroups/myRg/providers/Microsoft.Devices/IotHubs/FirstIotHub"
],
"recommendationsConfiguration": [
{
"recommendationType": "IoT_ACRAuthentication",
"name": "Service Principal Not Used with ACR",
"status": "Enabled"
},
{
"recommendationType": "IoT_AgentSendsUnutilizedMessages",
"name": "Agent sending underutilized messages",
"status": "TurnedOn"
},
{
"recommendationType": "IoT_Baseline",
"name": "Operating system (OS) baseline validation failure",
"status": "Enabled"
},
{
"recommendationType": "IoT_EdgeHubMemOptimize",
"name": "Edge Hub memory can be optimized",
"status": "Enabled"
},
{
"recommendationType": "IoT_EdgeLoggingOptions",
"name": "No Logging Configured for Edge Module",
"status": "Enabled"
},
{
"recommendationType": "IoT_InconsistentModuleSettings",
"name": "Module Settings Inconsistent in SecurityGroup",
"status": "Enabled"
},
{
"recommendationType": "IoT_InstallAgent",
"name": "Install the Azure Security of Things Agent",
"status": "Enabled"
},
{
"recommendationType": "IoT_IPFilter_DenyAll",
"name": "Default IP Filter Policy should be Deny",
"status": "Enabled"
},
{
"recommendationType": "IoT_IPFilter_PermissiveRule",
"name": "IP Filter rule includes large IP range",
"status": "Enabled"
},
{
"recommendationType": "IoT_OpenPorts",
"name": "Open Ports On Device",
"status": "Disabled"
},
{
"recommendationType": "IoT_PermissiveFirewallPolicy",
"name": "Permissive firewall policy in one of the chains was found",
"status": "Enabled"
},
{
"recommendationType": "IoT_PermissiveInputFirewallRules",
"name": "Permissive firewall rule in the input chain was found",
"status": "Enabled"
},
{
"recommendationType": "IoT_PermissiveOutputFirewallRules",
"name": "Permissive firewall rule in the output chain was found",
"status": "Enabled"
},
{
"recommendationType": "IoT_PrivilegedDockerOptions",
"name": "High level permissions configured in Edge model twin for Edge module",
"status": "Enabled"
},
{
"recommendationType": "IoT_SharedCredentials",
"name": "Same Authentication Credentials used by multiple devices",
"status": "Disabled"
},
{
"recommendationType": "IoT_VulnerableTLSCipherSuite",
"name": "TLS cipher suite upgrade",
"status": "Enabled"
}
],
"unmaskedIpLoggingStatus": "Enabled"
},
"systemData": {
"createdBy": "string",
"createdByType": "User",
"createdAt": "2020-04-27T21:53:29.0928001Z",
"lastModifiedBy": "string",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-04-27T21:53:29.0928001Z"
}
}
]
}
List IoT Security solutions by resource group and IoT Hub
Solicitação de exemplo
GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/MyRg/providers/Microsoft.Security/iotSecuritySolutions?api-version=2019-08-01&$filter=properties.iotHubs/any(i eq "/subscriptions/075423e9-7d33-4166-8bdf-3920b04e3735/resourceGroups/myRg/providers/Microsoft.Devices/IotHubs/FirstIotHub")
Resposta de exemplo
{
"value": [
{
"id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/MyRg/providers/Microsoft.Security/IoTSecuritySolutions/Locations/eastus/default",
"name": "default",
"type": "Microsoft.Security/IoTSecuritySolutions",
"location": "East Us",
"tags": {},
"properties": {
"workspace": "/subscriptions/c4930e90-cd72-4aa5-93e9-2d081d129569/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace1",
"status": "Enabled",
"export": [
"RawEvents"
],
"disabledDataSources": [],
"displayName": "Solution Default",
"iotHubs": [
"/subscriptions/075423e9-7d33-4166-8bdf-3920b04e3735/resourceGroups/myRg/providers/Microsoft.Devices/IotHubs/FirstIotHub"
],
"userDefinedResources": {
"query": "where type != \"microsoft.devices/iothubs\" | where name contains \"iot\"",
"querySubscriptions": [
"075423e9-7d33-4166-8bdf-3920b04e3735"
]
},
"autoDiscoveredResources": [
"/subscriptions/075423e9-7d33-4166-8bdf-3920b04e3735",
"/subscriptions/075423e9-7d33-4166-8bdf-3920b04e3735/resourceGroups/myRg/providers/Microsoft.Devices/IotHubs/FirstIotHub"
],
"recommendationsConfiguration": [
{
"recommendationType": "IoT_ACRAuthentication",
"name": "Service Principal Not Used with ACR",
"status": "Enabled"
},
{
"recommendationType": "IoT_AgentSendsUnutilizedMessages",
"name": "Agent sending underutilized messages",
"status": "TurnedOn"
},
{
"recommendationType": "IoT_Baseline",
"name": "Operating system (OS) baseline validation failure",
"status": "Enabled"
},
{
"recommendationType": "IoT_EdgeHubMemOptimize",
"name": "Edge Hub memory can be optimized",
"status": "Enabled"
},
{
"recommendationType": "IoT_EdgeLoggingOptions",
"name": "No Logging Configured for Edge Module",
"status": "Enabled"
},
{
"recommendationType": "IoT_InconsistentModuleSettings",
"name": "Module Settings Inconsistent in SecurityGroup",
"status": "Enabled"
},
{
"recommendationType": "IoT_InstallAgent",
"name": "Install the Azure Security of Things Agent",
"status": "Enabled"
},
{
"recommendationType": "IoT_IPFilter_DenyAll",
"name": "Default IP Filter Policy should be Deny",
"status": "Enabled"
},
{
"recommendationType": "IoT_IPFilter_PermissiveRule",
"name": "IP Filter rule includes large IP range",
"status": "Enabled"
},
{
"recommendationType": "IoT_OpenPorts",
"name": "Open Ports On Device",
"status": "Disabled"
},
{
"recommendationType": "IoT_PermissiveFirewallPolicy",
"name": "Permissive firewall policy in one of the chains was found",
"status": "Enabled"
},
{
"recommendationType": "IoT_PermissiveInputFirewallRules",
"name": "Permissive firewall rule in the input chain was found",
"status": "Enabled"
},
{
"recommendationType": "IoT_PermissiveOutputFirewallRules",
"name": "Permissive firewall rule in the output chain was found",
"status": "Enabled"
},
{
"recommendationType": "IoT_PrivilegedDockerOptions",
"name": "High level permissions configured in Edge model twin for Edge module",
"status": "Enabled"
},
{
"recommendationType": "IoT_SharedCredentials",
"name": "Same Authentication Credentials used by multiple devices",
"status": "Disabled"
},
{
"recommendationType": "IoT_VulnerableTLSCipherSuite",
"name": "TLS cipher suite upgrade",
"status": "Enabled"
}
],
"unmaskedIpLoggingStatus": "Enabled"
},
"systemData": {
"createdBy": "string",
"createdByType": "User",
"createdAt": "2020-04-27T21:53:29.0928001Z",
"lastModifiedBy": "string",
"lastModifiedByType": "User",
"lastModifiedAt": "2020-04-27T21:53:29.0928001Z"
}
}
]
}
Definições
Nome | Description |
---|---|
Additional |
Lista de tipos de dados enviados para o workspace |
Additional |
Propriedades dos workspaces adicionais. |
Additional |
Tipo de workspace. |
Cloud |
Resposta de erro comum para todas as APIs do Azure Resource Manager retornarem detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.). |
Cloud |
O detalhe do erro. |
created |
O tipo de identidade que criou o recurso. |
Data |
Fontes de dados desabilitadas. Desabilitar essas fontes de dados compromete o sistema. |
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Export |
Lista de opções adicionais para exportação para dados do workspace. |
Io |
Configuração da solução de Segurança IoT e informações de recursos. |
Io |
Lista de soluções de Segurança IoT. |
Recommendation |
Status da recomendação. Quando o status da recomendação é desabilitado, as recomendações não são geradas. |
Recommendation |
O tipo de recomendação de Segurança IoT. |
Recommendation |
O tipo de recomendação de Segurança IoT. |
Security |
Status da solução de Segurança IoT. |
system |
Metadados relativos à criação e última modificação do recurso. |
Unmasked |
Status do registro em log de endereço IP desmascarado |
User |
Propriedades dos recursos definidos pelo usuário da solução de Segurança IoT. |
AdditionalWorkspaceDataType
Lista de tipos de dados enviados para o workspace
Nome | Tipo | Description |
---|---|---|
Alerts |
string |
|
RawEvents |
string |
AdditionalWorkspacesProperties
Propriedades dos workspaces adicionais.
Nome | Tipo | Valor padrão | Description |
---|---|---|---|
dataTypes |
Lista de tipos de dados enviados para o workspace |
||
type | Sentinel |
Tipo de workspace. |
|
workspace |
string |
ID do recurso do workspace |
AdditionalWorkspaceType
Tipo de workspace.
Nome | Tipo | Description |
---|---|---|
Sentinel |
string |
CloudError
Resposta de erro comum para todas as APIs do Azure Resource Manager retornarem detalhes de erro para operações com falha. (Isso também segue o formato de resposta de erro OData.).
Nome | Tipo | Description |
---|---|---|
error.additionalInfo |
As informações adicionais do erro. |
|
error.code |
string |
O código de erro. |
error.details |
Os detalhes do erro. |
|
error.message |
string |
A mensagem de erro. |
error.target |
string |
O destino do erro. |
CloudErrorBody
O detalhe do erro.
Nome | Tipo | Description |
---|---|---|
additionalInfo |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
createdByType
O tipo de identidade que criou o recurso.
Nome | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DataSource
Fontes de dados desabilitadas. Desabilitar essas fontes de dados compromete o sistema.
Nome | Tipo | Description |
---|---|---|
TwinData |
string |
Dados de dispositivos gêmeos |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
Nome | Tipo | Description |
---|---|---|
info |
object |
As informações adicionais. |
type |
string |
O tipo de informação adicional. |
ExportData
Lista de opções adicionais para exportação para dados do workspace.
Nome | Tipo | Description |
---|---|---|
RawEvents |
string |
Eventos brutos do agente |
IoTSecuritySolutionModel
Configuração da solução de Segurança IoT e informações de recursos.
Nome | Tipo | Valor padrão | Description |
---|---|---|---|
id |
string |
ID do recurso |
|
location |
string |
O local do recurso. |
|
name |
string |
Nome do recurso |
|
properties.additionalWorkspaces |
Lista de workspaces adicionais |
||
properties.autoDiscoveredResources |
string[] |
Lista de recursos que foram descobertos automaticamente como relevantes para a solução de segurança. |
|
properties.disabledDataSources |
Fontes de dados desabilitadas. Desabilitar essas fontes de dados compromete o sistema. |
||
properties.displayName |
string |
Nome de exibição do recurso. |
|
properties.export |
Lista de opções adicionais para exportação para dados do workspace. |
||
properties.iotHubs |
string[] |
IDs de recursos do Hub IoT |
|
properties.recommendationsConfiguration |
Lista do status de configuração para cada tipo de recomendação. |
||
properties.status | Enabled |
Status da solução de Segurança IoT. |
|
properties.unmaskedIpLoggingStatus | Disabled |
Status do registro em log de endereço IP desmascarado |
|
properties.userDefinedResources |
Propriedades dos recursos definidos pelo usuário da solução de Segurança IoT. |
||
properties.workspace |
string |
ID do recurso do workspace |
|
systemData |
Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy. |
||
tags |
object |
Marcas de recurso |
|
type |
string |
Tipo de recurso |
IoTSecuritySolutionsList
Lista de soluções de Segurança IoT.
Nome | Tipo | Description |
---|---|---|
nextLink |
string |
O URI a ser buscado na próxima página. |
value |
Lista de soluções de Segurança IoT |
RecommendationConfigStatus
Status da recomendação. Quando o status da recomendação é desabilitado, as recomendações não são geradas.
Nome | Tipo | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
RecommendationConfigurationProperties
O tipo de recomendação de Segurança IoT.
Nome | Tipo | Valor padrão | Description |
---|---|---|---|
name |
string |
||
recommendationType |
O tipo de recomendação de Segurança IoT. |
||
status | Enabled |
Status da recomendação. Quando o status da recomendação é desabilitado, as recomendações não são geradas. |
RecommendationType
O tipo de recomendação de Segurança IoT.
Nome | Tipo | Description |
---|---|---|
IoT_ACRAuthentication |
string |
O esquema de autenticação usado para efetuar pull de um módulo de borda de um repositório do ACR não usa a Autenticação da Entidade de Serviço. |
IoT_AgentSendsUnutilizedMessages |
string |
Atualmente, a capacidade de tamanho da mensagem do agente IoT está subutilizada, causando um aumento no número de mensagens enviadas. Ajuste os intervalos de mensagens para melhor utilização. |
IoT_Baseline |
string |
Problemas de configuração do sistema relacionados à segurança identificados. |
IoT_EdgeHubMemOptimize |
string |
Você pode otimizar o uso de memória do Hub de Borda desativando os cabeçalhos de protocolo para todos os protocolos não usados pelos módulos do Edge em sua solução. |
IoT_EdgeLoggingOptions |
string |
O registro em log está desabilitado para este módulo de borda. |
IoT_IPFilter_DenyAll |
string |
A Configuração de Filtro de IP deve ter regras definidas para tráfego permitido e deve negar todo o tráfego por padrão. |
IoT_IPFilter_PermissiveRule |
string |
Um intervalo de IP de origem de regras permitir filtro IP é muito grande. Regras excessivamente permissivas podem expor seu hub IoT a intendentes mal-intencionados. |
IoT_InconsistentModuleSettings |
string |
Uma minoria dentro de um grupo de segurança de dispositivo tem configurações inconsistentes do Módulo de Borda com o restante do grupo. |
IoT_InstallAgent |
string |
Instale o Agente de Segurança das Coisas do Azure. |
IoT_OpenPorts |
string |
Um ponto de extremidade de escuta foi encontrado no dispositivo. |
IoT_PermissiveFirewallPolicy |
string |
Uma política de firewall permitida foi encontrada (INPUT/OUTPUT). A política deve negar todo o tráfego por padrão e definir regras para permitir a comunicação necessária de/para o dispositivo. |
IoT_PermissiveInputFirewallRules |
string |
Foi encontrada uma regra no firewall que contém um padrão permissivo para uma ampla gama de endereços IP ou portas. |
IoT_PermissiveOutputFirewallRules |
string |
Foi encontrada uma regra no firewall que contém um padrão permissivo para uma ampla gama de endereços IP ou portas. |
IoT_PrivilegedDockerOptions |
string |
O módulo edge é configurado para ser executado no modo privilegiado, com funcionalidades extensas do Linux ou com acesso à rede no nível do host (enviar/receber dados para o computador host). |
IoT_SharedCredentials |
string |
Mesmas credenciais de autenticação para o Hub IoT usado por vários dispositivos. Isso pode indicar um dispositivo ilegítimo representando um dispositivo legítimo. Ele também expõe o risco de representação de dispositivo por um invasor. |
IoT_VulnerableTLSCipherSuite |
string |
Configurações de TLS inseguras detectadas. Atualização imediata recomendada. |
SecuritySolutionStatus
Status da solução de Segurança IoT.
Nome | Tipo | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
systemData
Metadados relativos à criação e última modificação do recurso.
Nome | Tipo | Description |
---|---|---|
createdAt |
string |
O carimbo de data/hora da criação de recursos (UTC). |
createdBy |
string |
A identidade que criou o recurso. |
createdByType |
O tipo de identidade que criou o recurso. |
|
lastModifiedAt |
string |
O carimbo de data/hora da última modificação do recurso (UTC) |
lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
lastModifiedByType |
O tipo de identidade que modificou o recurso pela última vez. |
UnmaskedIpLoggingStatus
Status do registro em log de endereço IP desmascarado
Nome | Tipo | Description |
---|---|---|
Disabled |
string |
O log de IP desmascarado está desabilitado |
Enabled |
string |
O log de IP desmascarado está habilitado |
UserDefinedResourcesProperties
Propriedades dos recursos definidos pelo usuário da solução de Segurança IoT.
Nome | Tipo | Description |
---|---|---|
query |
string |
Consulta do Azure Resource Graph que representa os recursos definidos pelo usuário da solução de segurança. Necessário para começar com "where type != "Microsoft.Devices/IotHubs"" |
querySubscriptions |
string[] |
Lista de IDs de assinatura do Azure nas quais a consulta de recursos definidos pelo usuário deve ser executada. |