Spring Boot 安装

我们支持 war 包、jar 包两种部署模式。如果是 war 包的形式,直接参考相应服务器文档即可;如果是内嵌服务器的 jar 包形式,请参考本文档安装。对于 WebGoat 项目,对应的 jar 包通常为 webgoat-XXX.jar

半自动安装

从 v1.2.0 版本开始,我们加入了 SpringBoot 半自动安装支持。之前的版本请参考手动安装章节。

1. 安装软件

SpringBoot 没有提供通用的启动脚本,所以我们的半自动安装程序只会释放文件。在解压缩后,首先进入到解压后的目录中,e.g rasp-20181221

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

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

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

java -jar RaspInstall.jar -nodetect -install <spring_boot_folder>

这里的 <spring_boot_folder> 通常是 XXX.jar 包所在的目录。具体 jar 的名字请咨询业务线。

2. 配置启动参数

假设 spring_boot_folder 目录为 /opt/spring-boot/

修改 SpringBoot 启动参数,增加 -javaagent 绝对路径参数(注意将 -jar 放到命令最末尾),e.g

如果JDK版本为6-8,那么启动参数如下配置

java -javaagent:/opt/spring-boot/rasp/rasp.jar -jar XXX.jar

如果JDK版本为11,那么启动参数如下配置

java --add-opens=java.base/jdk.internal.loader=ALL-UNNAMED --add-opens=java.base/java.net=ALL-UNNAMED -javaagent:/opt/spring-boot/rasp/rasp.jar -jar XXX.jar
3. 检查安装是否成功

访问服务器,检查是否存在 X-Protected-By: OpenRASP 响应头即可。

手动安装

1. 安装软件

进入到 Spring Boot 所在目录,通常是 jar 所在的目录,e.g /opt/spring-boot

复制安装包内的 rasp 目录到当前目录,

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

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

chmod 777 -R rasp
2. 开启远程管理

配置方法同 Tomcat 开启远程管理,不再赘述。

3. 配置启动参数

假设 rasp 目录释放到了 /opt/spring-boot/rasp/

修改 SpringBoot 启动参数,增加 -javaagent 绝对路径参数(注意将 -jar 放到命令最末尾),e.g

如果JDK版本为6-8,那么启动参数如下配置

java -javaagent:/opt/spring-boot/rasp/rasp.jar -jar XXX.jar

如果JDK版本为11,那么启动参数如下配置

java --add-opens java.base/jdk.internal.loader=ALL-UNNAMED -javaagent:/opt/spring-boot/rasp/rasp.jar -jar XXX.jar
4. 检查安装是否成功

访问服务器,检查是否存在 X-Protected-By: OpenRASP 响应头即可。