Assessments - Create Or Update

リファレンス

Service:: Defender for Cloud

API Version:: 2020-01-01

リソースにセキュリティ評価を作成します。この評価を記述する評価メタデータは、評価結果を挿入する前に同じ名前で定義済みである必要があります

PUT https://management.azure.com/{resourceId}/providers/Microsoft.Security/assessments/{assessmentName}?api-version=2020-01-01

URI パラメーター

名前	/	必須	型	説明
assessmentName	path	True	string	評価キー - 評価の種類の一意キー
resourceId	path	True	string	リソースの識別子。
api-version	query	True	string	操作の API バージョン

要求本文

名前	必須	型	説明
properties.resourceDetails	True	ResourceDetails: OnPremiseResourceDetails AzureResourceDetails OnPremiseSqlResourceDetails	評価されたリソースの詳細
properties.status	True	AssessmentStatus	評価の結果
properties.additionalData		object	評価に関するその他のデータ
properties.metadata		SecurityAssessmentMetadataProperties	評価メタデータのプロパティについて説明します。
properties.partnersData		SecurityAssessmentPartnerData	サードパーティのパートナー統合に関するデータ

応答

名前	型	説明
200 OK	SecurityAssessment	OK - 更新済み
201 Created	SecurityAssessment	作成済み
Other Status Codes	CloudError	操作に失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

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

Scopes

名前	説明
user_impersonation	ユーザーアカウントの借用

例

Create security recommendation task on a resource

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss2/providers/Microsoft.Security/assessments/8bb8be0a-6010-4789-812f-e4d661c4ed0e?api-version=2020-01-01

{
  "properties": {
    "resourceDetails": {
      "source": "Azure"
    },
    "status": {
      "code": "Healthy"
    }
  }
}

Sample Response

Status code:: 200

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1/providers/Microsoft.Security/assessments/8bb8be0a-6010-4789-812f-e4d661c4ed0e",
  "name": "8bb8be0a-6010-4789-812f-e4d661c4ed0e",
  "type": "Microsoft.Security/assessments",
  "properties": {
    "resourceDetails": {
      "source": "Azure",
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1/providers/Microsoft.Security/assessments/8bb8be0a-6010-4789-812f-e4d661c4ed0e"
    },
    "displayName": "Install internal agent on VM",
    "status": {
      "code": "Healthy"
    }
  }
}

Status code:: 201

{
  "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1/providers/Microsoft.Security/assessments/8bb8be0a-6010-4789-812f-e4d661c4ed0e",
  "name": "8bb8be0a-6010-4789-812f-e4d661c4ed0e",
  "type": "Microsoft.Security/assessments",
  "properties": {
    "resourceDetails": {
      "source": "Azure",
      "id": "/subscriptions/20ff7fc3-e762-44dd-bd96-b71116dcdc23/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachineScaleSets/vmss1/providers/Microsoft.Security/assessments/8bb8be0a-6010-4789-812f-e4d661c4ed0e"
    },
    "displayName": "Install internal agent on VM",
    "status": {
      "code": "Healthy"
    }
  }
}

定義

名前	説明
AssessmentLinks	評価に関連するリンク
AssessmentStatus	評価の結果
AssessmentStatusCode	評価の状態のプログラムコード
assessmentType	組み込みのAzure Policy定義に基づく評価の場合は BuiltIn、カスタム Azure Policy定義に基づく評価の場合は Custom
AzureResourceDetails	評価された Azure リソースの詳細
categories
CloudError	失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API に対する一般的なエラー応答 (これは OData エラー応答形式にも従います)。
CloudErrorBody	エラーの詳細。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
implementationEffort	この評価を修復するために必要な実装作業
OnPremiseResourceDetails	評価されたオンプレミスリソースの詳細
OnPremiseSqlResourceDetails	評価されたオンプレミス Sql リソースの詳細
SecurityAssessment	リソースのセキュリティ評価
SecurityAssessmentMetadataPartnerData	評価を作成したパートナーについて説明します
SecurityAssessmentMetadataProperties	評価メタデータのプロパティについて説明します。
SecurityAssessmentPartnerData	サードパーティのパートナー統合に関するデータ
severity	評価の重大度レベル
threats
userImpact	評価のユーザーへの影響

AssessmentLinks

評価に関連するリンク

名前	型	説明
azurePortalUri	string	Azure Portal での評価へのリンク

AssessmentStatus

評価の結果

名前	型	説明
cause	string	評価状態の原因のプログラムコード
code	AssessmentStatusCode	評価の状態のプログラムコード
description	string	人間が判読できる評価状態の説明

AssessmentStatusCode

評価の状態のプログラムコード

名前	型	説明
Healthy	string	リソースが正常である
NotApplicable	string	このリソースの評価が行われませんでした
Unhealthy	string	リソースに対処する必要があるセキュリティの問題がある

