云客户?
免费开始>
在MyJFrog中升级>
云的新功能>







概述

JFrog Xray的操作风险功能为您提供了有关OSS组件的额外数据,这些数据将帮助您深入了解正在使用的组件的风险级别。

什么是组件操作风险?

组件操作风险是指在项目中使用过时或不活跃的开源软件组件的风险。

这个特性如何帮助识别风险?

此功能可以帮助您识别由于使用过时的开源软件组件而导致的项目操作风险。它还可以作为开放源码项目活动的任何缓慢或可能没有积极维护的项目的早期指示器。

它是如何工作的?

JFrog Xray跟踪以下操作风险数据对于给定的开源组件:

  • 临终(EOL):确定正在使用的OSS组件是否过时或作者已声明其生命周期已结束。
  • 版本年龄:使用OSS组件的时间(以月为单位)。
  • 新版本数量:当前版本之后发布的新版本数。例如,如果您正在使用2.3.4版本,并且已经发布了三个新版本2.3.5、2.4.1和2.4.2,则该值将为3。
  • 开放源码软件项目的运行状况:一个布尔值,显示OSS项目是否运行正常。这是使用以下参数计算的:
    • 每年的发布节奏:GA发布的数量,包括补丁、点发布等。
    • 每年的提交数:过去12个月的总提交数。
    • 每年提交者的数量:过去12个月提交者的总数。


关于操作风险的重要说明

  • 此功能需要Artifactory版本7.37。X及以上。
  • 此功能需要JFrog CLI版本2.15。X及以上。
  • 该特性仅支持npm和Maven包。
页面内容

x射线如何判断操作风险的严重程度?

Xray使用以下标准将操作风险分为高、中、低和无(无已知风险):

风险 类型 严重程度 笔记

临终

布尔

High = True

None = False


版本的年龄

数量

发布后的月数/ 10

高>= 4

中等> 2和< 4

Low > 1和<= 2

无(无风险)<=1


新版本数量

数量

自/ 2以来的版本数

高>= 6

中>= 4和< 6

Low >= 2和< 4

无(无风险)< 2


开源项目的运行状况





每年发布的节奏

运行正常>= 2个版本

不健康<= 1

这包括所有版本。包括任何点版本和补丁版本,如果它们是GA版本。

当没有数据时,假定它是健康的


每年提交的数量

运行正常>= 100个提交

不健康< 100提交



每年提交者的数量

健康> = 5个提交者

不健康的< 5 c提交者



计算操作风险有效严重性

#

终点

健康

新版本的数量

版本的年龄

结合程度

风险的原因

1

任何

任何

任何

终点

2

没有一个

高的风险

任何

任何

健康

3.

没有一个

没有风险

无,低,中,高

新版本的数量和版本年龄(仅当高时)

4

没有一个

没有风险

媒介

无,低,中

媒介

新版本的数量和版本年龄(仅当为Medium时)

5

没有一个

没有风险

没有,低

新版本的数量和版本年龄(仅当Low时)

6

没有一个

没有风险

没有一个

没有一个

没有一个

没有给出原因

7

没有一个

没有风险

无,低,中,高

版本年龄和新版本数量(仅当高时)

8

没有一个

没有风险

无,低,中

媒介

媒介

版本年龄和新版本数量(仅当为Medium时)

9

没有一个

没有风险

没有,低

版本年龄和新版本数量(仅当Low时)


工作流

步骤1创建操作风险策略

添加了一个额外的Policy类型来支持操作风险规则。这些规则是基于x射线确定的风险类型。违例是根据您选择的规则标准生成的。有关x射线策略的更多信息,请参见创建x射线策略和规则

步骤2将Policy绑定到Watch

将操作风险政策附加到一个或多个手表上,以将其应用于您的资源。2022世界杯阿根廷预选赛赛程有关x射线手表的更多信息,请参阅配置x射线手表

步骤3查看操作风险数据

在Artifactory的x射线数据选项卡中查看组件的操作风险数据。

步骤4查看违规行为

查看基于您设置的策略规则生成的操作风险违规。

请注意,Xray不执行操作风险更新的影响分析。的操作风险选项卡将始终更新。违规数据被更新到最新的扫描(或最新的包下载)。



创建操作风险策略

操作风险策略类型包括基于Xray确定的风险标准的规则。要创建策略,请执行以下操作:

  1. 政府模块,选择手表与政策政策选项卡单击新政策
  2. 选择策略类型为操作风险,并按新规则
  3. 选择规则标准。你可以做以下其中一件事:
    1. 根据最低风险水平;低、中、高。
    2. 具体数值按子标准下的自定义条件。自定义条件基于可用的x射线操作风险数据。条件之间的关系是Or/And。



有关创建策略的详细信息,请参见创建x射线策略和规则。创建策略后,可以继续将其附加到Watch,如配置x射线手表


查看操作风险数据

Artifactory中的x射线数据选项卡现在包含一个额外的操作风险数据选项卡。列出了每个组件以及每个组件的操作风险信息。要访问这些数据,请参见资源扫描结果分析


操作风险违规

一种新的违规类型,操作风险,现在列在x射线数据下的违规选项卡下。违规是根据您在策略中设置的规则生成的。违规包括操作风险组件数据。

选择违规项后,显示“操作风险”数据。

忽略操作风险违规

通过创建“忽略规则”,可以忽略操作风险违规。要创建忽略规则,请单击忽略违规图标。有关忽略规则的详细信息,请参见无视规则


在离线模式下升级具有操作风险特性支持的x射线

如果您处于离线模式,则需要手动同步数据库以下载组件数据并启用操作风险检测。

做到以下几点:

  1. 政府模块,转到x射线安全与合规并选择数据库同步。
  2. 选择离线同步模式,点击生成下载命令。
  3. 生成的命令如下所示:

    jfrog xr offline-update——license-id=——version=
  4. 如果命令包含参数,删除它们,使命令看起来像上面的例子。
  5. 复制命令并在CLI中运行。
  6. CLI将下载两个文件:comp_0.zip和vuln_0.zip
  7. 解压缩组件文件,例如,comp_{号码}. zip。它包含额外的zip文件,如:
    1. 2022 - 03 - 22 - __onboardingf__comp2801_2803__.zip
  8. 将提取的组件zip文件放在Xray服务器的以下文件夹下。

    $ {XRAY_HOME} / var /工作/服务器/更新/ data_migration / public_comps_operational_risk_files /


  9. 触发组件操作风险持久性迁移:

    [post] /api/v1/migration/trigger/public_comps_operational_risk内容类型:application/json
  10. 使用迁移值REST API来监视操作风险迁移过程。要了解有关运行Xray命令的更多信息,请参见x射线REST API
    一旦迁移完成,迁移状态将被设置为完成了。如果其他状态包含失败信息,请检查日志或联系JFrog的客户支持。

    [有]< XRAY_URL > / api / v1 /迁移/数据/价值?关键= public_comps_operational_risk

    样品反应:

    {"key": "public_comps_operational_risk", "value": "finished"}

REST API支持

以下REST api已更新以支持操作风险特性:

  • 没有标签
版权所有©2023 JFrog Ltd.