如何配置Wildfly为静态内容（如图片）添加认证访问控制？

没问题，这就给你详细讲清楚怎么实现需求——让/img下的静态资源默认返回401，只有携带正确的URL参数auth=some_app_key或者请求头参数时才返回200。分两种场景给你说明：

一、简单固定Key验证（无需写代码，用Undertow内置Handler） #

这种方式适合你的认证Key是固定值的情况，直接通过WildFly配置文件就能搞定：

步骤1：配置静态资源位置 #

首先在standalone.xml（或domain.xml）的Undertow子系统里，给静态资源指定存储路径：

<subsystem xmlns="urn:jboss:domain:undertow:3.0">
    <server name="default-server">
        <http-listener name="default" socket-binding="http"/>
        <host name="default-host" alias="localhost">
            <!-- 把/img路径指向我们后续定义的认证检查Handler -->
            <location name="/img" handler="auth-check-handler"/>
            
            <handlers>
                <!-- 定义静态资源Handler，指向实际的图片存储目录 -->
                <file name="img-content-handler" path="${jboss.home.dir}/standalone/data/images" directory-listing="false"/>
                
                <!-- 核心：认证检查的IF Handler -->
                <if name="auth-check-handler">
                    <!-- 断言规则：URL参数auth等于指定值，OR 请求头X-App-Key等于指定值 -->
                    <predicate>(param(auth) = 'some_app_key') or (header(X-App-Key) = 'some_app_key')</predicate>
                    <!-- 满足条件则放行到静态资源Handler -->
                    <handler name="img-content-handler"/>
                    <!-- 不满足条件则返回401 -->
                    <else>
                        <status-code code="401" reason="Unauthorized"/>
                    </else>
                </if>
            </handlers>
        </host>
    </server>
</subsystem>

注意：把${jboss.home.dir}/standalone/data/images替换成你实际存放图片的目录，也可以用绝对路径。

步骤2：验证效果 #

• 直接访问http://localhost/img/my_img.jpg：返回401 Unauthorized
• 访问http://localhost/img/my_img.jpg?auth=some_app_key：返回200 OK
• 携带请求头X-App-Key: some_app_key访问http://localhost/img/my_img.jpg：返回200 OK

二、复杂自定义认证（适合动态Key/多Key/数据库验证等场景） #

如果你的认证逻辑更复杂（比如Key需要从数据库读取、支持多个有效Key、需要超时校验等），就需要自定义Undertow Handler：

步骤1：编写自定义Handler类 #

创建一个Java类实现Undertow的HttpHandler接口，实现认证逻辑：

package com.yourcompany.auth;

import io.undertow.server.HttpHandler;
import io.undertow.server.HttpServerExchange;
import io.undertow.util.StatusCodes;

public class StaticResourceAuthHandler implements HttpHandler {
    private final HttpHandler nextHandler;
    // 可以通过配置注入有效Key，这里示例用固定值，实际可改成从配置/数据库读取
    private String validAppKey = "some_app_key";

    // 构造方法，接收后续要执行的Handler（静态资源Handler）
    public StaticResourceAuthHandler(HttpHandler nextHandler) {
        this.nextHandler = nextHandler;
    }

    @Override
    public void handleRequest(HttpServerExchange exchange) throws Exception {
        // 提取URL参数中的auth值
        String paramAuth = exchange.getQueryParameters().get("auth") != null 
                ? exchange.getQueryParameters().get("auth").getFirst() 
                : null;
        // 提取请求头中的X-App-Key值
        String headerAuth = exchange.getRequestHeaders().getFirst("X-App-Key");
        
        // 认证逻辑：检查参数或请求头是否匹配有效Key
        if (validAppKey.equals(paramAuth) || validAppKey.equals(headerAuth)) {
            // 认证通过，交给下一个Handler处理静态资源
            nextHandler.handleRequest(exchange);
        } else {
            // 认证失败，返回401并结束请求
            exchange.setStatusCode(StatusCodes.UNAUTHORIZED);
            exchange.endExchange();
        }
    }

    // 提供Setter用于配置注入有效Key
    public void setValidAppKey(String validAppKey) {
        this.validAppKey = validAppKey;
    }
}

步骤2：打包成WildFly模块 #

1. 把编译好的类打包成static-auth-handler.jar
2. 在WildFly的modules目录下创建com/yourcompany/auth/main目录，把jar放进去
3. 创建module.xml文件，定义模块依赖：

<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.3" name="com.yourcompany.auth">
    <resources>
        <resource-root path="static-auth-handler.jar"/>
    </resources>
    <dependencies>
        <module name="io.undertow.core"/>
        <module name="javax.api"/>
    </dependencies>
</module>

步骤3：在WildFly配置中引用自定义Handler #

修改standalone.xml的Undertow子系统：

<subsystem xmlns="urn:jboss:domain:undertow:3.0">
    <server name="default-server">
        <http-listener name="default" socket-binding="http"/>
        <host name="default-host" alias="localhost">
            <location name="/img" handler="custom-static-auth-handler"/>
            
            <handlers>
                <file name="img-content-handler" path="${jboss.home.dir}/standalone/data/images" directory-listing="false"/>
                
                <!-- 引用自定义Handler -->
                <custom name="custom-static-auth-handler" 
                        class-name="com.yourcompany.auth.StaticResourceAuthHandler" 
                        module="com.yourcompany.auth">
                    <!-- 指定后续要执行的静态资源Handler -->
                    <param name="nextHandler" value="img-content-handler"/>
                    <!-- 注入有效Key（可选，也可以在代码里动态读取） -->
                    <param name="validAppKey" value="some_app_key"/>
                </custom>
            </handlers>
        </host>
    </server>
</subsystem>

步骤4：重启WildFly验证效果 #

和第一种方式的验证逻辑完全一致，只是认证逻辑换成了你自定义的代码，扩展性更强。

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