注册
达梦wallet基础配置与学习
技术分享/ 文章详情 /

达梦wallet基础配置与学习

キミの笑顔 2026/10/30 183 0 0

1、wallet描述

Wallet(钱包) 是达梦数据库提供的一种凭据外部加密存储机制,用于将数据库登录的用户名和密码以加密形式存储在独立文件中,避免在脚本或命令行中明文暴露口令。
项目	说明
文件名	dmwallet.prikey(加密文件)
管理工具	dmmkstore(位于 DM 安装目录 bin/ 下)
凭据格式	每个凭据包含 3 个条目:服务名、用户名、密码
文件大小	最大 64MB
加密算法	默认 DESEDE_CFB,可指定 AES256_CFB 等
哈希算法	默认 SHA512

2、核心工具dmmkstore

2.1、基本概念

dmmkstore 是达梦数据库的密码管理工具,系统管理员通过它创建、访问或修改 wallet 文件。基本语法格式:
语法:
dmmkstore -wrl <wallet_location> {keyword [<value>]}

规则:
1)-wrl:指定 wallet 文件路径(必须作为第一个参数)
2)keyword:参数关键字,不区分大小写,多个参数间用空格间隔
3)<value>:参数取值

2.2、详细参数

2.1.1、-create创建文件

语法:
dmmkstore -wrl <wallet_location> -create

规则:
1)创建时需设置 wallet 文件密码,长度 9~48 位,必须同时包含大写字母、小写字母、数字、特殊字符
2)成功后在指定路径生成加密的 dmwallet.prikey 文件
3)若路径已存在 dmwallet.prikey 则报错

2.1.2、-createCredential创建凭证

语法:
dmmkstore -wrl <wallet_location> -createCredential <server_name> <username> <password>

规则:
1)若 wallet 中已存在同名服务凭据,则报错
2)wallet 文件最大 64MB,超出则报错
3)支持交互式输入密码:未显式输入密码时会交互提示,避免明文暴露
4)修改 wallet 前系统自动生成 dmwallet.prikey.bak 备份;成功后自动删除,失败时可手动恢复
参数	说明
<server_name>	服务名,必须与 dm_svc.conf 中配置的服务名相匹配
<username>	用户名
<password>	密码

2.1.3、-modifyCredential修改凭证

语法:
dmmkstore -wrl <wallet_location> -modifyCredential <server_name> <username> <password>

规则:
1)若不存在该服务名的凭据,则报错
2)支持交互式输入密码

参数 说明
<server_name>  待修改凭据的服务名
<username>     修改后的用户名
<password>     修改后的密码

2.1.4、-deleteCredential删除凭证

语法:
dmmkstore -wrl <wallet_location> -deleteCredential <server_name>

规则:
1)若不存在该服务名的凭据,则报错。

2.1.5、-list查看所有条目别名

语法:
dmmkstore -wrl <wallet_location> -list

条目	别名
服务名	DM.security.client.connect_string%d
用户名	DM.security.client.username%d
密码	DM.security.client.password%d
%d	指的是凭证序号,从1开始

2.1.6、-viewEntry查看条目具体值

语法:
dmmkstore -wrl <wallet_location> -viewEntry <alias>

说明:
1)<alias>:条目别名,不区分大小写
2)若指定条目为密码,将以明文显示
3)若条目不存在,则报错

2.1.7、-modifyEntry修改指定条目值

语法:
dmmkstore -wrl <wallet_location> -modifyEntry <alias> <value>

说明:
1)<alias>:条目别名,不区分大小写
2)<value>:修改后的值
3)若条目不存在,则报错

2.1.8、-cipherName设置加密算法

语法:
dmmkstore -wrl <wallet_location> -cipherName <cipher_name> -create

规则:
1)默认使用 DESEDE_CFB 加密算法
2)必须与 -create 一起使用,且 -cipherName 必须位于 -create 前面
3)算法名不能包含 NOPAD 或 EXTKEY,否则报错

2.1.9、-hashName设置hash算法

语法:
dmmkstore -wrl <wallet_location> -hashName <hash_name> -create

规则:
1)默认使用 SHA512 杂凑算法
2)必须与 -create 一起使用,且 -hashName 必须位于 -create 前面

2.1.10、-help查看帮助信息

dmmkstore -help

image.png

3、核心应用

3.1、核心配置

