Microsoft Defender SOC (プレビュー)

Microsoft Defenderイベントと Sentinel イベントに基づいて自動化されたワークフローをトリガーします。 セキュリティ アラートとケース管理 (一般的なケースとインシデント ケース) に対して個別のトリガーを提供し、正規化されたイベント データをダウンストリーム ワークフローに配信します。

このコネクタは、次の製品とリージョンで使用できます。

Service クラス Regions
コピロット スタジオ Premium 次を除くすべてのPower Automateリージョン:
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
Power Apps Premium 次を除くすべてのPower Appsリージョン:
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
Power Automate(パワーオートメート) Premium 次を除くすべてのPower Automateリージョン:
     - 米国政府 (GCC)
     - 米国政府 (GCC High)
     - 21Vianet が運営する China Cloud
     - 米国国防総省 (DoD)
連絡先
Name マイクロソフト
URL https://support.microsoft.com
コネクタ メタデータ
パブリッシャー マイクロソフト
Web サイト https://security.microsoft.com
プライバシー ポリシー https://privacy.microsoft.com
カテゴリ セキュリティ

Microsoft Defender SOC コネクタ

このコネクタを使用して、Microsoft DefenderとMicrosoft Sentinel自動化から Logic Apps ワークフローを開始します。

使用可能なトリガー

  • SOC アラートMicrosoft Defender、正規化されたMicrosoft Graphセキュリティ アラート ペイロードを受け取ります。
  • Microsoft Defender SOC ケースは、汎用ケースとインシデント ケースの種類を含む、正規化されたMicrosoft Graphセキュリティ ケース ペイロードを受け取ります。

コネクタは、Logic Apps にトリガーを登録します。 Microsoft Defenderオートメーションは、ロジック アプリのコールバックを解決し、自動化ルールの実行時にアラートまたはケース ペイロードを送信します。

Authentication

コネクタはMicrosoft Entra ID認証を使用します。 接続を作成する ID は、ワークフローを呼び出すMicrosoft DefenderまたはMicrosoft Sentinel自動化シナリオに対して承認されている必要があります。

既知の制限

Logic Apps の [実行] トリガー ボタンには、Microsoft Defenderアラートまたはケース ペイロードが表示されません。 Microsoft Defender自動化を使用するか、既存の Logic Apps の実行を再送信して、ワークフローをテストします。

接続を作成する

コネクタでは、次の認証の種類がサポートされています。

デフォルト 接続を作成するためのパラメーター。 すべてのリージョン 共有できません

デフォルト

適用対象: すべてのリージョン

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

トリガー

MICROSOFT DEFENDER SOC アラート

Defender ポータルから自動化ルールの評価または手動トリガーの後にMicrosoft Defenderまたは Sentinel アラートが作成されたときにトリガーされ、正規化されたアラート データがダウンストリーム ワークフローに提供されます。

Microsoft Defender SOC ケース

Microsoft Defenderまたは Sentinel ケースが作成または更新されたときにトリガーされ、正規化されたケース データがダウンストリーム ワークフローに提供されます。 具体的なケースの種類 (ジェネリックまたはインシデント) は、'@odata.type' 識別子によって示されます。

MICROSOFT DEFENDER SOC アラート

Defender ポータルから自動化ルールの評価または手動トリガーの後にMicrosoft Defenderまたは Sentinel アラートが作成されたときにトリガーされ、正規化されたアラート データがダウンストリーム ワークフローに提供されます。

返品

Microsoft Graph セキュリティ アラート (microsoft.graph.security.alert) ペイロード。

Microsoft Defender SOC ケース

Microsoft Defenderまたは Sentinel ケースが作成または更新されたときにトリガーされ、正規化されたケース データがダウンストリーム ワークフローに提供されます。 具体的なケースの種類 (ジェネリックまたはインシデント) は、'@odata.type' 識別子によって示されます。

返品

Microsoft Graphセキュリティ ケース (microsoft.graph.security.caseManagement.case) ペイロード。 具象ケースの種類は、"@odata.type" 識別子 (genericCase または incidentCase) で示されます。 サブタイプ固有のプロパティは、一致するケースの種類に対してのみ設定されます。

