hashicorp/vault-plugin-database-elasticsearch

Vault Elasticsearch数据库插件镜像

概述

Vault Elasticsearch数据库插件镜像为HashiCorp Vault提供后端插件容器化部署能力。该插件通过原生X-Pack Security机制，为Elasticsearch集群生成唯一且短期有效的访问凭证，确保数据访问的安全性与可控性。镜像仅支持在Linux操作系统上运行的Vault服务器环境。

核心功能与特性

• 动态凭证管理：自动生成具有时效性的Elasticsearch访问凭证，减少长期静态凭证泄露风险
• X-Pack Security集成：原生支持Elasticsearch X-Pack Security认证体系，无需额外适配
• 容器化部署：提供轻量级容器封装，简化插件在容器化Vault环境中的部署与管理
• 平台兼容性：专为Linux平台的Vault服务器优化，确保稳定运行

使用场景

• 需通过Vault集中管理Elasticsearch访问权限的企业级环境
• 要求数据库凭证定期自动轮换的安全合规场景
• 容器化部署的Vault服务需要扩展Elasticsearch数据库支持的场景
• 多团队共享Elasticsearch集群时的细粒度权限控制需求

使用方法

前提条件

• 运行在Linux系统上的Vault服务器（v1.0+）
• 已启用X-Pack Security的Elasticsearch集群（v7.0+推荐）
• 具备Docker环境及容器网络访问权限
• Vault服务器已配置插件目录并启用插件系统

获取镜像

从官方容器仓库拉取最新版本镜像：

bash
docker pull hashicorp/vault-plugin-database-elasticsearch:latest

运行插件容器

将插件文件挂载至Vault插件目录，确保Vault可加载：

bash
docker run -d \
  --name vault-elasticsearch-plugin \
  --volume /etc/vault/plugins:/plugins \
  --user root \
  hashicorp/vault-plugin-database-elasticsearch:latest \
  cp /vault-plugin-database-elasticsearch /plugins/

Vault配置流程

1. 注册插件

在Vault中注册插件（需先计算插件SHA256校验和）：

bash
# 计算插件校验和
SHA256=$(shasum -a 256 /etc/vault/plugins/vault-plugin-database-elasticsearch | awk '{print $1}')

# 注册插件
vault plugin register -sha256="${SHA256}" database elasticsearch-database-plugin

2. 启用数据库后端

bash
vault secrets enable database

3. 配置Elasticsearch连接

bash
vault write database/config/elasticsearch \
  plugin_name="elasticsearch-database-plugin" \
  connection_url="https://<elasticsearch-host>:9200" \
  username="elastic-admin" \
  password="elastic-admin-password" \
  allowed_roles="dev-team,ops-team"

4. 创建角色与权限策略

定义Elasticsearch角色权限模板：

bash
vault write database/roles/dev-team \
  db_name="elasticsearch" \
  creation_statements='{
    "elasticsearch_role_definition": {
      "cluster": ["monitor"],
      "indices": [
        {"names": ["dev-*"], "privileges": ["read", "write", "create_index"]}
      ]
    }
  }' \
  default_ttl="1h" \
  max_ttl="24h"

5. 生成访问凭证

应用角色获取动态凭证：

bash
vault read database/creds/dev-team

配置参数说明

注意事项

• 插件容器需与Vault服务器保持网络连通，确保插件注册与通信正常
• Elasticsearch管理员账户需具备"manage_security"集群权限，以创建临时角色
• 凭证有效期设置应根据业务需求平衡安全性与可用性，建议default_ttl不超过24小时
• 生产环境中应通过Docker volume挂载方式持久化插件文件，避免容器重启导致插件丢失