服務端安全簽名驗簽

引入jar包

gradle

compile 'com.seelyn:api-wrap-boot:{version}'

maven

    com.seelyn
    api-wrap-boot
    {version}

使用示例

• 使用EnableApiWrap注解，開啟API Wrap功能

@SpringBootApplication
@EnableApiWrap
public class WrapWebApplication {

    public static void main(String[] args) {
        SpringApplication.run(WrapWebApplication.class, args);
    }

}

• 在controller類方法或類上添加@ApiWrap注解, 注解也可以自定義處理類，只有使用了注解的類和方法才能接收簽名驗簽請求

@ApiWrap
@PostMapping(value = "/web")
public WrapRequest web(@RequestBody WrapRequest request) {
    return request;
}

• 自定義API簽名驗簽處理類

@ApiWrap(value=CustomWrapHandler.class)
CustomWrapHandler類需要實現WrapHandler接口

• WrapRequest 是統一的API驗證請求類，其中泛型 DefaultWrapData類需要繼承WrapData類

public class WrapRequest {

    private String appKey;
    private String signature;
    private long timestamp;
    private int nonce;
    private T data;
    //setter getter省略.... 
}

import com.seelyn.apiwrap.WrapData;
import com.seelyn.apiwrap.annotation.SignIgnore;

public class DefaultWrapData extends WrapData {

    // SignIgnore 注解標識標識忽略屬性用于簽名
    @SignIgnore
    private String name;
    private String url;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getUrl() {
        return url;
    }

    public void setUrl(String url) {
        this.url = url;
    }
}

• 存儲appKey和appSecret用于請求驗證

@Autoware
private WrapStore wrapStore;

// 存儲密鑰
wrapStore.putSecret(appKey, appSecret);

• 配置文件

#===========api wrap===========
# app密鑰，若用戶沒有自定義，則使用此
api.wrap.secret=testjjhdsa
# 單位秒，請求時間和服務器時間不能超過300秒
api.wrap.legal-time=300
#===========api wrap redis=============
spring.redis.host=localhost
spring.redis.port=6379
spring.redis.database=0