定義

GraphSecurityAlert

Microsoft Graph セキュリティ アラート (microsoft.graph.security.alert) ペイロード。

名前 パス 説明
識別子
id string

アラート リソースを表す一意の識別子。

providerAlertId
providerAlertId string

アラートを生成したセキュリティ プロバイダー製品に表示されるアラートの ID。

incidentId
incidentId string

このアラート リソースが関連付けられているインシデントを表す一意の識別子。

tenantId
tenantId string

アラートが作成された Microsoft Entra テナント。

title
title string

警告を説明する簡単な識別文字列値。

description
description string

各アラートを説明する文字列値。

重大度
severity string

資産への影響の可能性を示します。 指定できる値は、unknown、informational、low、medium、high、unknownFutureValue です。

状態
status string

アラートの状態。 指定できる値は、unknown、new、inProgress、resolved、unknownFutureValue です。

classification
classification string

アラートが真の脅威を表すかどうかを指定します。 指定できる値は、unknown、falsePositive、truePositive、informationalExpectedActivity、unknownFutureValue です。

判定
determination string

調査の結果を指定します。 指定できる値は、unknown、apt、malware、securityPersonnel、securityTesting、unwantedSoftware、other、multiStagedAttack、compromisedAccount、phishing、maliciousUserActivity、notMalicious、notEnoughDataToValidate、confirmedUserActivity、lineOfBusinessApplication、unknownFutureValue です。

serviceSource
serviceSource string

このアラートを作成したサービスまたは製品。 指定できる値は次のとおりです。unknown、microsoftDefenderForEndpoint、microsoftDefenderForIdentity、 microsoftDefenderForCloudApps,microsoftDefenderForOffice365, microsoft365Defender, azureAdIdentityProtection, microsoftAppGovernance, dataLossPrevention, microsoftDefenderForCloud, microsoftSentinel, microsoftInsiderRiskManagement, microsoftDefenderForIoT, microsoftDefenderForStorage, microsoftDefenderForDNS, microsoftDefenderForDatabases,microsoftDefenderForContainers、microsoftDefenderForNetwork、microsoftDefenderForAppService、microsoftDefenderForKeyVault、microsoftDefenderForResourceManager、microsoftDefenderForApiManagement、aadIdentityProtection、appGovernance、microsoftPurviewDataLossPrevention、unknownFutureValue。

detectionSource
detectionSource string

注目すべきコンポーネントまたはアクティビティを識別した検出テクノロジまたはセンサー。 指定できる値は次のとおりです。unknown、microsoftDefenderForEndpoint、ウイルス対策、 smartScreen,customTi, microsoftDefenderForOffice365, automatedInvestigation, microsoftThreatExperts, customDetection, microsoftDefenderForIdentity, cloudAppSecurity, microsoft365Defender, azureAdIdentityProtection, manual, microsoftDataLossPrevention, appGovernancePolicy, appGovernanceDetection, microsoftDefenderForCloud, microsoftDefenderForIoT, microsoftDefenderForIdents,Servers,microsoftDefenderForStorage、microsoftDefenderForDNS、 microsoftDefenderForDatabases、microsoftDefenderForContainers、microsoftDefenderForNetwork、microsoftDefenderForAppService、microsoftDefenderForKeyVault、microsoftDefenderForResourceManager、microsoftDefenderForApiManagement、microsoftSentinel、nrtAlerts、scheduledAlerts、microsoftDefenderThreatIntelligenceAnalytics、builtInMl、microsoftInsiderRiskManagement、unknownFutureValue。

productName
productName string

このアラートを発行した製品の名前。

detectorId
detectorId string

アラートをトリガーした検出システムの ID。

推奨アクション
recommendedActions string

このアラートが生成された場合に実行する推奨される対応および修復アクション。

カテゴリ
category string

(非推奨)アラートが属する攻撃キル チェーン カテゴリ。 代わりにカテゴリを使用してください。

categories
categories array of string

アラートが属する攻撃キル チェーン カテゴリ (MITRE ATT&CK がアライン)。

assignedTo
assignedTo string

アラートの所有者、所有者が割り当てられていない場合は null。

