一、引言
在现今的网络应用中，接口的安全性是至关重要的一环。IP黑白名单机制作为一种常见的安全策略，可以有效地控制哪些IP地址可以访问我们的服务接口，哪些IP地址则被拒绝访问。本文将介绍在Spring Boot如何实施IP黑白名单限制。
二、为什么对外接口要设计黑白名单
设计IP黑白名单机制的主要原因是为了提高接口的安全性、可控性和灵活性。通过限制访问IP，我们可以防止恶意攻击和未经授权的访问，确保服务的稳定运行。同时，黑白名单的动态调整也为我们提供了灵活的访问控制手段。
三、Spring Boot基于拦截器实现黑白名单限制
在Spring Boot中，我们可以利用拦截器（Interceptor）机制来实现IP黑白名单限制。以下是一个简单的实现步骤和代码示例：
3.1 创建自定义拦截器
首先，我们需要创建一个自定义的拦截器类，实现HandlerInterceptor接口。在preHandle方法中，我们可以检查请求的IP地址是否在黑白名单中。
java
/**
* https://www.sanzhiwa.top/6769.html
* 2023年张雪峰志愿填报
*/
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class IpBasedInterceptor implements HandlerInterceptor {
private final IpUtil ipUtil;
private final IpConfigProperties ipConfigProperties;
@Autowired
public IpBasedInterceptor(IpUtil ipUtil, IpConfigProperties ipConfigProperties) {
this.ipUtil = ipUtil;
this.ipConfigProperties = ipConfigProperties;
}
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
String ipAddress = ipUtil.getIpAddress(request); // 假设IpUtil能处理request以获取IP
boolean isWhiteListed = isIpWhiteListed(ipAddress);
boolean isBlackListed = isIpBlackListed(ipAddress);
// 如果IP在黑名单中，拒绝访问
if (isBlackListed) {
response.setStatus(HttpServletResponse.SC_FORBIDDEN);
response.getWriter().write("IP address is blacklisted. Access denied.");
return false; // 阻止请求继续处理
}
// 如果IP不在白名单中（假设只有白名单中的IP可以访问），也拒绝访问
if (!isWhiteListed && requiresWhitelist()) {
response.setStatus(HttpServletResponse.SC_FORBIDDEN);
response.getWriter().write("IP address is not whitelisted. Access denied.");
return false; // 阻止请求继续处理
}
// 如果IP在白名单中或没有白名单要求，则允许访问
return true;
}
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
// 在请求处理之后进行调用（在视图渲染之前），可用于资源清理
}
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
// 在整个请求完成后调用，即在视图渲染之后调用，用于资源清理
}
// 辅助方法
private boolean isIpWhiteListed(String ipAddress) {
return ipConfigProperties.getWhitelist().contains(ipAddress);
}
private boolean isIpBlackListed(String ipAddress) {
return ipConfigProperties.getBlacklist().contains(ipAddress);
}
// 模拟方法，检查是否需要白名单
private boolean requiresWhitelist() {
// 根据你的应用逻辑决定是否需要白名单限制
// 这里只是简单返回true作为示例
return true;
}
}3.2 获取IP工具类
从HTTP请求头中获取客户端IP地址的几种可能情况，包括从反向代理服务器传递的IP地址
java
/**
* https://www.sanzhiwa.top/6753.html
* 如果历史是一群喵1-10季
*/
import org.springframework.web.context.request.RequestContextHolder;
import org.springframework.web.context.request.ServletRequestAttributes;
import javax.servlet.http.HttpServletRequest;
import org.apache.commons.lang3.StringUtils; // 确保导入了正确的StringUtils类
public class IpUtil {
public static String getIpAddress() {
HttpServletRequest request = ((ServletRequestAttributes) RequestContextHolder.getRequestAttributes()).getRequest();
String ip = request.getHeader("x-forwarded-for");
if (StringUtils.isBlank(ip)) {
ip = request.getHeader("Proxy-Client-IP");
}
if (StringUtils.isBlank(ip)) {
ip = request.getHeader("WL-Proxy-Client-IP");
}
if (StringUtils.isBlank(ip)) {
ip = request.getRemoteAddr();
}
// 多个代理的情况，第一个IP为客户端真实IP,多个IP按照','分割
if (StringUtils.isNotBlank(ip) && ip.contains(",")) {
int commaIndex = ip.indexOf(',');
if (commaIndex > 0) {
ip = ip.substring(0, commaIndex);
}
}
return ip;
}
}3.3 黑白IP配置
可以使用Spring Boot的@ConfigurationProperties注解来绑定配置到Java对象的属性上
java
/**
* 央视推荐纪录片唤醒孩子内驱力
* https://www.sanzhiwa.top/6750.html
*/
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
import java.util.List;
@Component
@ConfigurationProperties(prefix = "ip")
public class IpConfigProperties {
private List<String> whitelist;
private List<String> blacklist;
// 标准的getter和setter方法
public List<String> getWhitelist() {
return whitelist;
}
public void setWhitelist(List<String> whitelist) {
this.whitelist = whitelist;
}
public List<String> getBlacklist() {
return blacklist;
}
public void setBlacklist(List<String> blacklist) {
this.blacklist = blacklist;
}
}然后，在application.yml配置文件中添加IP黑白名单：
html
ip:
whitelist:
- 192.168.1.1
- 10.0.0.100
blacklist:
- 10.0.0.1
- 172.16.0.13.4 配置拦截器
在Spring Boot的配置类中，我们需要将自定义的拦截器注册到拦截器链中，并指定需要拦截的路径。
java
/**
* 央视力荐72部搞钱纪录片搞钱先搞脑
* https://www.sanzhiwa.top/6736.html
*/
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Autowired
private IpBasedInterceptor ipBasedInterceptor;
@Override
public void addInterceptors(InterceptorRegistry registry) {
// 添加拦截器，并定义需要拦截的路径
// 例如，拦截所有以"/api"开头的请求
registry.addInterceptor(ipBasedInterceptor).addPathPatterns("/api/**");
}
}四、总结
IP黑白名单机制是确保接口安全性的重要措施之一。在Spring Boot中，我们可以利用拦截器机制实现IP黑白名单限制，需要我们根据实际情况进行配置和调整，以确保系统的安全性和稳定性。同时，我们也需要不断学习和掌握新的安全技术和方法，以应对日益复杂的网络安全威胁。