Hyperledger Aries Cloud Agent Python (ACA-Py) 使用教程
1. 项目介绍
Hyperledger Aries Cloud Agent Python (ACA-Py) 是一个用于构建去中心化身份应用和服务的基础框架。它主要运行在非移动设备环境中,支持 Verifiable Credential (VC) 生态系统,并使用 DIDComm 消息传递和 Hyperledger Aries 协议。ACA-Py 的核心功能包括发行、验证和持有可验证凭证,支持 Hyperledger AnonCreds 和 W3C 标准的 Verifiable Credential 数据模型。
2. 项目快速启动
2.1 安装
首先,确保你已经安装了 Docker。然后,使用以下命令从 GitHub 克隆项目:
git clone https://github.com/hyperledger/aries-cloudagent-python.git
cd aries-cloudagent-python
2.2 运行 ACA-Py
使用 Docker 运行 ACA-Py 的命令如下:
./scripts/run_docker start --inbound-transport http 0.0.0.0 8000 --outbound-transport http
2.3 配置
ACA-Py 可以通过命令行参数、环境变量或 YAML 文件进行配置。以下是一些常用的命令行参数:
aca-py start --admin 0.0.0.0 8001 --admin-insecure-mode --inbound-transport http 0.0.0.0 8000 --outbound-transport http --wallet-type indy --wallet-name my_wallet --wallet-key my_wallet_key
3. 应用案例和最佳实践
3.1 应用案例
- 企业钱包:ACA-Py 可以作为企业钱包,用于持有和展示企业的可验证凭证。
- 身份验证服务:基于可验证凭证的展示,ACA-Py 可以构建身份验证服务。
- 物联网设备:ACA-Py 可以嵌入到物联网设备中,用于发行关于收集数据的可验证凭证。
3.2 最佳实践
- 多租户支持:ACA-Py 支持多租户场景,允许一个 ACA-Py 实例管理多个租户的独立存储。
- 中介服务:ACA-Py 可以作为 Aries 中介运行,接收、存储并转发消息给其他 Aries 代理。
- 安全配置:在生产环境中,务必使用
--admin-api-key
参数保护管理 API,避免使用--admin-insecure-mode
。
4. 典型生态项目
4.1 Hyperledger Indy
Hyperledger Indy 是一个专门用于去中心化身份管理的分布式账本技术。ACA-Py 与 Indy 紧密集成,支持 Indy 的 AnonCreds 凭证格式。
4.2 Hyperledger Aries
Hyperledger Aries 是一个用于构建去中心化身份解决方案的框架,支持 DIDComm 消息传递协议。ACA-Py 是 Aries 框架的一部分,提供了 Python 实现的云代理。
4.3 Hyperledger Ursa
Hyperledger Ursa 是一个加密库集合,提供了多种加密算法和协议的实现。ACA-Py 使用 Ursa 来增强其加密功能和安全性。
通过以上内容,你可以快速了解并开始使用 Hyperledger Aries Cloud Agent Python (ACA-Py) 项目。