如何在SEEDSTACK框架下配置Feign客户端实现REST服务Basic认证

我来帮你搞定这个SEEDSTACK里Feign调用带Basic认证服务的问题，结合你给出的代码和配置，分步骤说清楚怎么弄：

1. 配置Feign的Basic认证，传递用户名密码 #

服务端用了authcBasic过滤器，所以客户端必须在每个请求里带上Basic Auth的Authorization头，有两种常用方式：

方式一：直接通过配置文件实现（最简单） #

修改你的客户端application.yaml，添加Feign的Basic认证配置，指定用户名和密码：

feign:
  endpoints:
    neosdClient.interfaces.rest.neosdServer:
      baseUrl: http://localhost:8080
      encoder: feign.jackson.JacksonEncoder
      decoder: feign.jackson.JacksonDecoder
      # 启用官方Basic Auth拦截器
      requestInterceptors:
        - feign.auth.BasicAuthRequestInterceptor
  config:
    neosdClient.interfaces.rest.neosdServer:
      basicAuth:
        # 替换成你的服务端认证用户名和密码
        username: your_service_username
        password: your_service_password

如果不想硬编码敏感信息，推荐用SEEDSTACK的环境变量占位符，比如${env:SERVICE_USER}和${env:SERVICE_PASS}，从环境变量里读取凭证。

方式二：自定义拦截器（更灵活） #

如果需要更定制化的逻辑（比如动态获取凭证），可以自己写一个请求拦截器：

import feign.RequestInterceptor;
import feign.RequestTemplate;
import java.nio.charset.StandardCharsets;
import java.util.Base64;

public class CustomBasicAuthInterceptor implements RequestInterceptor {
    private final String username;
    private final String password;

    // 通过SEEDSTACK的配置注入用户名密码
    public CustomBasicAuthInterceptor(String username, String password) {
        this.username = username;
        this.password = password;
    }

    @Override
    public void apply(RequestTemplate template) {
        // 生成Basic Auth的凭证字符串
        String authCredentials = username + ":" + password;
        String encodedAuth = Base64.getEncoder()
                .encodeToString(authCredentials.getBytes(StandardCharsets.UTF_8));
        // 添加Authorization请求头
        template.header("Authorization", "Basic " + encodedAuth);
    }
}

然后在客户端配置里注册这个拦截器：

feign:
  endpoints:
    neosdClient.interfaces.rest.neosdServer:
      baseUrl: http://localhost:8080
      encoder: feign.jackson.JacksonEncoder
      decoder: feign.jackson.JacksonDecoder
      requestInterceptors:
        - neosdClient.interfaces.rest.CustomBasicAuthInterceptor
  config:
    neosdClient.interfaces.rest.neosdServer:
      customBasicAuthInterceptor:
        username: ${env:SERVICE_USER}
        password: ${env:SERVICE_PASS}

同时，你的Feign接口可以保持不变，或者添加@InterceptorRef指定拦截器（可选）：

@FeignApi
@InterceptorRef("customBasicAuthInterceptor")
public interface neosdServer {
    @RequestLine("GET /file/getfilesprop")
    List<NeosdFile> getfilesprop();
    @RequestLine("GET /file/getfiles")
    List<String> getfiles();
}

2. 处理read角色权限要求 #

因为/file/getfiles接口额外要求read角色，你需要确保：

• 服务端的认证用户已经被分配了read角色，比如服务端的application.yaml里的用户配置（以内存域为例）：

security:
  realms:
    - name: inMemoryRealm
      users:
        - username: testuser
          password: testpass
          roles: [read]

• 客户端传递的用户名密码对应的用户，必须在服务端拥有这个角色，否则调用getfiles()接口会返回403 Forbidden错误。客户端这边不需要额外编码，服务端会自动校验角色权限。

3. 测试验证 #

在客户端代码中注入neosdServer接口，调用两个接口测试：

// 注入Feign接口
@Inject
private neosdServer neosdServer;

// 测试调用
public void testFeignCalls() {
    // 调用不需要角色的接口
    List<NeosdFile> filesProp = neosdServer.getfilesprop();
    // 调用需要read角色的接口
    List<String> files = neosdServer.getfiles();
}

如果凭证正确且用户有read角色，就能正常返回数据；如果凭证错误会返回401 Unauthorized，角色不足则返回403 Forbidden。

内容的提问来源于stack exchange，提问作者KatteStone