模拟资源类型

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

表示租户中的攻击模拟训练活动。

攻击模拟和训练是作为 Office 365 的 Microsoft Defender 的一部分提供的服务。 此服务允许租户用户体验真实的良性网络钓鱼攻击并从中吸取教训。 该服务使租户管理员能够模拟、分配培训和读取有关网络钓鱼模拟中用户在线行为的派生见解。 该服务提供攻击模拟报告,帮助租户识别安全知识差距,以便他们可以进一步培训用户以降低对攻击的敏感性。

利用攻击模拟和训练 API,租户管理员可以列出已启动的 模拟 练习和培训,并获取有关网络钓鱼模拟中用户联机行为的见解 的报告 。

继承自 entity。

Methods

方法 返回类型 说明
列出模拟 模拟集合 获取租户的攻击模拟市场活动列表。
列出模拟用户 userSimulationDetails 集合 获取租户用户的列表及其在攻击模拟活动中的联机操作。
创建模拟 simulation 创建新的 模拟 对象。
获取模拟 simulation 获取租户的攻击模拟市场活动。
更新模拟 simulation 更新 模拟 对象的属性。
删除模拟 无 删除 模拟 对象。
获取有效负载 无 获取 有效负载 对象。
获取登录页 无 获取 loginPage 对象。
获取 landingPage 无 获取 landingPage 对象。

属性

属性 类型 说明
attackTechnique simulationAttackTechnique 攻击模拟和训练活动中使用的社会工程技术。 支持 $filter 和 $orderby。 可能的值为:unknown、、credentialHarvesting、。 driveByUrlphishTrainingattachmentMalwarelinkInAttachmentlinkToMalwareFileunknownFutureValueoAuthConsentGrant 使用 Prefer: include-unknown-enum-members 请求标头从这个 可进化的枚举中获取以下值: oAuthConsentGrant, phishTraining. 有关社交工程攻击技术类型的详细信息,请参阅 模拟。
attackType simulationAttackType 攻击模拟和训练活动的攻击类型。 支持 $filter 和 $orderby。 可能的值包括 unknown、social、cloud、endpoint、unknownFutureValue。
automationId String 攻击模拟自动化的唯一标识符。
completionDateTime DateTimeOffset 攻击模拟和训练活动完成的日期和时间。 支持 $filter 和 $orderby。
createdBy emailIdentity 创建攻击模拟和训练市场活动的用户的标识。
createdDateTime DateTimeOffset 创建攻击模拟和训练活动的日期和时间。
description String 攻击模拟和训练活动的说明。
displayName String 显示攻击模拟和训练市场活动的名称。 支持 $filter 和 $orderby。
durationInDays Int32 模拟持续时间(以天为单位)。
endUserNotificationSetting endUserNotificationSetting 有关最终用户通知设置的详细信息。
excludedAccountTarget accountTargetContent 模拟中排除的用户。
id String 攻击模拟和训练活动的唯一标识符。 继承自 entity。
includedAccountTarget accountTargetContent 模拟中的目标用户。
isAutomated 布尔值 表示攻击模拟和训练市场活动是否是从模拟自动化流创建的标志。 支持 $filter 和 $orderby。
lastModifiedBy emailIdentity 最近修改攻击模拟和训练市场活动的用户的标识。
lastModifiedDateTime DateTimeOffset 攻击模拟和训练活动最近修改的日期和时间。
launchDateTime DateTimeOffset 攻击模拟和训练活动的启动/开始的日期和时间。 支持 $filter 和 $orderby。
oAuthConsentAppDetail oAuthConsentAppDetail OAuth 技术的 OAuth 应用详细信息。
payloadDeliveryPlatform payloadDeliveryPlatform 攻击模拟和训练活动中使用的网络钓鱼有效负载的交付方法。 可能的值包括 unknown、sms、email、teams、unknownFutureValue。
report simulationReport 攻击模拟和训练活动报告。
status simulationStatus 攻击模拟和训练活动的状态。 支持 $filter 和 $orderby。 可能的值为:unknown、、draft、。 scheduledunknownFutureValuerunningsucceededfailedcancelledexcluded
trainingSetting trainingSetting 有关模拟的训练设置的详细信息。

