次の方法で共有


Iot Security Solution - List By Resource Group

リソース グループ別に整理された IoT セキュリティ ソリューションの一覧を取得するには、このメソッドを使用します。

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}

URI パラメーター

名前 / 必須 説明
resourceGroupName
path True

string

ユーザーのサブスクリプション内のリソース グループの名前。 名前では大文字と小文字が区別されません。

正規表現パターン: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Azure サブスクリプション ID

正規表現パターン: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version
query True

string

操作の API バージョン

$filter
query

string

OData 構文を使用して IoT セキュリティ ソリューションをフィルター処理します。 iotHubs によるフィルター処理をサポートします。

応答

名前 説明
200 OK

IoTSecuritySolutionsList

わかりました

Other Status Codes

CloudError

操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

List IoT Security solutions by resource group
List IoT Security solutions by resource group and IoT Hub

List IoT Security solutions by resource group

要求のサンプル

GET https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/MyGroup/providers/Microsoft.Security/iotSecuritySolutions?api-version=2019-08-01

応答のサンプル

{
  "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

要求のサンプル

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")

応答のサンプル

{
  "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"
      }
    }
  ]
}

定義

名前 説明
AdditionalWorkspaceDataType

ワークスペースに送信されるデータ型の一覧

AdditionalWorkspacesProperties

追加のワークスペースのプロパティ。

AdditionalWorkspaceType

ワークスペースの種類。

CloudError

失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API の一般的なエラー応答。 (これは、OData エラー応答形式にも従います)。

CloudErrorBody

エラーの詳細。

createdByType

リソースを作成した ID の種類。

DataSource

無効なデータ ソース。 これらのデータ ソースを無効にすると、システムが侵害されます。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

ExportData

ワークスペース データにエクスポートするためのその他のオプションの一覧。

IoTSecuritySolutionModel

IoT セキュリティ ソリューションの構成とリソース情報。

IoTSecuritySolutionsList

IoT セキュリティ ソリューションの一覧。

RecommendationConfigStatus

推奨事項の状態。 推奨事項の状態が無効になっている場合、推奨事項は生成されません。

RecommendationConfigurationProperties

IoT セキュリティに関する推奨事項の種類。

RecommendationType

IoT セキュリティに関する推奨事項の種類。

SecuritySolutionStatus

IoT セキュリティ ソリューションの状態。

systemData

リソースの作成と最後の変更に関連するメタデータ。

UnmaskedIpLoggingStatus

マスクされていない IP アドレスのログ記録の状態

UserDefinedResourcesProperties

IoT セキュリティ ソリューションのユーザー定義リソースのプロパティ。

AdditionalWorkspaceDataType

ワークスペースに送信されるデータ型の一覧

名前 説明
Alerts

string

RawEvents

string

AdditionalWorkspacesProperties

追加のワークスペースのプロパティ。

名前 規定値 説明
dataTypes

AdditionalWorkspaceDataType[]

ワークスペースに送信されるデータ型の一覧

type

AdditionalWorkspaceType

Sentinel

ワークスペースの種類。

workspace

string

ワークスペース リソース ID

AdditionalWorkspaceType

ワークスペースの種類。

名前 説明
Sentinel

string

CloudError

失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API の一般的なエラー応答。 (これは、OData エラー応答形式にも従います)。

名前 説明
error.additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

error.code

string

エラー コード。

error.details

CloudErrorBody[]

エラーの詳細。

error.message

string

エラー メッセージ。

error.target

string

エラーターゲット。

CloudErrorBody

エラーの詳細。

名前 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

CloudErrorBody[]

エラーの詳細。

message

string

エラー メッセージ。

target

string

エラーターゲット。

createdByType

リソースを作成した ID の種類。

名前 説明
Application

string

Key

string

ManagedIdentity

string

User

string

DataSource

無効なデータ ソース。 これらのデータ ソースを無効にすると、システムが侵害されます。

名前 説明
TwinData

string

デバイス ツイン データ

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前 説明
info

object

追加情報。

type

string

追加情報の種類。

ExportData

ワークスペース データにエクスポートするためのその他のオプションの一覧。

名前 説明
RawEvents

string

エージェント生イベント

IoTSecuritySolutionModel

IoT セキュリティ ソリューションの構成とリソース情報。

名前 規定値 説明
id

string

リソース ID

location

string

リソースの場所。

name

string

リソース名

properties.additionalWorkspaces

AdditionalWorkspacesProperties[]

その他のワークスペースの一覧

properties.autoDiscoveredResources

string[]

セキュリティ ソリューションに関連するものとして自動的に検出されたリソースの一覧。

properties.disabledDataSources

DataSource[]

無効なデータ ソース。 これらのデータ ソースを無効にすると、システムが侵害されます。

properties.displayName

string

リソースの表示名。

properties.export

ExportData[]

ワークスペース データにエクスポートするためのその他のオプションの一覧。

properties.iotHubs

string[]

IoT Hub リソース ID

properties.recommendationsConfiguration

RecommendationConfigurationProperties[]

各推奨事項の種類の構成状態の一覧。

properties.status

SecuritySolutionStatus

Enabled

IoT セキュリティ ソリューションの状態。

properties.unmaskedIpLoggingStatus

UnmaskedIpLoggingStatus

Disabled

マスクされていない IP アドレスのログ記録の状態

properties.userDefinedResources

