用户事件 API 概览

您可以通过用户事件 API 导入用户的安全相关事件或来自外部源的培训活动，并将这些内容推送至您的 KSAT 控制台。一经导入，您的任何自定义事件都会显示在受影响用户的用户时间线上，并且可能影响用户的个人风险得分。

有关用户事件 API 以及示例请求的完整详情，请访问用户事件 API 开发者文档用户事件 API 开发者文档（链接在新窗口中打开）。若决定使用 KnowBe4 用户事件 API，请参阅下文，了解如何管理 API 使用量及自定义事件如何强化安全意识培训效果。

注意：必须拥有铂金级、钻石级或 SAT Advanced 订阅等级，才能访问用户事件 API 管理控制台。

用户事件 API 管理控制台

用户事件 API 管理控制台是您用于监控、创建和追踪任何用户事件 API 密钥使用情况的中心平台。前往 KSAT 帐户设置页面的帐户集成部分，即可访问管理控制台。管理控制台分为三个主要选项卡：通话历史记录、状态和 API 密钥。有关每个选项卡的更多信息，请参阅下表。

通话历史记录选项卡将显示相应的表格，列明经过 KSAT 控制台处理的所有 API 通话。

状态 ID	API 密钥	已创建事件	错误	已处理日期
针对每个 API 通话生成的唯一标识符。	用于进行 API 通话的 API 密钥名称。	因 API 通话而创建的用户事件数量。	API 通话期间收到的所有错误。	处理 API 请求的日期和时间。格式：mm/dd/yyyy, h:mm a

访问状态选项卡，可监视每月和每年的 API 使用情况。

每月配额：这个进度圆形图显示了您每月的 API 使用情况。该图表显示了已允许 API 通话次数与已进行 API 通话次数之间的百分比。每月每天每个名额允许拨打 10 个电话。
年度配额：这个柱状图显示了您每年的 API 使用情况。图表根据您在 12 个月内每个月的每月配额详细列明这些数据。

使用 API 密钥选项卡创建一个或多个 API 密钥。进行 API 通话或请求时，您的 API 密钥将用于您的 KSAT 控制台身份验证。要创建 API 密钥，请按照以下步骤操作：

重要提示：建议仅创建所需的 API 令牌。未使用且无人监管的令牌若被未授权方获取，将带来安全风险。

重复上述步骤，创建任意数量的 API 密钥。创建完毕后，任何 API 密钥都会列在 API 密钥选项卡下的表格中。

密钥	名称	操作
唯一标识符用于对与 KSAT 控制台关联的 API 请求进行身份验证。	您在创建 API 密钥时所指定的自定义名称。	您可以选择永久删除 API 密钥。要删除密钥，请单击垃圾桶图标。注意：如果您删除 API 密钥，通话历史记录选项卡下仍然会出现该密钥的使用情况记录。

注意：报告 API 和用户事件 API 不会共用一个 API 密钥。报告 API 密钥可在 API 部分下的 KSAT 帐户设置中生成。

下列示例将说明如何使用自定义事件来强化安全意识培训。要创建含自定义事件的智能组，请参阅智能组概述中的“自定义事件条件”部分。

事件类型	示例事件	用例
物理安全	尾随解锁计算机遗失/被盗设备	为用户注册参加特定事件的培训活动。例如，您可以将 ModStore 中的物理安全培训模块分配给参与物理安全事件的所有用户。
社会工程	生日不在办公室	根据员工信息，为用户注册参加自定义网络钓鱼活动。例如，您可以向当月生日的所有用户发送含当地餐馆优惠券的电子邮件模板。
第三方安全	非模拟网络钓鱼事件试图访问已拦截网站的行为密码锁定	追踪用户在第三方安全事件中的表现情况。通过这些信息，您可从 ModStore 中选择特定事件的培训内容，为用户进行注册。
职业发展	其他 LMS 的认证和培训	追踪用户的外部培训和成就，这些培训和成就有助于提高用户的安全意识。