操作步驟

1. 登錄AHAS控制臺。
2. 在AHAS控制臺左上角，選擇應用接入的地域。
3. 在控制臺左側(cè)導航欄中選擇流量防護 > 應用防護。

4. 在應用防護頁面右上角單擊新應用接入。

5. 在JAVA語言頁簽，單擊SDK接入，然后單擊Dubbo/HSF應用接入。

6. 選擇以下任意一種方式，在HSF應用中添加應用防護依賴。

   • 若是Spring Boot應用，則可以通過starter方式接入。在pom.xml中引入以下依賴：

     <dependency>
       <groupId>com.alibaba.csp</groupId>
       <artifactId>spring-boot-starter-ahas-sentinel-client</artifactId>
       <!-- 需指定版本號，需要≥1.7.2版本。最新版本見AHAS控制臺應用防護新應用接入頁引導。 -->
       <version>x.y.z</version>
     </dependency>

   • 若非Spring Boot應用，則在pom.xml中引入以下依賴：

     <dependency>
       <groupId>com.alibaba.csp</groupId>
       <artifactId>ahas-sentinel-client</artifactId>
       <!-- 需指定版本號，需要≥1.7.2 版本。最新版本見AHAS控制臺應用防護新應用接入頁引導。 -->
       <version>x.y.z</version>
     </dependency>

   在Dubbo/HSF接入頁面第一步：添加Pom依賴中查看Pom依賴最新版本，將x.y.z替換為新版本的版本號。

   

7. 配置應用的啟動參數(shù)。

   類別	參數(shù)示例
   非公網(wǎng)	-Dproject.name=AppName -Dahas.namespace=default -Dahas.regionId=<RegionId> 說明 將AppName替換為自定義的應用名稱。 將<RegionId>替換應用所在地域，地域與RegionId對應表請參見下文地域與RegionId對應表。
   公網(wǎng)	-Dproject.name=AppName -Dahas.license=<license> -Dahas.namespace=default -Dahas.regionId=cn-public 說明 將AppName替換為自定義的應用名稱，將<license>替換為真實值。

   若在公網(wǎng)地域，需要查看License信息。請在第二步：添加埋點區(qū)域查看（非公網(wǎng)地域不需要），具體請參見查看License。

   

8. 重啟您的應用。

9. 可選：您可以自定義HSF應用觸發(fā)限流、降級或系統(tǒng)保護規(guī)則時的fallback處理邏輯，自定義HsfFallback接口并通過HsfFallbackRegistry注冊即可（setProviderFallback針對服務提供方，setConsumerFallback針對服務消費方）。完成配置后，當HSF應用觸發(fā)流控、降級或系統(tǒng)規(guī)則時，AHAS會將BlockException攜帶到fallback中。

   說明

   若未執(zhí)行此步驟，當HSF應用觸發(fā)應用防護規(guī)則時，默認拋出固定的異常RuntimeException("SentinelBlockException")。

結(jié)果驗證

登錄AHAS控制臺，在左側(cè)導航欄選擇流量防護 > 應用防護，若在應用防護頁面出現(xiàn)該應用的資源卡片且有數(shù)據(jù)上報，則說明接入成功。

地域與RegionId對應表