Shield

本节作者:cameluo

Shield 是 Elastic 公司官方发布的权限管理产品。其主要特性包括:

  • 提供集群节点身份验证和集群数据访问身份验证

  • 提供基于身份角色的细粒度资源和行为访问控制,细到索引级别的读写控制

  • 提供节点间数据传输通道加密保护输出传输安全

  • 提供审计功能

  • 以插件的形式发布

License管理策略

Shield 是一款商业产品,不过提供 30 天免费试用,试用期间是全功能的。过期后集群会不再正常工作。

Shield架构

用户认证:

Shield 通过定义一套用户集合来认证用户,采用抽象的域方式定义用户集合,支持本地用户(esusers 域)和 LDAP 用户(含 AD)。

  • Shield 提供工具 ./bin/shield/esusers 用于创建和管理本地用户。

  • 集成 LDAP 认证支持映射 LDAP 安全组到 Shield 角色,LDAP 安全组与 Shield 角色可以是多对多的关系。

Shield 支持定义多个认证域,采用order字段进行优先级排序。如一个本地域 esusers,order=1,加一个 LDAP 域,order=2。如果用户不再本地用户域中则在 LDAP 域中查找验证。

  • ./config/shield/roles.yml 文件中定义角色和角色的所拥有的权限。

  • ./config/shield/group_to_role_mapping.yml 文件中定义 LDAP 组到角色映射关系。

节点认证与通道加密:

使用SSL/TLS证书进行相互认证和通讯加密。加密是可选配置。如果不使用,shield 节点之间可以进行简单的密码验证(明文传输)。

授权:

Shield 采用 RBAC 授权模型,数据模型包含如下元素:

  • 受保护资源(Secured Resource):控制用户访问的客体,包括 cluster、index/alias 等等。

  • 权能(Priviliege):用户可以对受保护资源执行的一种或多种操作,如 read, write 等。

  • 许可(Permissions):对被保护的资源拥有的一个或多个权能,如 read on the "products" index。

  • 角色(Role):命名的一组许可。

  • 用户(Users):用户实体,可以被赋予 0 个或多种角色,授权他们对被保护的资源执行各种权能。

审计:

增加认证尝试、授权失败等安全相关事件和活动日志。

安装

  1. 安装 License 和 Shield 插件

bin/plugin -i elasticsearch/license/latest
bin/plugin -i elasticsearch/shield/latest

注意:初次运行 Shield 需要重新启动 ES 集群。后续更新 License(license.json 为 License 文件)就可以在线运行:

# curl -XPUT -u admin 'http://127.0.0.1:9200/_licenses' -d @license.json
  1. 创建本地管理员:

./bin/shield/esusers useradd esadmin -r admin

配置

这里使用简单的配置先完成基本验证:使用纯本地用户认证或者使用本地认证 + 基本的 ldap 认证。

ES 配置

在elasticsearch.yml中增加如下配置:

hostname_verification: false
#shield.ssl.keystore.path:          /app/elasticsearch/node01.jks
#shield.ssl.keystore.password:      xxxxxx
shield:
  authc:
    realms:
      default:
        type: esusers
        order: 1
      ldaprealm:
        type: ldap
        order: 2
        url: "ldap://ldap.example.com:389"
        bind_dn: "uid=ldapuser, ou=users, o=services, dc=example, dc=com"
        bind_password: changeme
        user_search:
          base_dn: "dc=example,dc=com"
          attribute: uid
        group_search:
          base_dn: "dc=example,dc=com"
        files:
          role_mapping: "/app/elasticsearch/shield/group_to_role_mapping.yml"
        unmapped_groups_as_roles: false

角色配置

根据默认配置文件增减角色和访问控制权限。角色配置文件可以在线修改,保存后立即生效:

([INFO ][shield.authz.store ] [Winky Man] updated roles (roles file [/opt/elasticsearch/config/shield/roles.yml] changed))

注意:如果需要集成kibana认证,用户角色也需要有访问'.kibana'索引的访问权限和cluster:monitor/nodes/info的访问权限,具体参照kibana4角色中的定义,否则用户通过kibana认证后仍然无法访问到数据索引

用户组与角色映射配置

根据默认配置文件增减用户、用户组与角色配置中定义角色的映射关系,可以灵活实现各种需求。LDAP组仅支持安全组,不支持动态组。这个配置文件可以在线修改,保存后立即生效:

([INFO ][shield.authc.ldap.support] [Vishanti] role mappings file [/opt/elasticsearch/config/shield/group_to_role_mapping.yml] changed for realm [ldap/ldaprealm]. updating mappings...)

测试

curl -u username http://127.0.0.1:9200/

Last updated