UserDefinedResourcesProperties

IoT セキュリティ ソリューションのユーザー定義リソースのプロパティ。

properties.workspace

string

ワークスペース リソース ID

systemData

systemData

createdBy と modifiedBy 情報を含む Azure Resource Manager メタデータ。

tags

object

リソース タグ

type

string

リソースの種類

IoTSecuritySolutionsList

IoT セキュリティ ソリューションの一覧。

名前 説明
nextLink

string

次のページをフェッチする URI。

value

IoTSecuritySolutionModel[]

IoT セキュリティ ソリューションの一覧

RecommendationConfigStatus

推奨事項の状態。 推奨事項の状態が無効になっている場合、推奨事項は生成されません。

名前 説明
Disabled

string

Enabled

string

RecommendationConfigurationProperties

IoT セキュリティに関する推奨事項の種類。

名前 規定値 説明
name

string

recommendationType

RecommendationType

IoT セキュリティに関する推奨事項の種類。

status

RecommendationConfigStatus

Enabled

推奨事項の状態。 推奨事項の状態が無効になっている場合、推奨事項は生成されません。

RecommendationType

IoT セキュリティに関する推奨事項の種類。

名前 説明
IoT_ACRAuthentication

string

ACR リポジトリからエッジ モジュールをプルするために使用される認証スキーマでは、サービス プリンシパル認証は使用されません。

IoT_AgentSendsUnutilizedMessages

string

IoT エージェントのメッセージ サイズの容量は現在使用率が低く、送信されたメッセージの数が増加しています。 メッセージの間隔を調整して、使用率を向上します。

IoT_Baseline

string

特定されたセキュリティ関連のシステム構成の問題。

IoT_EdgeHubMemOptimize

string

ソリューション内の Edge モジュールで使用されていないプロトコルのプロトコル ヘッドをオフにすることで、Edge Hub のメモリ使用量を最適化できます。

IoT_EdgeLoggingOptions

string

このエッジ モジュールのログ記録は無効になっています。

IoT_IPFilter_DenyAll

string

IP フィルター構成には、許可されたトラフィックに対してルールが定義されている必要があり、既定では他のすべてのトラフィックを拒否する必要があります。

IoT_IPFilter_PermissiveRule

string

許可 IP フィルター 規則のソース IP 範囲が大きすぎます。 規則が過度に制限されると、悪意のある意図者に IoT ハブが公開される可能性があります。

IoT_InconsistentModuleSettings

string

デバイス セキュリティ グループ内の少数派が、そのグループの残りの部分と一貫性のない Edge モジュール設定を持っています。

IoT_InstallAgent

string

Azure Security of Things エージェントをインストールします。

IoT_OpenPorts

string

デバイスでリッスンしているエンドポイントが見つかりました。

IoT_PermissiveFirewallPolicy

string

許可されたファイアウォール ポリシーが見つかりました (INPUT/OUTPUT)。 ポリシーでは、既定ですべてのトラフィックを拒否し、デバイスとの間で必要な通信を許可する規則を定義する必要があります。

IoT_PermissiveInputFirewallRules

string

ファイアウォール内の規則が見つかりました。この規則には、さまざまな IP アドレスまたはポートに対して許容されるパターンが含まれています。

IoT_PermissiveOutputFirewallRules

string

ファイアウォール内の規則が見つかりました。この規則には、さまざまな IP アドレスまたはポートに対して許容されるパターンが含まれています。

IoT_PrivilegedDockerOptions

string

Edge モジュールは、広範な Linux 機能またはホスト レベルのネットワーク アクセス (ホスト コンピューターへのデータの送受信) を使用して、特権モードで実行するように構成されています。

IoT_SharedCredentials

string

複数のデバイスで使用される IoT Hub に対して同じ認証資格情報。 これは、正当なデバイスを偽装している不正なデバイスを示している可能性があります。 また、攻撃者によるデバイス偽装のリスクも公開されます。

IoT_VulnerableTLSCipherSuite

string

セキュリティで保護されていない TLS 構成が検出されました。 即時アップグレードをお勧めします。

SecuritySolutionStatus

IoT セキュリティ ソリューションの状態。

名前 説明
Disabled

string

Enabled

string

systemData

リソースの作成と最後の変更に関連するメタデータ。

名前 説明
createdAt

string

リソース作成のタイムスタンプ (UTC)。

createdBy

string

リソースを作成した ID。

createdByType

createdByType

リソースを作成した ID の種類。

lastModifiedAt

string

リソースの最終変更のタイムスタンプ (UTC)

lastModifiedBy

string

リソースを最後に変更した ID。

lastModifiedByType

createdByType

リソースを最後に変更した ID の種類。

UnmaskedIpLoggingStatus

マスクされていない IP アドレスのログ記録の状態

名前 説明
Disabled

string

マスクされていない IP ログが無効になっている

Enabled

string

マスクされていない IP ログが有効になっている

UserDefinedResourcesProperties

IoT セキュリティ ソリューションのユーザー定義リソースのプロパティ。

名前 説明
query

string

セキュリティ ソリューションのユーザー定義リソースを表す Azure Resource Graph クエリ。 "where type != "Microsoft.Devices/IotHubs" で始める必要があります

querySubscriptions

string[]

ユーザー定義リソース クエリを実行する必要がある Azure サブスクリプション ID の一覧。