模拟资源类型

  • 项目

命名空间：microsoft.graph

重要

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

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

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

利用攻击模拟和培训 API，租户管理员能够列出启动的 模拟 练习和培训，并获取有关网络钓鱼模拟中用户在线行为的派生见解 的报告 。

继承自 entity。

Methods

方法 返回类型 说明
列出模拟 模拟 集合 获取租户的攻击模拟活动列表。
创建模拟 仿真 创建新的 模拟 对象。
获取模拟 仿真 获取租户的攻击模拟活动。
更新模拟 仿真 更新 模拟 对象的属性。
删除模拟 无 删除 模拟 对象。
获取有效负载 无 获取 有效负载 对象。
获取 loginPage 无 获取 loginPage 对象。
获取 landingPage 无 获取 landingPage 对象。

属性

属性 类型 说明
attackTechnique simulationAttackTechnique 用于攻击模拟和训练运动的社会工程技术。 支持 $filter 和 $orderby。 可取值为：unknown、credentialHarvesting、attachmentMalware、driveByUrl、linkInAttachment、linkToMalwareFile、unknownFutureValue、oAuthConsentGrant。 请注意，必须使用 Prefer: include-unknown-enum-members 请求标头从此 可演变枚举中获取以下值： oAuthConsentGrant。 有关社会工程攻击技术类型的详细信息，请参阅 模拟。
attackType simulationAttackType 攻击模拟和训练活动的攻击类型。 支持 $filter 和 $orderby。 可取值为：unknown、social、cloud、endpoint、unknownFutureValue。
automationId String 攻击模拟自动化的唯一标识符。
completionDateTime DateTimeOffset 完成攻击模拟和训练活动的日期和时间。 支持 $filter 和 $orderby。
createdBy emailIdentity 创建攻击模拟和培训活动的用户的标识。
createdDateTime DateTimeOffset 创建攻击模拟和训练活动的日期和时间。
说明 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。
报告 simulationReport 攻击模拟和训练活动的报告。
status simulationStatus 攻击模拟和训练活动的状态。 支持 $filter 和 $orderby。 可取值为：unknown、draft、running、scheduled、succeeded、failed、cancelled、excluded、unknownFutureValue。
trainingSetting trainingSetting 有关模拟的训练设置的详细信息。

simulationStatus 值

成员 说明
unknown 未定义模拟状态。
草案 模拟处于草稿模式。
运行 模拟正在运行。
scheduled 已安排模拟。
成功 模拟已完成并处于成功状态。
失败 模拟已完成，状态为失败。
取消 模拟已取消。
排除 排除模拟。
unknownFutureValue 可演变枚举 sentinel 值。 请勿使用。

simulationAttackTechnique 值

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

simulationAttackType 值

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

simulationContentStatus 值

成员 说明
unknown 未定义模拟内容状态。
草案 模拟内容状态为草稿状态。
准备 模拟内容状态为就绪状态。
archive 模拟内容状态为存档状态。
delete 模拟内容状态处于删除状态。
unknownFutureValue 可演变枚举 sentinel 值。 请勿使用。

simulationContentSource 值

成员 说明
unknown 未定义模拟内容源。
全球 模拟内容源是全局性的。
租户 模拟内容源是租户。
unknownFutureValue 可演变枚举 sentinel 值。 请勿使用。

关系

关系 类型 说明
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"}
}

相关内容