配置x光

屏幕会显示你添加到x射线显示的人工实例列表:

添加新实例

要添加新实例，请单击新实例链接并填写显示的表单。

指定用于分析的存储库

为了避免冗长而密集的分析过程，Xray不会分析连接的Artifactory实例中的所有存储库。相反，在您创建一个新的Artifactory实例之后，Xray将显示该实例中的存储库，这样您就可以选择哪些存储库应该被索引以供分析。

一旦您在Artifactory中指定了用于分析的存储库，它们将出现在存储库选项卡下索引资源2022世界杯阿根廷预选赛赛程在Artifactory实例页面中(在管理模块下Artifactory）.

您现在可以对所选存储库中的构件进行索引，以便进行分析索引的工件。

为分析指定构建

为了避免冗长而密集的分析过程，Xray不会分析连接的Artifactory实例中的所有构建。相反，在创建新的Artifactory实例之后，在构建标签索引资源2022世界杯阿根廷预选赛赛程面板中，您可以选择应该索引哪些构建以供分析。

管理用户

Xray支持两种方式来管理用户:

1. 通过身份验证提供程序
2. 内部定义用户

通过身份验证提供程序管理用户

从1.9版本开始，您可以将其中一个连接的Artifactory实例设置为身份验证提供者。在这种情况下，Artifactory将首先尝试通过为该实例设置的方法(无论是LDAP/Crowd还是SAML)对用户进行身份验证。

详情请参阅身份验证。

内部管理用户

使用身份验证提供者不是强制性的，您总是可以在Xray内部定义用户。

您可以查看在Xray下注册的用户列表管理模块下用户。

创建和编辑用户

如需添加新用户，请单击新用户,或者单击所显示的表中的现有用户以编辑其详细信息。

配置邮件服务器

对于发生的不同事件，Xray会向用户发送电子邮件通知。

一些例子是:

• 观察者可以发送警报电子邮件。
• 用户可能会收到有关其帐户信息更改的通知

要启用邮件通知，您需要使用下面的邮件服务器详细信息配置Xray管理员|邮件如下所述。

配置人

配置watch时的一个选项是让它们调用webhook, webhook是你可以定义的专有url，可以在违规发布时执行自定义操作。

webhook显示在管理模块下人则。

点击一个网络钩子来编辑它的详细信息，或者点击新Webhook去定义一个新的。

索引的工件

JFrog Xray提供了关于它所索引的组件中的问题和漏洞的信息。在正常操作期间，当对标记为分析的存储库中的组件进行更改时，组件数据库会不断更新和重新索引，但是，要设置初始数据库，您需要手动调用标记为分析的存储库的索引。

在管理模块,在Artifactory，可以查看已连接的Artifactory实例列表。单击要索引其存储库的实例。该实例的详细信息页面显示了标记为索引的存储库列表。

这指数状态列将指示哪些存储库索引是最新的，哪些需要索引。你可以点击计算启动单个存储库的索引，或选中多个存储库并单击现在指数一次为多个存储库启动索引。

同步数据库

https://jxray.jfrog.io/api/v1/system/ping

对于x射线扫描您的索引工件，它必须从连接到的各种提要中摄取有关问题和漏洞的数据。主提要来自全局数据库服务器由JFrog维护(其他源包括您可能通过x射线的直接连接)集成与外部提供者)。有两种方法可以同步x射线与全局数据库服务器:

• 在线:在联机模式下，Xray每天通过互联网连接自动与全球数据库服务器同步
• 离线:在离线模式下，您手动从全局数据库服务器下载文件，然后将它们上传到Xray

要配置与全局数据库服务器的同步，请在管理模块,选择数据库同步。

网络同步

要立即开始，以便Xray可以扫描您的工件，您可以通过选择手动调用初始同步开始同步在状态面板。从那时起，Xray将定期自动同步问题和漏洞，每天一次。

离线同步

如果出于某种原因不希望维护到全局数据库服务器的实时internet连接，请选择离线在同步模式小组，以获得有关如何获得最新可用数据的详细说明。

暂停和恢复同步

使用来自全局数据库服务器的最新数据更新Xray可能是一项资源密集型操作。在更新过程中，您可以单击文件中的相应链接状态面板，以便随时暂停操作以释放资源，然后稍后恢复操作。2022世界杯阿根廷预选赛赛程

使用自签名证书使用SSL

当连接到其他应用程序和服务时，Xray能够通过安全连接工作。例如，它通过HTTPS连接到Artifactory。作为HTTPS协议的一部分，Xray能够通过验证其SSL证书来验证站点的身份，然而，在可信连接的情况下，站点可能使用无法验证的自签名证书(这可能是Artifactory/Xray连接中的情况)。

配置HTTPS设置

您可以通过HTTP、HTTPS或两者(至少需要一种)配置对Xray的访问。

要配置使用HTTPS访问Xray，请粘贴您的SSL密钥和SSL认证以下目录下的文件:XRAY_HOME /数据/ ssl / serverCerts美元

然后去管理模块>HTTP的设置,点击刷新查看添加的SSL文件，并单击保存。

对于基于docker的安装，将证书复制到xray-server容器使用以下命令:

