• Spring Boot 安装
    • 半自动安装
      • 1. 安装软件
      • 2. 配置启动参数
      • 4. 检查安装是否成功
  • 手动安装
    • 1. 安装软件
    • 2. 开启远程管理
    • 3. 配置启动参数
    • 4. 检查安装是否成功

    Spring Boot 安装

    我们支持 war 包、jar 包两种部署模式。如果是 war 包的形式,直接参考相应服务器文档即可;如果是内嵌服务器的 jar 包形式,请参考本文档安装。

    半自动安装

    1. 安装软件

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

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

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

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

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

    这里的 <spring_boot_folder> 通常是 springboot jar 包所在的目录。

    2. 配置启动参数

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

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

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

    1. java -javaagent:"/opt/spring-boot/rasp/rasp.jar" -jar springboot.jar

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

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

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

    手动安装

    1. 安装软件

    进入到 Spring Boot 安装目录,e.g /opt/spring-boot

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

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

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

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

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

    3. 配置启动参数

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

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

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

    1. java -javaagent:"/opt/spring-boot/rasp/rasp.jar" -jar springboot.jar

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

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

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