assessmentType

組み込みのAzure Policy定義に基づく評価の場合は BuiltIn、カスタム Azure Policy定義に基づく評価の場合は Custom

名前	型	説明
BuiltIn	string	クラウド管理評価のMicrosoft Defender
CustomPolicy	string	Azure Policy から Microsoft Defender for Cloud に自動的に取り込まれるユーザー定義ポリシー
CustomerManaged	string	ユーザーまたは他のサードパーティが直接 cloud のMicrosoft Defenderにプッシュするユーザー評価
VerifiedPartner	string	ユーザーが ASC に接続した場合に、検証済みのサードパーティによって作成された評価

AzureResourceDetails

評価された Azure リソースの詳細

名前	型	説明
id	string	評価されたリソースの Azure リソース ID
source	string: Azure	評価されたリソースが存在するプラットフォーム

名前	型	説明
Compute	string
Data	string
IdentityAndAccess	string
IoT	string
Networking	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	エラーのターゲット。

ErrorAdditionalInfo

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

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

implementationEffort

この評価を修復するために必要な実装作業

名前	型	説明
High	string
Low	string
Moderate	string

OnPremiseResourceDetails

評価されたオンプレミスリソースの詳細

名前	型	説明
machineName	string	マシンの名前
source	string: OnPremise	評価されたリソースが存在するプラットフォーム
sourceComputerId	string	マシンにインストールされている oms エージェント ID
vmuuid	string	マシンの一意の ID
workspaceId	string	マシンがアタッチされているワークスペースの Azure リソース ID

OnPremiseSqlResourceDetails

評価されたオンプレミス Sql リソースの詳細

名前	型	説明
databaseName	string	マシンにインストールされている Sql データベース名
machineName	string	マシンの名前
serverName	string	マシンにインストールされている SQL サーバー名
source	string: OnPremiseSql	評価されたリソースが存在するプラットフォーム
sourceComputerId	string	マシンにインストールされている oms エージェント ID
vmuuid	string	マシンの一意の ID
workspaceId	string	マシンがアタッチされているワークスペースの Azure リソース ID

SecurityAssessment

リソースのセキュリティ評価

名前	型	説明
id	string	リソース ID
name	string	リソース名
properties.additionalData	object	評価に関するその他のデータ
properties.displayName	string	評価のわかりやすい表示名
properties.links	AssessmentLinks	評価に関連するリンク
properties.metadata	SecurityAssessmentMetadataProperties	評価メタデータのプロパティについて説明します。
properties.partnersData	SecurityAssessmentPartnerData	サードパーティのパートナー統合に関するデータ
properties.resourceDetails	ResourceDetails: AzureResourceDetails OnPremiseResourceDetails OnPremiseSqlResourceDetails	評価されたリソースの詳細
properties.status	AssessmentStatus	評価の結果
type	string	リソースの種類

SecurityAssessmentMetadataPartnerData

評価を作成したパートナーについて説明します

名前	型	説明
partnerName	string	パートナーの会社の名前
productName	string	評価を作成したパートナーの製品の名前
secret	string	パートナーを認証し、評価が作成されたことを確認するためのシークレット - 書き込み専用

SecurityAssessmentMetadataProperties

評価メタデータのプロパティについて説明します。

名前	型	説明
assessmentType	assessmentType	組み込みのAzure Policy定義に基づく評価の場合は BuiltIn、カスタム Azure Policy定義に基づく評価の場合は Custom
categories	categories[]	評価が異常な場合に危険にさらされるリソースのカテゴリ
description	string	評価の人間が判読できる説明
displayName	string	評価のわかりやすい表示名
implementationEffort	implementationEffort	この評価を修復するために必要な実装作業
partnerData	SecurityAssessmentMetadataPartnerData	評価を作成したパートナーについて説明します
policyDefinitionId	string	この評価の計算を有効にするポリシー定義の Azure リソース ID
preview	boolean	この評価がプレビューリリースの状態にある場合は True
remediationDescription	string	このセキュリティ問題を軽減するために行う必要がある操作の人間が判読できる説明
severity	severity	評価の重大度レベル
threats	threats[]	評価の脅威の影響
userImpact	userImpact	評価のユーザーへの影響

SecurityAssessmentPartnerData

サードパーティのパートナー統合に関するデータ

名前	型	説明
partnerName	string	パートナーの会社の名前
secret	string	パートナーを認証するためのシークレット - 書き込み専用

severity

評価の重大度レベル

名前	型	説明
High	string
Low	string
Medium	string

threats

名前	型	説明
accountBreach	string
dataExfiltration	string
dataSpillage	string
denialOfService	string
elevationOfPrivilege	string
maliciousInsider	string
missingCoverage	string
threatResistance	string

userImpact

評価のユーザーへの影響

名前	型	説明
High	string
Low	string
Moderate	string

次の方法で共有