alertWebUrl
alertWebUrl string

Microsoft 365 Defender ポータルのアラート ページの URL。

incidentWebUrl
incidentWebUrl string

Microsoft 365 Defender ポータルのインシデント ページの URL。

actorDisplayName
actorDisplayName string

このアラートに関連付けられている敵対者またはアクティビティ グループ。

threatDisplayName
threatDisplayName string

このアラートに関連付けられている脅威。

threatFamilyName
threatFamilyName string

このアラートに関連付けられている脅威ファミリ。

mitreTechniques
mitreTechniques array of string

MITRE ATT&CK フレームワークに沿った攻撃手法。

作成日時
createdDateTime date-time

Microsoft 365 Defender がアラートを作成した時刻。

lastUpdateDateTime
lastUpdateDateTime date-time

Microsoft 365 Defender でアラートが最後に更新された時刻。

resolvedDateTime
resolvedDateTime date-time

アラートが解決された時刻。

firstActivityDateTime
firstActivityDateTime date-time

アラートに関連付けられている最も早いアクティビティ。

lastActivityDateTime
lastActivityDateTime date-time

アラートに関連付けられている最も古いアクティビティ。

comments
comments array of GraphAlertComment

アラート管理プロセス中に SecOps チームによって作成されたコメントの配列。

customDetails
customDetails GraphDictionary

動的フィールドのキー/値バッグ (Graph セキュリティ ディクショナリ。識別子でキー指定されたテナント定義のケース ユーザー設定フィールドにも使用されます)。

証拠
evidence array of GraphAlertEvidence

アラートに関連する証拠の収集。

systemTags
systemTags array of string

アラートに関連付けられているシステム タグ。

alertPolicyId
alertPolicyId string

アラートを生成し、アラートを生成した特定のポリシーがある場合に設定されるポリシーの ID (顧客が構成または組み込み)。

additionalData
additionalData GraphDictionary

動的フィールドのキー/値バッグ (Graph セキュリティ ディクショナリ。識別子でキー指定されたテナント定義のケース ユーザー設定フィールドにも使用されます)。

investigationState
investigationState string

調査の現在の状態に関する情報。 指定できる値は、不明、終了、正常に修復、無害、失敗、部分的に修復、実行中、pendingApproval、pendingResource、queued、innerFailure、preexistingAlert、unsupportedOs、unsupportedAlertType、suppressedAlert、partiallyInvestigated、terminatedByUser、terminatedByUser、terminatedBySystem、unknownFutureValue です。

GraphDictionary

動的フィールドのキー/値バッグ (Graph セキュリティ ディクショナリ。識別子でキー指定されたテナント定義のケース ユーザー設定フィールドにも使用されます)。

名前 パス 説明
object

動的フィールドのキー/値バッグ (Graph セキュリティ ディクショナリ。識別子でキー指定されたテナント定義のケース ユーザー設定フィールドにも使用されます)。

GraphAlertComment

アラート管理プロセス中に SecOps チームによって作成されたコメント。

名前 パス 説明
コメント
comment string

コメント テキストを指定します。

createdByDisplayName
createdByDisplayName string

コメントを作成したユーザーの表示名。

作成日時
createdDateTime date-time

コメントが作成された時刻。

GraphAlertEvidence