docker cp  :/var/opt/jfrog/xray/data/ssl/serverCerts . docker cp  
             

在使用自签名证书的情况下，启用“SSL不安全”管理模块,在一般设置。然后,将证书导入到Artifactory。

设置证书后，更新“x射线基础URL”切换到HTTPS并重新启动Xray。

Setcap cap_net_bind_service=ep /opt/jfrog/xray/bin/server

Setcap cap_net_bind_service=ep /opt/jfrog/xray-server/server

配置代理

根据组织的策略，您可能需要配置Xray以通过代理访问外部资源，代理可以在2022世界杯阿根廷预选赛赛程管理模块下代理。

一般设置

Xray建立在一组微服务之上，这些微服务在索引工件、与Artifactory通信、管理事件和通知等领域执行其操作。

基本配置

队列的工人

队列的工人提供了几个参数，您可以配置来调整x射线的性能，通过改变工作人员的数量执行不同的任务。

系统参数

有关调整这些参数可能如何影响系统性能的更多详细信息，请联系JFrog支持。

更改第三方服务凭据

Xray与许多第三方服务一起工作，例如各种数据库，这些服务预先配置了Xray访问的默认凭据。以下部分将展示如何更改这些默认凭据。

MongoDB

要更改Xray访问其内部MongoDB数据库时使用的默认凭据，您需要以“Xray”用户身份登录数据库，并使用安装Xray时建立的密码。

如果最初安装的Xray版本是2.8.8或更早版本，默认密码是“password”。

如果最初安装的Xray版本是释放2.8.9默认密码是由安装过程生成的随机字符串，然后由Xray master.key加密。生成的密码存储在/根文件夹作为文本文件，称为MongoDB_Admin_pass.txt。根据x射线的安装方式，它可能在本地用户的主目录中:~ / MongoDB_Admin_pass.txt

登录MongoDB数据库修改密码的方法如下:

$ mongo——port 27017 -u " Xray " -p ""——authenticationDatabase " Xray " #切换到x射线数据库$ use Xray #更新凭据$ db。updateUser("xray"，{pwd: ""}) #使用新凭据登录验证更新是否成功$ mongo——port 27017 -u "xray" -p ""——authenticationDatabase "xray"

PostgreSQL

要修改Xray访问PostgreSQL内部数据库的默认凭证，需要以“Xray”用户登录数据库，并修改密码，如下所示:

$ psql -d xraydb -U Xray -W #安全修改用户“Xray”的密码在提示符下输入并重新键入密码。使用新凭据登录验证更新是否成功$ psql -d xraydb -U xray -W

RabbitMQ

Xray是预先安装在RabbitMQ中的，使用默认凭证:用户:客人,密码:客人

要更改默认凭据，请按照以下步骤操作:

$ rabbitmqctl change_password guest  #验证更新是否成功$ rabbitmqctl authenticate_user guest 

加强机密安全

Xray使用一组加密参数(秘密)来连接外部资源，例如它使用的不同数据库。2022世界杯阿根廷预选赛赛程虽然这些秘密可能存储在Xray配置文件中，但这会带来暴露的风险。

为了保护秘密不被曝光，从2.5版开始在运行中的x射线安装上Kubernetes，您可以在第一次启动Xray时从临时文件中预加载秘密。一旦Xray读取并成功使用了秘密，文件就会被删除。

下面的代码片段显示了可以包含在这个临时文件中的参数示例。这些是Xray连接到它使用的不同数据库的连接字符串。

mqBaseUrl: amqp://:@rabbitmq:5672/ mongoUrl: mongodb://:@mongodb:27017/?authSource=xray&authMechanism= sram - sha -1 postgresqlUrl: postgres://:@postgres:5432/xraydb?sslmode =禁用

虽然我们建议只包含敏感信息，如加密的连接字符串，但该文件可能包含任何x射线配置参数，并且指定的任何参数(包括环境变量和系统属性)将覆盖x射线配置文件中的相应参数。

1. 一旦文件准备好，从它创建一个Kubernetes密钥。例如:

   kubectl create secret generic ——from-file=/ TEMP .xray_config.yml

2. 使用init容器，将秘密作为卷预加载到每个x射线服务的临时路径。
   您还需要挂载x光数据量来/var/opt/jfrog/xray/data


3. 在init容器中，将临时文件复制到/var/opt/jfrog/xray/data/.secrets/.temp.xray_config.yml


4. 开始x光。在启动过程中，如果临时配置文件存在，Xray将从中读取所有参数，然后删除该文件。如果Xray删除文件失败，则Xray将不会启动并发出错误。

观看视频

观看此屏幕视频，了解如何排除与以下问题相关的x射线安装故障代理连接、数据库、网络和计算资源。2022世界杯阿根廷预选赛赛程

配置PostgreSQL连接池

可以在文件中配置以下PostgreSQL参数xray_config.yml提高系统性能的文件。

maxOpenConnServer: 30
maxIdleConnServer: 15
maxOpenConnPersist: 30
maxIdleConnPersist: 15
maxOpenConnAnalysis: 30
maxIdleConnAnalysis: 15
maxOpenConnIndexer: 30
maxIdleConnIndexer: 15