次の方法で共有


Assessments Metadata - Create In Subscription

特定のサブスクリプションで評価の種類に関するメタデータ情報を作成する

PUT https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Security/assessmentMetadata/{assessmentMetadataName}?api-version=2020-01-01

URI パラメーター

名前 / 必須 説明
assessmentMetadataName
path True

string

評価キー - 評価の種類の一意キー

subscriptionId
path True

string

Azure サブスクリプション ID

Regex pattern: ^[0-9A-Fa-f]{8}-([0-9A-Fa-f]{4}-){3}[0-9A-Fa-f]{12}$

api-version
query True

string

操作の API バージョン

要求本文

名前 必須 説明
properties.assessmentType True

assessmentType

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

properties.displayName True

string

評価のわかりやすい表示名

properties.severity True

severity

評価の重大度レベル

properties.categories

categories[]

評価が異常な場合に危険にさらされるリソースのカテゴリ

properties.description

string

評価の人間が判読できる説明

properties.implementationEffort

implementationEffort

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

properties.partnerData

SecurityAssessmentMetadataPartnerData

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

properties.preview

boolean

この評価がプレビュー リリースの状態にある場合は True

properties.remediationDescription

string

このセキュリティ問題を軽減するために行う必要がある操作の人間が判読できる説明

properties.threats

threats[]

評価の脅威の影響

properties.userImpact

userImpact

評価のユーザーへの影響

応答

名前 説明
200 OK

SecurityAssessmentMetadata

OK

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 assessment metadata for subscription

Sample Request

PUT https://management.azure.com/subscriptions/0980887d-03d6-408c-9566-532f3456804e/providers/Microsoft.Security/assessmentMetadata/ca039e75-a276-4175-aebc-bcd41e4b14b7?api-version=2020-01-01

{
  "properties": {
    "displayName": "Install endpoint protection solution on virtual machine scale sets",
    "description": "Install an endpoint protection solution on your virtual machines scale sets, to protect them from threats and vulnerabilities.",
    "remediationDescription": "To install an endpoint protection solution: 1.  <a href=\"https://docs.microsoft.com/azure/virtual-machine-scale-sets/virtual-machine-scale-sets-faq#how-do-i-turn-on-antimalware-in-my-virtual-machine-scale-set\">Follow the instructions in How do I turn on antimalware in my virtual machine scale set</a>",
    "categories": [
      "Compute"
    ],
    "severity": "Medium",
    "userImpact": "Low",
    "implementationEffort": "Low",
    "threats": [
      "dataExfiltration",
      "dataSpillage",
      "maliciousInsider"
    ],
    "assessmentType": "CustomerManaged"
  }
}

Sample Response

{
  "id": "/providers/Microsoft.Security/assessmentMetadata/ca039e75-a276-4175-aebc-bcd41e4b14b7",
  "name": "ca039e75-a276-4175-aebc-bcd41e4b14b7",
  "type": "Microsoft.Security/assessmentMetadata",
  "properties": {
    "displayName": "My organization security assessment",
    "description": "Assessment that my organization created to view our security assessment in Azure Security Center",
    "remediationDescription": "Fix it with these remediation instructions",
    "categories": [
      "Compute"
    ],
    "severity": "Medium",
    "userImpact": "Low",
    "implementationEffort": "Low",
    "threats": [
      "dataExfiltration",
      "dataSpillage",
      "maliciousInsider"
    ],
    "assessmentType": "CustomerManaged"
  }
}

定義

名前 説明
assessmentType

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

categories
CloudError

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

CloudErrorBody

エラーの詳細。

ErrorAdditionalInfo

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

implementationEffort

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

SecurityAssessmentMetadata

セキュリティ評価メタデータ

SecurityAssessmentMetadataPartnerData

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

severity

評価の重大度レベル

threats
userImpact

評価のユーザーへの影響

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 に接続した場合に、検証済みのサード パーティによって作成された評価

categories

名前 説明
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

SecurityAssessmentMetadata

セキュリティ評価メタデータ

名前 説明
id

string

リソース ID

name

string

リソース名

properties.assessmentType

assessmentType

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

properties.categories

categories[]

評価が異常な場合に危険にさらされるリソースのカテゴリ

properties.description

string

評価の人間が判読できる説明

properties.displayName

string

評価のわかりやすい表示名

properties.implementationEffort

implementationEffort

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

properties.partnerData

SecurityAssessmentMetadataPartnerData

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

properties.policyDefinitionId

string

この評価の計算を有効にするポリシー定義の Azure リソース ID

properties.preview

boolean

この評価がプレビュー リリースの状態にある場合は True

properties.remediationDescription

string

このセキュリティ問題を軽減するために行う必要がある操作の人間が判読できる説明

properties.severity

severity

評価の重大度レベル

properties.threats

threats[]

評価の脅威の影響

properties.userImpact

userImpact

評価のユーザーへの影響

type

string

リソースの種類

SecurityAssessmentMetadataPartnerData

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

名前 説明
partnerName

string

パートナーの会社の名前

productName

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