Wildfly 服务器安装

自动化安装

解压缩后,首先进入到解压后的目录中,e.g rasp-20181221

如果你要开启远程管理,请先参考 管理后台 - 添加主机 文档,找到 app_id/app_secret/backend_url 三个关键参数,然后执行如下命令,

java -jar RaspInstall.jar -install <wildfly_root> -backendurl http://XXX -appsecret XXX -appid XXX

如果你只是运行单机版,只需要指定 -install 参数,

java -jar RaspInstall.jar -install <wildfly_root>

这里的 <wildfly_root> 是 tomcat 的根目录。没有错误表示安装成功,其他配置请参考 其他配置 文档。安装后,需要重启 Wildfly 服务器生效。

由于无法在运行时增加 Wildfly 对 OpenRASP 的运行时依赖,所以无法支持 Wildfly 的不重启安装

手动安装 - Linux

1. 安装软件

进入到 wildfly 安装目录(绝对路径包含空格将导致启动失败),e.g /opt/wildfly-9.0.1.Final,将 rasp 目录复制过来

cp -R ~/Downloads/rasp-20170721/rasp .

OpenRASP 需要在 rasp 目录下释放一些动态链接库,所以还需要修改 rasp 目录的权限,e.g

chmod 777 -R rasp
2. 修改 Wildfly 启动脚本

如果是standalone模式

打开 bin/standalone.sh, 找到如下内容:

# Display our environment

在其下面增加如下内容:

JAVA_OPTS="$JAVA_OPTS -javaagent:$JBOSS_HOME/rasp/rasp.jar"

如果是domain模式

server-group

如果按照server-group配置rasp,那么此group下面所有的服务器都会安装rasp,打开domain/configuration/domain.xml文件,找到<server-groups>标签,在需要安装rasp的server-group中找到<jvm>标签添加如下配置:

<jvm-options>
   <option value="-javaagent:<wildfly_root>/rasp/rasp.jar"/>
</jvm-options>

server

如果只对某个server-group的特定的server安装rasp,打开domain/configuration/host.xml文件,找到<servers>标签,在需要安装rasp的server中添加如下配置:

<jvm name="default">
    <jvm-options>
        <option value="-javaagent:<wildfly_root>/rasp/rasp.jar"/>
    </jvm-options>
</jvm>
3. 开启远程管理

如果你不需要远程管理功能,请跳过这个步骤。

首先在管理后台找到 app_id、app_secret 两个关键参数,然后打开 <wildfly_home>/rasp/conf/openrasp.yml,添加或者修改如下内容:

# 云控配置
cloud.enable=true
cloud.backend_url=http://XXXX
cloud.app_id=XXXX
cloud.app_secret=XXXX
4. 验证安装是否成功

重启 wildfly 服务器,然后检查 rasp/logs/rasp/rasp.log 中是否出现 OpenRASP Engine Initialized 字样,e.g

%> grep OpenRASP -ir rasp/logs/
rasp/logs/rasp/rasp.log:2018-05-22 16:13:25,842 INFO  [main][com.baidu.openrasp.Agent] OpenRASP Engine Initialized [1.0-SNAPSHOT (build: GitCommit=3da661734e3ad7641cd98e83f32950deaefcacac date=2017-08-14T03:34:41Z)]

或者检查响应的 Header 是否包含 X-Protected-By 字样,e.g

%> curl -v 127.0.0.1:8080

...
X-Protected-By: OpenRASP
X-Request-ID: eb3b8e287de8406bb4bdb9d86bd31f99
...

出现则表示安装成功

安装中出现任何问题,请联系我们

手动安装 - Windows

1. 安装软件

进入到 wildfly 安装目录,e.g D:\wildfly-9.0.1.Final,将 rasp 目录复制过来

2. 修改 wildfly 配置

如果是standalone模式

打开 bin\standalone.bat, 找到 rem Setup JBoss specific properties 处:

在其下增加如下内容:

set JAVA_OPTS=%JAVA_OPTS% -javaagent:%JBOSS_HOME%/rasp/rasp.jar

如果是domain模式

方法同 Linux 版本

3. 开启远程管理

方法同 Linux 版本,在 openrasp.yml 里增加相关配置即可。

4. 验证安装是否成功

重启 wildfly 服务器,然后检查日志文件,一般是 rasp/logs/rasp/rasp.log,如果出现 OpenRASP Engine Initialized 字样,出现则说明安装成功;或者访问一下服务器,检查是否存在 X-Protected-By: OpenRASP 响应头,存在即表示安装成功。

安装中出现任何问题,请联系我们