如何配置Quarkus自定义HttpAuthenticationMechanism用于/webhook端点

核心配置步骤 #

以下是让FixedTokenAuthenticationMechanism仅作用于/webhook端点的完整application.properties配置方案：

1. 定义/webhook路径的权限规则
   先指定该路径需要认证：

   quarkus.http.auth.permission.webhook.paths=/webhook/*
   quarkus.http.auth.permission.webhook.policy=authenticated
   

   若只需精确匹配/webhook而非子路径，将paths值改为/webhook即可。

2. 绑定自定义认证机制到该路径
   首先给你的FixedTokenAuthenticationMechanism配置启用标识和静态Token，再指定该路径使用此机制：

   # 启用自定义固定Token认证机制并设置Token值
   quarkus.http.auth.mechanism-fixed-token.enabled=true
   quarkus.http.auth.mechanism-fixed-token.token=你的硬编码静态Token
   # 指定/webhook路径使用该认证机制
   quarkus.http.auth.permission.webhook.mechanism=fixed-token
   

   注意：这里的fixed-token必须和你实现类上@AuthenticationMechanismRegistration注解的mechanismId完全一致，比如你的实现类代码：

   @AuthenticationMechanismRegistration(mechanismId = "fixed-token")
   public class FixedTokenAuthenticationMechanism implements HttpAuthenticationMechanism {
       // 你的验证逻辑实现
   }
   

3. 避免默认认证机制干扰（可选）
   如果应用存在其他默认认证机制（如Basic认证），需确保/webhook路径不使用它们，可补充：

   # 设置全局默认认证机制（根据你的实际情况调整）
   quarkus.http.auth.default-mechanism=basic
   # 强制/webhook路径仅使用fixed-token机制
   quarkus.http.auth.permission.webhook.mechanism=fixed-token
   

验证要点 #

• 确认配置中的Token值与你代码里用于验证的硬编码Token完全一致
• 测试/webhook端点时，需携带正确的Token才能访问，未携带或携带错误Token应返回401未授权

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