管理用户凭证

更新时间:
复制 MD 格式

用户凭证用于以管理员账号安全地访问Elasticsearch实例,凭证密码经阿里云密钥管理服务(KMS)加密存储。Elasticsearch 智能助手的数据洞察、ES原生接口调用等场景可引用用户凭证完成鉴权,无需在调用方保存明文密码。本文介绍如何创建、设置默认与删除用户凭证。

背景信息

访问Elasticsearch实例需要携带访问账号与密码。为避免在应用代码、脚本或第三方工具中硬编码密码,您可以将账号密码创建为用户凭证,由阿里云服务端加密保存;调用方只需引用凭证名称即可完成鉴权。调用ES原生接口未显式指定凭证时,将自动使用实例的默认凭证。

  • 凭证密码仅加密存储在阿里云服务端,不会展示给任何第三方组件,也不会出现在聊天记录、模型输入、日志或URL中。

  • 每个实例仅允许一条默认凭证。将某条凭证设为默认后,原默认凭证自动取消默认。

  • 凭证关联实例的ES账号权限:凭证可访问的索引范围与操作类型,由创建凭证时所用账号的权限决定,凭证本身不额外赋权。

创建用户凭证

  1. 登录阿里云Elasticsearch控制台。

  2. 在左侧导航栏选择Elasticsearch实例,单击目标实例ID进入实例详情页。

  3. 在左侧导航栏单击安全配置,在用户凭证管理区域单击新建凭证。

  4. 在新建凭证对话框配置以下参数,然后单击确定。

    参数

    说明

    目标实例

    凭证所属的实例,自动展示当前实例ID、版本与地域,不可修改。

    凭证名称

    凭证的名称,用于在凭证列表与调用方区分不同凭证,最长128个字符,可不填。

    账号

    访问实例使用的ES账号,如elastic。凭证可访问的索引与操作范围由该账号的权限决定。

    密码

    该账号的访问密码。要求8~30位,且包含大写字母、小写字母、数字、特殊字符中的至少三类。密码提交后经阿里云密钥管理服务加密存储。

    默认凭证

    开启后该凭证成为实例的默认凭证,调用未指定凭证时自动使用。实例内仅一条默认凭证。

创建完成后,凭证展示在用户凭证管理列表,可查看凭证名称、凭证类型(当前为基础认证)、用户名与创建时间。

设置默认与删除凭证

  • 设为默认:在凭证列表的操作列单击后确认,原默认凭证自动取消默认。

  • 删除:删除后,使用该凭证的调用将立即失败。删除前请确认没有正在引用该凭证的任务或应用;删除默认凭证后,未指定凭证的调用将因无默认凭证而失败,需重新设置默认凭证。

使用场景

  • Elasticsearch 智能助手数据洞察:在智能助手对话中查询或写入索引业务数据时,在上下文信息卡的凭证中选择用户凭证建立数据访问会话,无需在对话中输入密码。详情请参见使用 Elasticsearch 智能助手的「数据洞察」章节。

  • ES原生接口调用:调用ES原生接口未显式指定凭证时,自动使用实例的默认凭证。

说明

用户凭证与实例访问密码相互独立:修改实例访问密码(elastic账号密码)后,已创建的凭证中保存的旧密码将鉴权失败,需删除后重新创建凭证。重置密码操作请参见重置实例访问密码。