用户凭证用于以管理员账号安全地访问Elasticsearch实例,凭证密码经阿里云密钥管理服务(KMS)加密存储。Elasticsearch 智能助手的数据洞察、ES原生接口调用等场景可引用用户凭证完成鉴权,无需在调用方保存明文密码。本文介绍如何创建、设置默认与删除用户凭证。
背景信息
访问Elasticsearch实例需要携带访问账号与密码。为避免在应用代码、脚本或第三方工具中硬编码密码,您可以将账号密码创建为用户凭证,由阿里云服务端加密保存;调用方只需引用凭证名称即可完成鉴权。调用ES原生接口未显式指定凭证时,将自动使用实例的默认凭证。
-
凭证密码仅加密存储在阿里云服务端,不会展示给任何第三方组件,也不会出现在聊天记录、模型输入、日志或URL中。
-
每个实例仅允许一条默认凭证。将某条凭证设为默认后,原默认凭证自动取消默认。
-
凭证关联实例的ES账号权限:凭证可访问的索引范围与操作类型,由创建凭证时所用账号的权限决定,凭证本身不额外赋权。
创建用户凭证
-
在左侧导航栏选择Elasticsearch实例,单击目标实例ID进入实例详情页。
-
在左侧导航栏单击安全配置,在用户凭证管理区域单击新建凭证。
-
在新建凭证对话框配置以下参数,然后单击确定。
参数
说明
目标实例
凭证所属的实例,自动展示当前实例ID、版本与地域,不可修改。
凭证名称
凭证的名称,用于在凭证列表与调用方区分不同凭证,最长128个字符,可不填。
账号
访问实例使用的ES账号,如
elastic。凭证可访问的索引与操作范围由该账号的权限决定。密码
该账号的访问密码。要求8~30位,且包含大写字母、小写字母、数字、特殊字符中的至少三类。密码提交后经阿里云密钥管理服务加密存储。
默认凭证
开启后该凭证成为实例的默认凭证,调用未指定凭证时自动使用。实例内仅一条默认凭证。
创建完成后,凭证展示在用户凭证管理列表,可查看凭证名称、凭证类型(当前为基础认证)、用户名与创建时间。
设置默认与删除凭证
-
设为默认:在凭证列表的操作列单击后确认,原默认凭证自动取消默认。
-
删除:删除后,使用该凭证的调用将立即失败。删除前请确认没有正在引用该凭证的任务或应用;删除默认凭证后,未指定凭证的调用将因无默认凭证而失败,需重新设置默认凭证。
使用场景
-
Elasticsearch 智能助手数据洞察:在智能助手对话中查询或写入索引业务数据时,在上下文信息卡的凭证中选择用户凭证建立数据访问会话,无需在对话中输入密码。详情请参见使用 Elasticsearch 智能助手的「数据洞察」章节。
-
ES原生接口调用:调用ES原生接口未显式指定凭证时,自动使用实例的默认凭证。
用户凭证与实例访问密码相互独立:修改实例访问密码(elastic账号密码)后,已创建的凭证中保存的旧密码将鉴权失败,需删除后重新创建凭证。重置密码操作请参见重置实例访问密码。