OpenRASP Documents (Old)
  • 简介
  • 安装部署
    • 兼容性说明
    • 安装管理后台
    • 快速接入
      • PHP 服务器
      • Tomcat 服务器
      • JBoss 服务器
      • Wildfly 服务器
      • Resin 服务器
      • Jetty 服务器
      • Spring Boot 框架
      • WebLogic 服务器
      • WebSphere 服务器
      • 宝兰德BES服务器
      • 东方通TongWeb服务器
      • 中创InforSuiteAS服务器
      • 普元PAS服务器
    • 安装测试用例
    • 安装灰盒扫描工具
      • IAST 高级配置选项
    • SIEM 系统集成
      • Splunk
      • Logstash
    • 大规模部署
    • 卸载软件
  • 服务配置
    • 日志说明
    • 管理后台
    • 单机版本
    • 其他配置
  • 功能说明
    • 攻击检测能力说明
    • CVE 漏洞覆盖说明
    • 安全基线检查
    • 应用加固支持
    • 应用异常监控
    • 类库信息查询
    • HTML 响应修改
  • 插件开发
    • 开发插件
    • 接口说明
      • RASP 类接口
      • Context 类接口
    • 参数说明
    • 单元测试
    • 在线调试
    • 官方插件定制
  • 二次开发
    • 架构说明
      • Java 版本
      • PHP 版本
      • 管理后台
      • IAST 扫描器
      • Hook 函数列表
    • 从源代码编译
      • Java 版本
      • PHP 版本
      • 管理后台
    • 云控后台接口
    • 代码调试
    • 添加新的Hook点
    • 添加新的插件API
    • 提交你的代码
  • 性能测试
  • 版本变更
  • 关于我们
Powered by GitBook
On this page
  • 自动化安装
  • 手动安装
Export as PDF
  1. 安装部署
  2. 快速接入

Resin 服务器

PreviousWildfly 服务器NextJetty 服务器

Last updated 11 days ago

自动化安装

解压缩后,首先关闭Resin服务器,然后进入到解压后的目录中,e.g rasp-20180522

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

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

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

java -jar RaspInstall.jar -install <resin_root>

安装成功后,需要重启 Resin 服务器生效。

不重启安装

Resin 目前不支持。

手动安装

1. 安装软件

进入到 resin 安装目录(绝对路径包含空格将导致启动失败),e.g /opt/resin

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

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

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

chmod 777 -R rasp

2. 配置 Resin

注意: 对于集群模式,可能不存在 <server-default> 标签。对于此类情况,请联系研发团队,并确认应该在哪里增加 JVM 启动参数。

如果是 resin 3,

打开conf/resin.conf, 找到 <server-default> 下面的 <jvm-arg> 起始行,e.g

<jvm-arg>-Xmx256m</jvm-arg>
<jvm-arg>-Xss1m</jvm-arg>
<jvm-arg>-Xdebug</jvm-arg>
<jvm-arg>-Dcom.sun.management.jmxremote</jvm-arg>

在下面增加:

<jvm-arg>-javaagent:/opt/resin/rasp/rasp.jar</jvm-arg>

如果是 resin 4,

打开 conf/cluster-default.xml, 找到 <server-default> 下面的 <jvm-arg-line> 起始行,e.g

<jvm-arg-line>${jvm_args}</jvm-arg-line>
<jvm-mode>${jvm_mode}</jvm-mode>

在下面增加:

<jvm-arg>-javaagent:/opt/resin/rasp/rasp.jar</jvm-arg>

3. 开启远程管理

4. 验证安装是否成功

重启 Resin 服务器,观察启动日志中是否出现 OpenRASP Engine Initialized 字样,出现则说明安装成功;或者访问一下服务器,检查是否存在 X-Protected-By: OpenRASP 响应头,存在即表示安装成功。

配置方法同 ,不再赘述。

管理后台 - 添加主机
Tomcat 开启远程管理