接入Java应用

在手动接入的主机接入指南子页签，单击一键推送。

在推送RASP探针对话框，选择需推送探针的服务器，并单击确定。

根据应用运行环境类型参考控制台或下表中的说明在应用服务器中添加JVM参数。

参考下表进行操作时，您需要使用控制台主机接入指南页签展示的应用ID替换下表中的{appId}。应用ID的位置如下图所示。

export CATALINA_OPTS="$CATALINA_OPTS -javaagent:/usr/local/aegis/rasp/apps/{appId}/rasp.jar"

set CATALINA_OPTS=%CATALINA_OPTS% "-javaagent:C:\Program Files (x86)\Alibaba\Aegis\rasp\apps\{appId}\rasp.jar" 

--exec -javaagent:/usr/local/aegis/rasp/apps/{appId}/rasp.jar

java -javaagent:/usr/local/aegis/rasp/apps/{appId}/rasp.jar

java -jar app.jar

java -javaagent:/usr/local/aegis/rasp/apps/{appId}/rasp.jar -jar app.jar

-javaagent:/usr/local/aegis/rasp/apps/{appId}/rasp.jar

在本地重启需接入的应用。

应用重启后RASP防护可立即生效。您可以在应用配置页面，查看该应用分组下接入实例列表。

在手动接入页签的容器接入指南子页签，单击一键推送。

您也可以在推送记录页签，单击推送RASP探针，为应用所在的主机或容器推送并安装RASP探针。

在推送RASP探针对话框，选择需推送探针的服务器，并单击确定。

启动RASP探针。

