feat: expose trusted ViaProxy client IP

Author: bb-dev

src/main/java/org/itxtech/nemisys/utils/ClientChainData.java

@@ -364,6 +364,16 @@ public String getViaProxyAuthToken() {
         return viaProxyAuthToken;
     }
 
+    @Override
+    public String getTrustedViaProxyClientIp() {
+        return trustedViaProxyClientIp;
+    }
+
+    @Override
+    public void setTrustedViaProxyClientIp(String clientIp) {
+        this.trustedViaProxyClientIp = clientIp;
+    }
+
     ///////////////////////////////////////////////////////////////////////////
     // Internal
     ///////////////////////////////////////////////////////////////////////////
@@ -432,6 +442,7 @@ public String getViaProxyAuthToken() {
     private String sandboxId;
 
     private String viaProxyAuthToken;
+    private transient String trustedViaProxyClientIp;
 
     private transient final BinaryStream bs;
 

src/main/java/org/itxtech/nemisys/utils/LoginChainData.java

@@ -118,4 +118,17 @@ public interface LoginChainData {
     default String getViaProxyAuthToken() {
         return null;
     }
+
+    /**
+     * 返回已由 ViaProxyAuth 插件验证过的 Java 客户端来源 IP。
+     */
+    default String getTrustedViaProxyClientIp() {
+        return null;
+    }
+
+    /**
+     * 仅供认证插件在 HMAC 校验成功后写入可信来源 IP。
+     */
+    default void setTrustedViaProxyClientIp(String clientIp) {
+    }
 }