アラートに関連付けられている証拠項目。 具体的な証拠の種類は、"@odata.type" 識別子 (例: #microsoft.graph.security.deviceEvidence、#microsoft.graph.security.userEvidence など) で示されます。

名前 パス 説明
@odata.type
@odata.type string

具体的な証拠の種類の識別子 (例: "#microsoft.graph.security.deviceEvidence")。

作成日時
createdDateTime date-time

証拠が作成され、アラートに追加された時刻。

評決
verdict string

自動調査によって到達した決定。 指定できる値は、不明、疑わしい、悪意のある、noThreatsFound、unknownFutureValue です。

remediationStatus
remediationStatus string

実行された修復アクションの状態。 指定できる値は、none、remediated、prevented、blocked、notFound、active、pendingApproval、declined、notRemediated、running、partiallyRemediated、unknownFutureValue です。

remediationStatusDetails
remediationStatusDetails string

修復状態に関する詳細。

roles
roles array of string

アラートで証拠が果たす役割。 可能な項目の値には、不明、コンテキスト、スキャン、ソース、宛先、作成、追加、侵害、編集、攻撃、攻撃者、読み込み、疑わしい、policyViolator、unknownFutureValue などがあります。

detailedRoles
detailedRoles array of string

アラートの証拠によって果たされる詳細な役割。

tags
tags array of string

証拠に関連付けられているタグ。

GraphSecurityCase

Microsoft Graphセキュリティ ケース (microsoft.graph.security.caseManagement.case) ペイロード。 具象ケースの種類は、"@odata.type" 識別子 (genericCase または incidentCase) で示されます。 サブタイプ固有のプロパティは、一致するケースの種類に対してのみ設定されます。

名前 パス 説明
@odata.type
@odata.type string

具体的なケース型識別子 (例: "#microsoft.graph.security.caseManagement.incidentCase")。

識別子
id string

ケースの一意識別子。

displayName
displayName string

ケースのタイトル。

状態
status string

ケースの現在のライフサイクルの状態。

作成日時
createdDateTime date-time

ケースが作成された時刻。

createdBy
createdBy string

ケースを作成した ID。

lastModifiedDateTime
lastModifiedDateTime date-time

ケースが最後に変更された時刻。

最終更新者
lastModifiedBy string

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

customFields
customFields GraphDictionary

動的フィールドのキー/値バッグ (Graph セキュリティ ディクショナリ。識別子でキー指定されたテナント定義のケース ユーザー設定フィールドにも使用されます)。

description
description string

ケースの説明 (genericCase)。

assignedTo
assignedTo string

ケースの所有者。

priority
priority string

ケース優先度分類 (genericCase)。

dueDateTime
dueDateTime date-time

目標完了日。

閉じる注記
closingNotes string

クロージャ時に記録されたメモ (genericCase)。

emailNotificationRecipients
emailNotificationRecipients array of string

電子メール通知の受信者 (incidentCase)。

incidentId
incidentId integer

インシデント識別子 (incidentCase) をMicrosoft Securityします。

classification
classification string

インシデント分類 (incidentCase)。

判定
determination string

インシデントの決定 (incidentCase)。

重大度
severity string

インシデントの重大度 (incidentCase)。

概要
summary string

インシデントの概要 (incidentCase)。

priorityScore
priorityScore integer

インシデント優先度スコア (incidentCase)。

firstEventTime
firstEventTime date-time

最初のイベント タイムスタンプ (incidentCase)。

lastEventTime
lastEventTime date-time

最後のイベント タイムスタンプ (incidentCase)。

alertCounts
alertCounts CaseAlertCounts

インシデント ケースの集計アラート数。

impactedAssets
impactedAssets CaseImpactedAssetsCounts

インシデント ケースの影響を受ける資産の集計数。

調査
investigation CaseInvestigation

インシデント ケースの調査の概要。

topRiskScore
topRiskScore integer

トップ リスク スコア (incidentCase)。

detectionSources
detectionSources array of string

検出ソース (incidentCase)。

serviceSources
serviceSources array of string

サービス ソース (incidentCase)。

productNames
productNames array of string

製品名 (incidentCase)。

categories
categories array of string

インシデント カテゴリ (incidentCase)。

workspaceIds
workspaceIds array of string

ワークスペース識別子 (incidentCase)。

policyNames
policyNames array of string

ポリシー名 (incidentCase)。

alertPolicyIds
alertPolicyIds array of string

アラート ポリシー識別子 (incidentCase)。

dataSensitivityLabels
dataSensitivityLabels array of string

データ秘密度ラベル (incidentCase)。

cloudScopes
cloudScopes array of string

クラウド スコープ (incidentCase)。

dataStreams
dataStreams array of string

データ ストリーム (incidentCase)。

aiAgentIds
aiAgentIds array of string

AI エージェント識別子 (incidentCase)。

redirectIncidentId
redirectIncidentId integer

マージ時にインシデント識別子をリダイレクトする (incidentCase)。

redirectCaseId
redirectCaseId integer

マージ時のリダイレクト ケース識別子 (incidentCase)。

investigationIds
investigationIds array of string

調査識別子 (incidentCase)。

investigationStates
investigationStates array of string

調査の状態 (incidentCase)。

associatedThreatIds
associatedThreatIds array of string

関連付けられている脅威識別子 (incidentCase)。

osPlatforms
osPlatforms array of string

オペレーティング システム プラットフォーム (incidentCase)。

machineGroupIds
machineGroupIds array of string

マシン グループ識別子 (incidentCase)。

incidentWebUrl
incidentWebUrl string

インシデント Web URL (incidentCase)。

systemTags
systemTags array of string

システム タグ (incidentCase)。

リレーション
relations array of CaseRelation

ケースにリンクされている関連リソースのコレクション。

tasks
tasks array of CaseTask

ケースに含まれるタスクのコレクション。

activities
activities array of CaseActivity

ケースに含まれるタイムライン アクティビティ (コメントと監査ログ) のコレクション。

attachments
attachments array of CaseAttachment

ケースに含まれる添付ファイルのコレクション。

CaseActivity

ケース タイムライン アクティビティ。 具体的なアクティビティの種類は、'@odata.type' 識別子によって示されます。コメント (ユーザーが作成したフリー テキストで "メッセージ") または auditLog (システムによって生成された状態変更)。

名前 パス 説明
@odata.type
@odata.type string

具体的なアクティビティの種類識別子 (例: '#microsoft.graph.security.caseManagement.comment')。

識別子
id string

アクティビティの一意識別子。

作成日時
createdDateTime date-time

アクティビティが作成された時刻。

createdBy
createdBy string

アクティビティを作成した ID。

lastModifiedDateTime
lastModifiedDateTime date-time

アクティビティが最後に変更された時刻。

最終更新者
lastModifiedBy string

アクティビティを最後に変更した ID。

メッセージ
message string

コメント本文 (コメント アクティビティのみ)。

アクション
action string

実行されたアクションの種類 (auditLog アクティビティのみ)。

details
details CaseActivityResourceDetails

監査アクティビティのターゲット リソースの詳細。

modifiedProperties
modifiedProperties array of CaseModifiedProperty

プロパティデルタのコレクション (auditLog アクティビティのみ)。

CaseActivityResourceDetails

監査アクティビティのターゲット リソースの詳細。

名前 パス 説明
resourceId
resourceId string

ターゲット リソースの識別子。

kind
kind string

リソースの種類 (タスク、リレーションシップなど)。

CaseModifiedProperty

監査ログに記録された値デルタ。

名前 パス 説明
propertyName
propertyName string

プロパティの名前が変更されました。

oldValue
oldValue CaseValueProperty

型指定されたプロパティ値ラッパー。 具体的な値型は、'@odata.type' 識別子 (stringValueProperty または booleanValueProperty) で示されます。

newValue
newValue CaseValueProperty

型指定されたプロパティ値ラッパー。 具体的な値型は、'@odata.type' 識別子 (stringValueProperty または booleanValueProperty) で示されます。

CaseValueProperty

型指定されたプロパティ値ラッパー。 具体的な値型は、'@odata.type' 識別子 (stringValueProperty または booleanValueProperty) で示されます。

名前 パス 説明
@odata.type
@odata.type string

具象値型識別子。

価値
value string

ラップされた値。テキストとしてシリアル化されます。

CaseRelation

ケースから外部リソースへのリンク。 具体的な関係の種類は、"@odata.type" 識別子 (incidentRelation、recommendationRelation、または workspaceIndicatorRelation) で示されます。

名前 パス 説明
@odata.type
@odata.type string

具体的な関係の種類の識別子。

識別子
id string

リレーションシップの一意識別子。

作成日時
createdDateTime date-time

リレーションシップが作成された時刻。

createdBy
createdBy string

リレーションシップを作成した ID。

relatedResourceId
relatedResourceId string

外部リソース識別子。

recommendationType
recommendationType string

推奨事項の種類 (recommendationRelation のみ)。

subscriptionId
subscriptionId string

サブスクリプション識別子 (recommendationRelation と workspaceIndicatorRelation)。

resourceGroupName
resourceGroupName string

リソース グループ名 (recommendationRelation と workspaceIndicatorRelation)。

workspaceName
workspaceName string

ワークスペース名 (workspaceIndicatorRelation のみ)。

CaseTask

ケース内の実行可能な作業単位。

名前 パス 説明
識別子
id string

タスクの一意識別子。

作成日時
createdDateTime date-time

タスクが作成された時刻。

createdBy
createdBy string

タスクを作成した ID。

lastModifiedDateTime
lastModifiedDateTime date-time

タスクが最後に変更された時刻。

最終更新者
lastModifiedBy string

タスクを最後に変更した ID。

displayName
displayName string

タスク タイトル。

状態
status string

現在のタスクの状態。

description
description string

タスクの説明。

assignedTo
assignedTo string

タスクの所有者。

閉じる注記
closingNotes string

完了時に記録されたメモ。

dueDateTime
dueDateTime date-time

目標完了日。

priority
priority string

タスクの優先順位の分類。

カテゴリ
category string

タスク機能カテゴリ。

CaseAttachment

ケースの下に格納されているバイナリ証拠項目のメタデータ。 バイナリ コンテンツは、添付ファイル コンテンツ ストリームを介して個別に取得されます。

名前 パス 説明
識別子
id string

添付ファイルの一意識別子。

作成日時
createdDateTime date-time

添付ファイルが作成された時刻。

createdBy
createdBy string

添付ファイルを作成した ID。

displayName
displayName string

添付ファイルのタイトル。

description
description string

添付ファイルの説明。

ファイルサイズ
fileSize integer

サイズ (バイト単位)。

FileExtension
fileExtension string

ファイル拡張子。

scanResult
scanResult string

マルウェア スキャンの結果。

origin
origin CaseAttachmentOrigin

添付ファイルの配信元参照。

CaseAttachmentOrigin

添付ファイルの配信元参照。

名前 パス 説明
resourceId
resourceId string

配信元リソースの識別子。

resourceType
resourceType string

配信元リソースの種類。

CaseAlertCounts

インシデント ケースの集計アラート数。

名前 パス 説明
total
total integer

アラートの合計数。

active
active integer

アクティブなアラートの数。

bySeverity
bySeverity CaseIncidentSeverityCounts

アラート数は、インシデントの重大度別にグループ化されます。

byStatus
byStatus CaseAlertStatusCounts

アラートの数は、状態別にグループ化されます。

CaseIncidentSeverityCounts

アラート数は、インシデントの重大度別にグループ化されます。

名前 パス 説明
不明
unknown integer

重大度が不明なアラート。

情報提供用
informational integer

情報の重大度を持つアラート。

low integer

重大度が低いアラート。

中間
medium integer

重大度が中程度のアラート。

high integer

重大度が高いアラート。

CaseAlertStatusCounts

アラートの数は、状態別にグループ化されます。

名前 パス 説明
新規
new integer

新しい状態のアラート。

inProgress
inProgress integer

進行中のアラート。

解決済み
resolved integer

解決済みの状態のアラート。

CaseImpactedAssetsCounts

インシデント ケースの影響を受ける資産の集計数。

名前 パス 説明
machines
machines integer

マシンの数。

users
users integer

ユーザー数。

メールボックス
mailboxes integer

メールボックスの数。

apps
apps integer

アプリの数。

cloudResources
cloudResources integer

クラウド リソースの数。

aiAgents
aiAgents integer

AI エージェントの数。

ips
ips integer

IP アドレスの数。

urls
urls integer

URL の数。

files
files integer

ファイル数。

processes
processes integer

プロセス数。

registryKeys
registryKeys integer

レジストリ キーの数。

securityGroups
securityGroups integer

セキュリティ グループの数。

oauthApps
oauthApps integer

OAuth アプリの数。

total
total integer

影響を受けた資産の合計数。

CaseInvestigation

インシデント ケースの調査の概要。

名前 パス 説明
ids
ids array of string

調査識別子。

count
count integer

調査の数。

状態
state string

調査の状態。