• 方法一：写入Dockerfile方式

  1. 执行下述命令进入Dockerfile所在目录，并创建rasp目录。

     cd <Dockerfile所在目录>
     mkdir rasp

  2. 执行下述命令将推送到服务器上的RASP文件拷贝到新创建的rasp目录下。

     您可以在云安全中心控制台容器接入指南页签下，获取应用分组ID的值。

     cp -r /usr/local/aegis/rasp/apps/<应用分组ID>/* ./rasp

  3. 修改Dockerfile文件，将下载好的 rasp 安装包打包到容器镜像中。Dockerfile文件需要添加的内容如下。

     COPY rasp /rasp/

     重要

     您需要赋予指定用户读取和执行/rasp/目录以及目录下文件的权限。

  4. 通过Dockerfile 修改JVM启动参数，添加-javaagent:/rasp/rasp.jar。

     您需要使用容器接入指南页签展示的Dmanager.key值替换下表中的{manager.key}。

     运行环境	参数配置说明
     SpringBoot	在镜像打包时安装RASP探针，您需要在Dockerfile上修改启动参数。启动应用的命令修改如下： 修改前： CMD ["java","-jar","/app.jar"] 修改后： CMD ["java","-javaagent:/rasp/rasp.jar","-Dmanager.key={manager.key}","-jar","/app.jar"]
     Tomcat	在镜像打包时安装RASP探针，您需要在Dockerfile中添加以下内容。 ENV JAVA_OPTS="-javaagent:/rasp/rasp.jar -Dmanager.key={manager.key}" 在容器启动时安装RASP探针，您需要在启动时添加以下参数。 docker --env JAVA_OPTS="-javaagent:/rasp/rasp.jar -Dmanager.key={manager.key}" 例如，您的容器启动命令为docker -itd --name=test -P 镜像名，您需要在启动容器时安装RASP探针，则执行的命令需要修改为docker -itd --env JAVA_OPTS="-javaagent:/rasp/rasp.jar -Dmanager.key={manager.key}" --name=test -P 镜像名。
     Weblogic

  5. 重新生成镜像，并启动容器。

• 方法二：数据卷挂载方式

  1. 执行下述命令在创建容器时将服务器上的rasp目录挂载到容器指定目录。

     docker run -itd --privileged=true -v /usr/local/aegis/rasp/apps/<应用分组ID>:/rasp/ 镜像ID

  2. 执行下述命令进入容器。

     docker exec -it <容器ID> /bin/bash

  3. 在应用服务器的启动脚本中添加以下JVM参数以启动RASP探针。

     您需要参考下述参数结合自己的业务环境进行配置。您需要使用容器接入指南页签展示的Dmanager.key值替换下述{manager.key}。

     -javaagent:/rasp/rasp.jar -Dmanager.key={manager.key}

在手动接入页签的容器接入指南子页签，在下载安装RASP探针下方的下拉列表中选择自定义下载安装。

您也可以在推送记录页签，单击推送RASP探针，为应用所在的主机或容器推送并安装RASP探针。

在下拉列表中，根据您需要安装RASP探针的服务器是否通过代理接入云安全中心，选择不接入代理或自建代理集群。

选择自建代理集群后，您需要选择服务器接入的代理集群。关于代理接入的更多信息，请参见代理接入。

单击RASP安装包右侧的下载，下载RASP安装包。

启动RASP探针。

• 方法一：写入Dockerfile方式

  1. 执行下述命令进入Dockerfile所在目录。

     cd <Dockerfile所在目录>

  2. 将下载的RASP安装包上传到Dockerfile所在目录下，并解压RASP安装包到该目录。

     unzip <安装包名称> -d .

     说明

     安装包解压完成后会直接生成一个名称为rasp的目录。

  3. 修改Dockerfile文件，将下载好的 rasp 安装包打包到容器镜像中。Dockerfile文件需要添加的内容如下。

     COPY rasp /rasp/

     重要

     您需要赋予指定用户读取和执行/rasp/目录以及目录下文件的权限。

  4. 通过Dockerfile 修改JVM启动参数，添加-javaagent:/rasp/rasp.jar。

     您需要使用容器接入指南页签展示的Dmanager.key值替换下表中的{manager.key}。

     运行环境	参数配置说明
     SpringBoot	在镜像打包时安装RASP探针，您需要在Dockerfile上修改启动参数。启动应用的命令修改如下： 修改前： CMD ["java","-jar","/app.jar"] 修改后： CMD ["java","-javaagent:/rasp/rasp.jar","-Dmanager.key={manager.key}","-jar","/app.jar"]
     Tomcat	在镜像打包时安装RASP探针，您需要在Dockerfile中添加以下内容。 ENV JAVA_OPTS="-javaagent:/rasp/rasp.jar -Dmanager.key={manager.key}" 在容器启动时安装RASP探针，您需要在启动时添加以下参数。 docker --env JAVA_OPTS="-javaagent:/rasp/rasp.jar -Dmanager.key={manager.key}" 例如，您的容器启动命令为docker -itd --name=test -P 镜像名，您需要在启动容器时安装RASP探针，则执行的命令需要修改为docker -itd --env JAVA_OPTS="-javaagent:/rasp/rasp.jar -Dmanager.key={manager.key}" --name=test -P 镜像名。
     Weblogic

  5. 重新生成镜像，并启动容器。

• 方法二：数据卷挂载方式

  1. 将下载的RASP安装包上传到服务器指定的目录下，并执行解压操作。

     您需要根据具体环境替换user.path为正确的路径。

     unzip  zhh-php1-China.zip -d /<user.path>/

  2. 执行下述命令在创建容器时将服务器上的rasp目录挂载到容器指定目录。

     docker run -itd  -v /<user.path>/rasp:/rasp/ 镜像id 

  3. 执行下述命令进入容器。

     docker exec -it <容器ID> /bin/bash

  4. 在应用服务器的启动脚本中添加以下JVM参数以启动RASP探针。

     您需要参考下述参数结合自己的业务环境进行配置。您需要使用容器接入指南页签展示的Dmanager.key值替换下述{manager.key}。

     -javaagent:/rasp/rasp.jar -Dmanager.key={manager.key}