若您的應用使用AHAS支持的第三方組件和框架,可使用Agent接入方式,零代碼修改接入AHAS應用防護。本文以Java Agent為例介紹Agent接入方法。
前提條件
確認應用使用的第三方組件和框架在支持列表中,更多信息,請參見支持組件列表。
自1.9.1版本開始,Java Agent兼容JDK 6~11版本。對于通過Spring Cloud Alibaba Sentinel開源方式接入的應用,無需去除對應依賴也可直接通過Java Agent方式接入。
操作步驟
- 登錄AHAS控制臺。
- 在AHAS控制臺左上角,選擇應用接入的地域。
- 在控制臺左側導航欄中選擇 。
在應用防護頁面,單擊新應用接入。
在JAVA語言頁簽,單擊Agent接入。
安裝并啟動Java Agent。
手動接入方式可以指定單個應用接入AHAS應用防護,操作時需要根據Java虛擬機運行的環境安裝Java Agent。
下載ahas-java-agent.jar安裝包至任意路徑下,例如:/opt/aliyunahas/agent。下載安裝包請單擊ahas-java-agent.jar。
添加JVM啟動參數。
類別
添加參數
非公網
-Dproject.name=<AppName> -Dahas.namespace=default -Dahas.regionId=<RegionId> -javaagent:/opt/aliyunahas/agent/ahas-java-agent.jar
說明將<AppName>替換為自定義的應用名稱,/opt/aliyunahas/agent/ahas-java-agent.jar是ahas-java-agent.jar的下載路徑,請替換為實際路徑。
將<RegionId>替換應用所在地域,地域與RegionId對應表請參見下文地域與RegionId對應表。
公網
-Dproject.name=<AppName> -Dahas.namespace=default -Dahas.regionId=cn-public -Dahas.license=<license> -javaagent:/opt/aliyunahas/agent/ahas-java-agent.jar
說明將<AppName>替換為自定義的應用名稱,將<license>替換為真實值,/opt/aliyunahas/agent/ahas-java-agent.jar是ahas-java-agent.jar的下載路徑,請替換為實際路徑。
將<RegionId>替換應用所在地域,地域與RegionId對應表請參見下文地域與RegionId對應表。
啟動JVM。
Agent接入配置URL收斂:通過啟動參數
-Dcsp.sentinel.url.clean.config.path
配置文件路徑,默認路徑為jar包路徑下的ahas-sentinel-url-clean.properties文件。支持classpath形式,如-Dcsp.sentinel.url.clean.config.path=classpath:ahas-sentinel-url-clean.properties
。Properties文件的格式:匹配前綴等于清理后的資源名稱。
目前僅支持前綴匹配模式。如以下示例的配置會針對/payment/ 開頭的URL,將它們歸一成/payment/*:
/payment/=/payment/*
。
結果驗證
登錄AHAS控制臺,在左側導航欄選擇 ,若在應用防護頁面出現該應用的資源卡片且有數據上報,則說明接入成功。
地域與RegionId對應表
地域 | RegionId |
公網 | cn-public |
華東1(杭州) | cn-hangzhou |
華東2(上海) | cn-shanghai |
華北2(北京) | cn-beijing |
華北3(張家口) | cn-zhangjiakou |
華南1(深圳) | cn-shenzhen |
新加坡 | ap-southeast-1 |
德國(法蘭克福) | eu-central-1 |
常見問題
如果您已完成應用防護服務接入,應用防護頁面仍查看不到您的應用,請參見應用防護常見問題。