austinderbique/keycloak-trusted-device

🛡️ 带可信设备支持的Keycloak

该镜像基于官方https://github.com/keycloak/keycloak%E5%8F%91%E8%A1%8C%E7%89%88%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%B9%B6%E9%A2%84%E5%AE%89%E8%A3%85%E4%BA%86https://github.com/wouterh-dev/keycloak-spi-trusted-device%E6%89%A9%E5%B1%95%E3%80%82

可信设备扩展允许Keycloak记住已认证的设备，因此用户可在可信设备上跳过MFA，同时在新设备或未识别设备上强制要求MFA。这在不影响安全性的前提下提升了用户体验。

✨ 特性

• 基于官方keycloak/keycloak基础镜像构建。
• 包含可信设备SPI，支持基于设备识别的条件性MFA。
• 开箱即支持完整的带可信MFA的浏览器认证流程。
• 多架构构建：linux/amd64和linux/arm64。
• 当Keycloak发布新版本时，自动发布到Docker Hub。

🏗 GitHub仓库与构建流程

该镜像在公共GitHub仓库中构建和维护： 🔗 https://github.com/aderbique/keycloak-trusted-device

🗓 发布计划

镜像更新并推送到https://hub.docker.com/repository/docker/austinderbique/keycloak-trusted-device%E7%9A%84%E8%A7%A6%E5%8F%91%E6%9D%A1%E4%BB%B6%EF%BC%9A

1. 每周构建 – 获取最新Keycloak版本，若有新版本则重建镜像。
2. 手动构建 – 通过GitHub Actions触发，构建特定Keycloak版本。
3. 标签推送 – 推送如v26.3的Git标签，构建对应Keycloak版本。

标签：

• <KEYCLOAK_VERSION> → 例如：26.3
• latest → 指向最新构建的版本

⚙️ 使用示例

Docker Run

bash
docker run -d \
  --name keycloak \
  -p 8080:8080 \
  -e KEYCLOAK_ADMIN=admin \
  -e KEYCLOAK_ADMIN_PASSWORD=admin \
  docker.xuanyuan.run/austinderbique/keycloak-trusted-device:latest

Docker Compose

yaml
version: "3.8"
services:
  keycloak:
    image: docker.xuanyuan.run/austinderbique/keycloak-trusted-device:latest
    ports:
      - "8080:8080"
    environment:
      KEYCLOAK_ADMIN: admin
      KEYCLOAK_ADMIN_PASSWORD: admin

🔧 设置可信设备流程

警告： 切换认证流程前，请备份Keycloak数据库。

1. 登录Keycloak管理控制台。
2. 导航至认证 → 流程。
3. 复制内置的Browser流程，并重命名（例如：Browser with Trusted MFA）。
4. 编辑新流程，使其与插件文档中的认证流程结构匹配。
5. 在认证 → 绑定下，将新流程设置为浏览器流程。
6. 使用非管理员用户账户进行测试。

有关完整配置详情、设置示例和高级选项，请访问**https://github.com/wouterh-dev/keycloak-spi-trusted-device**%E3%80%82