
在hyperledger indy分布式账本中,去中心化标识符(did)是核心概念,用于代表实体(如个人、组织或设备)的身份。为了管理这些实体的权限和在网络中的作用,indy引入了“角色”(role)的概念。常见的角色包括trust_anchor(信任锚)、steward(管理员)、endorser(背书人)等。这些角色赋予了did在账本上执行特定操作的权限,例如trust_anchor通常拥有将其他did写入账本的权限。
分配DID角色在将DID写入Indy账本时,通常会为其分配一个初始角色。例如,创建一个TRUST_ANCHOR角色的DID,可以通过Indy Python SDK的ledger.build_nym_request方法来构建一个Nym事务请求。
以下代码示例展示了如何为新生成的DID分配TRUST_ANCHOR角色:
import json
import pprint
from indy import ledger, pool, wallet # 假设已导入必要的indy模块
# 假设 pool_handle, wallet_handle, user.steward_did, actor_did, actor_verkey 已初始化
async def assign_trust_anchor_role(pool_handle, wallet_handle, steward_did, target_did, target_verkey):
"""
为目标DID分配TRUST_ANCHOR角色。
"""
print('\n构建NYM请求以将Trust Anchor添加到账本\n')
nym_transaction_request = await ledger.build_nym_request(
submitter_did=steward_did, # 提交请求的DID,通常是拥有足够权限的Steward
target_did=target_did, # 目标DID
ver_key=target_verkey, # 目标DID的验证密钥
alias=None,
role='TRUST_ANCHOR' # 分配TRUST_ANCHOR角色
)
print('NYM事务请求: ')
pprint.pprint(json.loads(nym_transaction_request))
print('\n发送NYM请求到账本\n')
nym_transaction_response = await ledger.sign_and_submit_request(
pool_handle=pool_handle,
wallet_handle=wallet_handle,
submitter_did=steward_did,
request_json=nym_transaction_request
)
print('NYM事务响应: ')
pprint.pprint(json.loads(nym_transaction_response))
return nym_transaction_response
# 示例调用 (需要替换为实际的句柄和DID)
# await assign_trust_anchor_role(pool_handle, wallet_handle, user.steward_did, actor_did, actor_verkey) 在这个过程中,submitter_did必须是一个拥有足够权限(例如STEWARD角色)的DID,才能成功提交更改DID角色的事务。
撤销或降级DID角色有时,出于安全考虑或权限管理需求,我们需要撤销或降级一个DID已有的角色,例如将一个TRUST_ANCHOR的权限移除。Hyperledger Indy的设计允许通过提交一个新的Nym事务来更新DID的角色,包括将其角色设置为空。
撤销DID角色的核心方法是再次使用ledger.build_nym_request,但将role参数设置为空字符串('')。这表示目标DID不再拥有任何特定的角色,从而有效地移除了其之前分配的权限。
以下代码示例展示了如何撤销一个DID的现有角色:
PIA
全面的AI聚合平台,一站式访问所有顶级AI模型
226
查看详情
import json
import pprint
from indy import ledger, pool, wallet # 假设已导入必要的indy模块
# 假设 pool_handle, wallet_handle, user.steward_did, actor_did 已初始化
# 注意:撤销角色时,ver_key参数是可选的,但为了保持与构建请求的API一致性,可以继续提供。
async def demote_did_role(pool_handle, wallet_handle, steward_did, target_did, target_verkey=None):
"""
撤销目标DID的现有角色。
"""
print('\n构建NYM请求以撤销DID角色\n')
# 关键步骤:将role参数设置为空字符串
nym_transaction_request = await ledger.build_nym_request(
submitter_did=steward_did,
target_did=target_did,
ver_key=target_verkey, # 可以是None,如果不需要更新verkey
alias=None,
role='' # 设置为空字符串以撤销角色
)
print('NYM事务请求: ')
pprint.pprint(json.loads(nym_transaction_request))
print('\n发送NYM请求到账本\n')
nym_transaction_response = await ledger.sign_and_submit_request(
pool_handle=pool_handle,
wallet_handle=wallet_handle,
submitter_did=steward_did,
request_json=nym_transaction_request
)
print('NYM事务响应: ')
pprint.pprint(json.loads(nym_transaction_response))
return nym_transaction_response
# 示例调用 (需要替换为实际的句柄和DID)
# await demote_did_role(pool_handle, wallet_handle, user.steward_did, actor_did, actor_verkey) 当这个事务被成功提交并写入账本后,目标DID的最新Nym事务记录将显示其role字段为空,这意味着它不再拥有之前分配的任何特殊权限。
提交事务到账本无论是分配角色还是撤销角色,最终都需要通过ledger.sign_and_submit_request方法将构建好的Nym事务请求签名并发送到Indy账本。这一步是确保事务被网络验证并持久化记录的关键。提交者(submitter_did)必须拥有执行此类操作的权限,通常是STEWARD角色。
验证角色降级在成功提交撤销角色的请求后,可以通过查询账本上的Nym事务来验证目标DID的角色是否已被移除。账本上的最新Nym事务将显示该DID的role字段为空。这意味着该DID不再具有之前分配的特权,例如TRUST_ANCHOR的权限。
注意事项- 提交者权限: 只有拥有足够权限的DID(例如STEWARD)才能提交修改其他DID角色的Nym事务。如果提交者权限不足,事务将被节点拒绝。
- 角色更新而非删除: 将role设置为空字符串并不会删除DID本身,它仅仅是更新了DID在账本上的角色属性。该DID仍然存在,但不再拥有特殊权限。
- 不可逆性(当前事务): 一旦角色被移除,如果需要恢复该DID的特定角色,必须再次提交一个带有相应角色(例如TRUST_ANCHOR)的Nym请求。
- AUTH_RULES: Hyperledger Indy Node的AUTH_RULES文档详细定义了不同角色对不同事务类型(包括Nym事务)的操作权限。理解这些规则对于有效管理DID权限至关重要。
通过Indy Python SDK,我们可以灵活地管理Hyperledger Indy网络中DID的权限。通过将ledger.build_nym_request方法的role参数设置为空字符串,可以有效地撤销或降级DID的现有角色,实现对去中心化身份权限的精细化控制。这一机制是维护Indy账本安全性和合规性的重要组成部分。
以上就是Hyperledger Indy中DID角色降级与管理实践的详细内容,更多请关注知识资源分享宝库其它相关文章!
相关标签: python js json node edge ai Python 分布式 标识符 字符串 并发 大家都在看: Python怎么获取CPU核心数_os与multiprocessing获取CPU核心数 python人马兽系列 python人马兽系列的主要内容 Python怎么创建虚拟环境_Python虚拟环境创建与管理教程 python如何计算列表的长度_python使用len()函数获取列表长度 python怎么判断一个变量的类型_python变量类型判断方法






发表评论:
◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。