-- DM_SVC.CONF
使用 wallet 登录数据库前,需在 dm_svc.conf`中完成两项配置:
1)全局配置项WALLET_LOCATION:指定 wallet 文件所在路径
2)服务名配置:配置服务名对应的数据库连接地址(IP 和 PORT)

规则:
1)WALLET_LOCATION仅支持全局配置,不支持在服务名下配置
2)仅当 WALLET_LOCATION 非空时,才可通过 wallet 文件登录数据库
3)-createCredential 中的 server_name 必须与 dm_svc.conf 中的服务名一致
4)客户端通过用户输入的服务名以及 WALLET_LOCATION 指定的路径,自动从 wallet 文件中获取对应凭据
5)若用户同时输入了用户名和密码,则优先使用用户输入的进行登录

image.png

3.2、disql免密登陆

3.2.1、配置目录及文件创建

-- 创建wallet
mkdir /home/dmdba/dmdbms_26_q2_pack16/bin/wallet

-- create创建,密码:Wallet_123
./dmmkstore -wrl /home/dmdba/dmdbms_26_q2_pack16/bin/wallet -create

image.png

3.2.2、创建凭证

./dmmkstore -wrl /home/dmdba/dmdbms_26_q2_pack16/bin/wallet  -createCredential dm_test01 SYSDBA ********

image.png

3.2.3、配置dm_svc.conf

image.png

3.2.4、验证登陆

注意:disql、dimp、dexp、dmfldr使用方式一样,不重复描述
-- disql登陆
./disql /@dm_test01

image.png

3.3、DMAP的wallet配置

3.3.1、创建凭证

注意:由于已经创建wallet,这里只需要创建对应服务凭证

-- 创建dmap凭证,密码自定义
./dmmkstore -wrl /home/dmdba/dmdbms_26_q2_pack16/bin/wallet -createCredential dmap_service dmap_user ******

注意:ap的服务名是dmap_service

image.png

3.3.2、配置dmap.ini及DM.INI

-- dmap.ini添加wallet目录
AP_WALLET_LOCATION = /home/dmdba/dmdbms_26_q2_pack16/bin/wallet

-- dm.ini

image.png

3.3.3、重启启动DMAP

image.png

3.3.4、重启数据库

image.png

3.4.5、取消AP WALLET配置

image.png

4、常见问题

4.1、创建 wallet 时报口令不符合要求

原因:口令长度不在 9~48 位范围,或未同时包含大写字母、小写字母、数字、特殊字符。
解决:确保口令满足全部四类字符要求。例如:Wallet_123(含大写 W、小写 allet、数字 123、特殊字符 _)。

4.2、使用 /@服务名 登录失败

排查步骤:
检查 dm_svc.conf 中 WALLET_LOCATION 是否已配置且非空
检查 dm_svc.conf 中是否配置了对应的服务名及 IP:PORT
检查 wallet 中是否创建了该服务名的凭据(-listCredential 确认)
检查 wallet 中的服务名与 dm_svc.conf 中的服务名是否完全一致
检查 wallet 文件路径是否正确、文件是否存在

4.3、监视器 wallet 登录报错(错误码 -29)

原因:MON_WALLET_LOCATION 为空,或该路径下没有合法的 wallet 文件。
解决:
确认 dmmonitor.ini 中 MON_WALLET_LOCATION 已配置且路径正确
确认该路径下存在合法的 dmwallet.prikey 文件
确认 wallet 中已创建对应服务名的凭据
确认系统中至少有一个活动库(校验需要)

4.4、-createCredential 时报服务名已存在

原因:wallet 中已存在相同服务名的凭据。
解决:先使用 -deleteCredential 删除旧凭据,或使用 -modifyCredential 直接修改。

4.5、wallet 文件损坏如何恢复

原因:修改 wallet 过程中发生错误导致文件损坏。
解决:系统在修改前自动生成 dmwallet.prikey.bak 备份文件。若修改失败,手动将 .bak 文件重命名为 dmwallet.prikey 即可恢复。

4.6、-cipherName指定加密算法报错

原因:
指定的不是有效的加密算法名称
算法名称中包含 NOPAD 或 EXTKEY
-cipherName 未与 -create 一起使用,或位置不对

解决:确保 -cipherName 位于 -create 前面,且算法名合法(如 AES256_CFB、DESEDE_CFB)。
评论
后发表回复

作者

文章

阅读量

获赞

扫一扫
联系客服