hashicorp/vault-plugin-auth-kerberos

Vault Kerberos认证插件Docker镜像文档

1. 镜像概述和主要用途

Vault Kerberos认证插件是HashiCorp Vault的后端插件，用于实现通过Kerberos/SPNEGO协议进行用户认证。该Docker镜像专门用于容器化部署此插件，提供了与Vault集成的认证能力。需注意，此镜像仅支持运行在Linux系统的Vault服务器上。

项目源码地址：https://github.com/hashicorp/vault-plugin-auth-kerberos

2. 核心功能和特性

• Kerberos/SPNEGO认证支持：实现基于Kerberos和SPNEGO协议的用户身份验证，兼容现有Kerberos环境
• Vault后端插件集成：作为Vault官方认证后端插件，可直接集成到Vault的认证体系中
• 容器化部署：通过Docker镜像简化插件部署流程，支持容器化环境下的快速集成
• Linux系统兼容性：仅支持运行在Linux操作系统的Vault服务器实例

3. 使用场景和适用范围

• Kerberos环境集成：适用于已部署Kerberos认证体系的企业环境，需通过Vault管理密钥并使用Kerberos用户认证的场景
• Vault认证扩展：需要为Vault添加Kerberos协议认证能力的场景
• 容器化Vault部署：采用容器化方式部署Vault的环境，需通过容器化插件扩展认证功能

4. 使用方法和配置说明

4.1 前提条件

• 运行在Linux系统的Vault服务器
• 已配置的Kerberos环境（包括KDC、领域等）
• Docker环境（用于运行插件容器）

4.2 基本使用流程

1. 拉取镜像
   从容器仓库拉取最新版本的插件镜像（具体镜像名称需参考官方发布渠道）：

   bash
   docker pull hashicorp/vault-plugin-auth-kerberos:latest
   

2. 配置Vault加载插件
   需先在Vault中启用插件目录，并配置插件注册。具体步骤包括：

   • 设置Vault插件目录并重启Vault服务
   • 通过vault plugin register命令注册该认证插件
   • 启用插件认证后端

3. 启动插件容器
   运行插件容器时，需确保容器与Vault服务器网络连通，并挂载必要的配置文件（如Kerberos配置krb5.conf等）：

   bash
   docker run -d \
     --name vault-kerberos-plugin \
     -v /path/to/krb5.conf:/etc/krb5.conf \
     -e VAULT_ADDR="https://vault-server:8200" \
     hashicorp/vault-plugin-auth-kerberos:latest
   

4.3 配置参数说明

具体配置参数（如Kerberos领域、KDC地址、SPN配置等）需参考插件官方文档，通过Vault的插件配置命令进行设置。详细配置步骤及参数说明请查阅项目GitHub仓库的官方文档。

5. 注意事项

• 确保Vault服务器与插件容器之间的网络通信正常，特别是插件注册和认证流程中的端口访问
• Kerberos配置文件（krb5.conf）需正确挂载到容器中，以确保插件能正常与KDC通信
• 插件版本需与Vault服务器版本兼容，具体兼容性信息请参考官方发布说明