simulationStatus 值

成员 说明
unknown 模拟状态未定义。
草稿 模拟处于草稿模式。
running 模拟正在运行。
scheduled 已计划模拟。
成功 模拟完成并具有成功状态。
失败 模拟完成但状态为失败。
已取消 模拟已取消。
排除 模拟被排除。
unknownFutureValue 可进化枚举哨兵值。 请勿使用。

simulationAttackTechnique 值

成员 说明
unknown 未定义攻击技术。
credentialHarvesting 涉及最终用户提供凭据的攻击技术。
attachmentMalware 涉及最终用户单击附件的攻击技术。
driveByUrl 涉及最终用户单击网络钓鱼有效负载中的 URL 链接的攻击技术。
linkInAttachment 涉及最终用户单击附件中的 URL 链接的攻击技术。
linkToMalwareFile 涉及最终用户单击指向恶意软件文件的 URL 链接的攻击技术。
unknownFutureValue 可进化枚举哨兵值。 请勿使用。
oAuthConsentGrant 一种攻击技术,涉及向应用授予访问许可的最终用户。
phishTraining 一种攻击技术,涉及培训最终用户以对网络钓鱼邮件执行的操作。

simulationAttackType 值

成员 说明
unknown 未识别攻击类型。
社交 利用社交技能在心理上操纵受害者,制造虚假的好奇心、紧迫感或恐惧感的攻击。
云 在云环境中对主机或用户进行攻击,例如,拒绝服务攻击。
终结点 对企业网络终结点(如台式机、笔记本电脑、手机和物联网 (IoT) 设备)的攻击。
unknownFutureValue 可进化枚举哨兵值。 请勿使用。

simulationContentStatus 值

成员 说明
unknown 模拟内容状态未定义。
草稿 模拟内容状态为草稿状态。
就绪 模拟内容状态为就绪状态。
archive 模拟内容的状态为存档状态。
delete 模拟内容状态处于删除状态。
unknownFutureValue 可进化枚举哨兵值。 请勿使用。

simulationContentSource 值

成员 说明
unknown 未定义模拟内容源。
全局 模拟内容源是全局的。
租户 模拟内容源是租户。
unknownFutureValue 可进化枚举哨兵值。 请勿使用。

关系

关系 类型 说明
landingPage landingPage 在创建模拟期间与模拟关联的登陆页面。
loginPage loginPage 在创建模拟期间与模拟关联的登录页。
payload 有效负载 在创建模拟期间与模拟关联的有效负载。

JSON 表示形式

以下 JSON 表示形式显示资源类型。

{
  "@odata.type": "#microsoft.graph.simulation",
  "attackTechnique": "String",
  "attackType": "String",
  "automationId": "String",
  "completionDateTime": "String (timestamp)",
  "createdBy": {"@odata.type": "microsoft.graph.emailIdentity"},
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "displayName": "String",
  "durationInDays": "Int32",
  "endUserNotificationSetting": {"@odata.type": "microsoft.graph.endUserNotificationSetting"},
  "excludedAccountTarget": {"@odata.type": "microsoft.graph.accountTargetContent"},
  "id": "String (identifier)",
  "includedAccountTarget": {"@odata.type": "microsoft.graph.accountTargetContent"},
  "isAutomated": "Boolean",
  "lastModifiedBy": {"@odata.type": "microsoft.graph.emailIdentity"},
  "lastModifiedDateTime": "String (timestamp)",
  "launchDateTime": "String (timestamp)",
  "oAuthConsentAppDetail": {"@odata.type": "microsoft.graph.oAuthConsentAppDetail"},
  "payloadDeliveryPlatform": "String",
  "report": {"@odata.type": "microsoft.graph.simulationReport"},
  "status": "String",
  "trainingSetting": {"@odata.type": "microsoft.graph.trainingSetting"}
}