BROPID TOOLS部署文档

部署流程

MySQL数据库初始化

请将压缩包目录下api/bropid-api-tools.sql脚本复制到MySQL软件，运行该脚本用于创建数据库。

首次启动

修改配置项

根据实际情况修改BROPIDTools\API目录下application.yml相应的配置项，其余配置项请不要修改，默认即可。

需要修改的项如下：

#钱包配置
wallet:
    #钱包名称-自定义名称
    mainWalletId: [wallet_name]
    #钱包密钥-用于访问钱包的密钥，限定8位字符
    mainWalletKey: [wallet_password]


#中间件配置
middleware:
    #中间件服务地址-中间件部署完成后的服务访问地址
    middlewareUrl: http://[ip]:[port]
    #中间件消息队列地址-中间件部署完成后的消息队列地址
    mq:
    #请根据实际使用的MQ类型修改以下配置，支持ApacheMq和AliyunMq    
        #选择apacheMQ队列必填
        mqTypeName: com.zccp.didbropidtools.mq.ApacheRocketMQConsumer
        rockmqUrl: [Apache MQ 请求地址]
        consumerGroup: [consumerGroup]
        topicName: [topicName 与中间件的api.mqTopic一致]

        #选择AliyunMQ队列必填
        #mqTypeName: com.zccp.didbropidtools.mq.AliYunRocketMQConsumer
        #accessKey: [阿里云队列accessKey]
        #secretKey: [阿里云队列secretKey]
        #onsAddress: [阿里云队列onsAddress]
        #topicName: [topicName 与中间件的api.mqTopic一致]
        #tag: [监听的tag]
        #consumerId: [监听的consumerId]

spring:
    #数据库配置-必须填写
    datasource:
        #数据库用户名-必须填写
        username: [username]
        #数据库密码-必须填写
        password: [password]
        #数据库地址-必须填写
        url: jdbc:mysql://[ip]:[port]/[database_name]?useUnicode=true&characterEncoding=utf8&useSSL=false&zeroDateTimeBehavior=convertToNull&serverTimezone=GMT%2b8
        driver-class-name: com.mysql.cj.jdbc.Driver

启动服务

java -jar did-bropid-tools-*.jar --spring.config.local=application.yml

完成cloud agency服务注册

step1：获取注册验证码

请联系络谱商务人员获取短信验证码用于下一步注册过程，热线电话：400-100-5498； 短信验证码的有效期为5分钟，所以请先准备好下一个步骤再申请短信验证码。

step2：http://register.brop.cn/register-ea

建议使用postman等http请求工具。

查看数据库wallet_content表数据的line_key列，此时应该只有三行数据，获取如下数据：

• did：前缀为did_的数据，例如did_did:brop:LuzWsHsV1XKnTSHBk85ydq，去除前缀保留did:brop:LuzWsHsV1XKnTSHBk85ydq部分；
• vk：前缀为cryptokey的数据，例如crypto_key_98F30F66D0D4F8E1A9B69B138DFA3D230BFE08CE4E13078A540CE13F0E55A617C4CF380B06CAEB6093EDFC2D4E2B786C3927DE15545A009141585D60D0FB0E5D，去除前缀保留98F30F66D0D4F8E1A9B69B138DFA3D230BFE08CE4E13078A540CE13F0E55A617C4CF380B06CAEB6093EDFC2D4E2B786C3927DE15545A009141585D60D0FB0E5D部分

  请求参数：
  {
    "phone": "13858054505", //手机号
    "verCode": "517378", //手机收到的验证码
    "did": "did:brop:LuzWsHsV1XKnTSHBk85ydq", //查看数据库获得
    "vk": "98F30F66D0D4F8E1A9B69B138DFA3D230BFE08CE4E13078A540CE13F0E55A617C4CF380B06CAEB6093EDFC2D4E2B786C3927DE15545A009141585D60D0FB0E5D", //查看数据库获得
    "type": 1 //默认不用变
  }
  

  请求回执：
  {
    "errCode": 0,
    "errMsg": "SUCCESS",
    "result": {
        "did": "did:brop:LuzWsHsV1XKnTSHBk85ydq",
        "vk": "98F30F66D0D4F8E1A9B69B138DFA3D230BFE08CE4E13078A540CE13F0E55A617C4CF380B06CAEB6093EDFC2D4E2B786C3927DE15545A009141585D60D0FB0E5D",
        "pairwiseDid": "did:brop:ZUlWsHsV1XKnTSHBk85ydq",
        "pairwiseVk": "AAAAAA66D0D4F8E1A9B69B138DFA3D230BFE08CE4E13078A540CE13F0E55A617C4CF380B06CAEB6093EDFC2D4E2B786C3927DE15545A009141585D60D0FB0E5D",
        "endpoint": "http://did-cloud-forward-service:8088/1/endpoint/xxxxxxx",
        "wsUrl": "ws://112.124.199.177:8899"
    }
  }
  

  第二次启动

  停止服务

  完成cloud agency注册后请停止服务。

  修改配置项

  根据cloud agency服务注册信息修改配置项，其它配置默认即可。

  #钱包配置
  ……
  agency:
    #cloud agency的did，数据来自agency注册信息中的pairwiseDid
    pairwiseDid: [cloud_agency_anonymous_did]
    #cloud agency的公钥，数据来自agency注册信息中的pairwiseVk
    pairwiseVk: [cloud_agency_anonymous_vk]
    #cloud agency的endpoint，数据来自agency注册信息中的endpoint
    endpoint: [cloud_agency_internal_endpoint]
  ……
  

  重新启动服务

  java -jar did-bropid-tools-*.jar --spring.config.local=application.yml
  

  至此工具的配置部署已完成。

  注册真名did

  部署完成后请调用BROPID Tool中真名身份创建接口注册真名did，默认一个控制台账户只能注册一个，请慎重调用，创建成功后请及时备份数据库，当前数据库中存放了密钥信息，一旦丢失将失去对链上真名did的控制。