如何在Keycloak重置凭证流程的认证器中编程访问事件日志？

一、自定义认证器SPI内部获取（核心场景） #

因为你是在实现重置凭证流程的认证器，直接通过Keycloak SPI的内部API查询是最优方案：

• 注入EventQuery对象
  从KeycloakSession中获取事件查询入口：

  EventQuery eventQuery = session.events().query();
  

• 构建筛选条件
  指定目标用户、事件类型和时间范围：

  String userId = user.getId();
  // 示例：查询最近1小时内的事件（可根据需求调整时间戳）
  long startTime = System.currentTimeMillis() - 3600000;
  long endTime = System.currentTimeMillis();
  
  List<Event> resetEvents = eventQuery
      .userId(userId)
      .event(EventType.SEND_RESET_PASSWORD)
      .time(startTime, endTime)
      .list();
  

• 统计次数
  通过resetEvents.size()即可得到指定时间段内的事件触发次数，用于后续决策逻辑。

  注意：需确保Realm已开启事件记录——在Keycloak控制台的「Realm设置 > 事件」中，勾选SEND_RESET_PASSWORD并启用事件存储。

二、Admin Client API获取（外部服务场景） #

如果是外部服务需要查询该事件，可使用Keycloak Admin Client：

• 初始化Admin Client

  Keycloak keycloak = KeycloakBuilder.builder()
      .serverUrl("http://your-keycloak-domain/auth")
      .realm("your-realm-name")
      .clientId("admin-cli")
      .username("admin-username")
      .password("admin-password")
      .build();
  

• 执行事件查询

  Map<String, String> queryParams = new HashMap<>();
  queryParams.put("userId", "target-user-id");
  queryParams.put("type", "SEND_RESET_PASSWORD");
  queryParams.put("fromDate", String.valueOf(startTime));
  queryParams.put("toDate", String.valueOf(endTime));
  
  List<EventRepresentation> events = keycloak.realm("your-realm-name")
      .events()
      .query(queryParams)
      .list();
  
  int eventCount = events.size();
  

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