试用合约体验链

我们提供了合约体验链方便您快速体验区块链功能。了解如何使用区块链完整服务，请参考 创建联盟。

注意：合约体验链仅供功能体验，请不要上传您的业务代码和数据。

前置条件

您已经开通阿里云 BaaS 服务，并登录阿里云。

• 如果使用阿里云账号，请 点击登录。
• 如果使用子账号，请 点此登录。

申请体验链权限

1. 登录 阿里云 BaaS 控制台。

2. 在 概览 页面，选择合约体验链，点击 免费试用。

3. 生成证书和密钥，并创建账户。BaaS 平台提供 自动生成密钥和证书 和 手动生成密钥和证书 两种方式。推荐使用安全、便捷的自动生成方式。

   • 若选择 自动生成，需要完成以下步骤：

     • 填写必要的申请信息，点击 申请。

     • 下载私钥和证书。

       提示：私钥只有一次下载机会，务必妥善保存，离开页面后不能再找回。

       

     • 点击 创建账户，使用 自动创建账户 方式。在账户创建申请弹窗中填写必要信息完成创建。

     • 下载私钥、公钥对及恢复私钥、恢复公钥对。

       提示：私钥和恢复私钥只有一次下载机会，务必妥善保存，离开此页面后不能再找回。

       

   • 若选择 手动生成，需要完成以下步骤：
     • 上传本地生成的证书请求文件 client.csr，点击 申请。本地生成私钥 client.key 和证书请求 client.csr 的具体步骤，参见本文 本地生成证书请求和公私钥对。
     • 点击 创建账户，使用 手动创建账户 方式，填写账户名，公钥及恢复公钥，点击 创建账户。本地生成公私钥对和恢复公私钥对的具体步骤，参见本文的 本地生成证书请求和公私钥对。

4. 证书、账户申请成功后，点击体验链右上角更多按钮 ··· 依次下载 SDK、下载根证书（trustCa）、下载根证书、下载签名证书，并将相应的组建和证书保存到本地，为后续合约链开发做准备。后续的合约链开发配置，参见 开发指南。

本地生成证书请求和公私钥对

使用 OpenSSL

安装 OpenSSL

在 Windows 操作系统中安装 OpenSSL 步骤如下：

1. 前往 OpenSSL 下载页面（英文），找到 1.0.2o 版本（推荐）并下载安装包，或点击下方下载链接：
   • 32 位的 OpenSSL 安装包（直接下载）
   • 64 位的 OpenSSL 安装包（直接下载）
2. 打开命令行工具，进入 OpenSSL 安装路径的 bin 目录。
3. 准备环境变量，在命令行中输入 set OPENSSL_CONF=openssl.cfg。

生成证书请求

使用 OpenSSL 制作私钥和证书请求。

    openssl req -newkey rsa:2048 -keyout key_pkcs10.pem -out csr.pem
    Generatinga 2048 bit RSA private key
    .........................................+++
    ..................................+++
    writingnew private key to 'key_pkcs10.pem'
    EnterPEM pass phrase:
    Verifying- Enter PEM pass phrase:
    -----

在该命令执行过程中，系统会要求您填写如下信息：

• Country Name (2 letter code)：使用国际标准组织（ISO）国码格式，填写 2 个字母的国家代号，如中国填写 CN。
• State or Province Name (full name)：省份，例如填写 Zhejiang。
• Locality Name (eg, city)：城市，例如填写 Hangzhou。
• Organization Name (eg, company)：组织单位，例如填写公司名的拼音。
• Organizational Unit Name (eg, section)：例如填写 IT Dept。
• Common Name (eg, your websites domain name)：进行 SSL 加密的网站域名。
  
  说明：

  • 这里并不是单指您的域名，而是直接使用 SSL 的网站名称，例如：pay.xxxx.com。
  • 不同的 URL 在这里被定义为不同的网站域名，例如：xxxx.com、www.xxxx.com、pay.xxxx.com 会被识别为 3 个不同的网站域名。
  • 这里的网站域名应该和邮件客户端软件设置的 SMTP/POP3 服务器名称一致。
• Email Address：邮件地址，选填。
• A challenge password：选填。
• An optional company name：选填。

使用本地密钥服务

为方便使用，BaaS 平台提供 Java 版本的本地密钥服务。

启动密钥服务

1. 准备 Java 运行环境，1.7 版本或以上。
2. 下载密钥生成工具（点击此处 下载）。
3. 运行命令 java -jar baas-crypto-tool-1.0.0.jar --server.port=8080 启动密钥服务。

生成证书请求

启动密钥服务之后，在浏览器中访问 http://localhost:8080/api/crypto/generateTlsKey?algo=rsa&isPkcs8=true&password=${password} 生成 tlskey.zip 文件包。解压该 .zip 包后得到 client.csr 和 client.key。其中，client.key 用于连接区块链，client.csr 需要通过 BaaS 平台界面来进行签名，参见 申请体验链权限 章节。

提示：将链接中的 ${password} 替换为您自己的密码。

生成公私钥对

启动密钥服务之后，在浏览器中访问 http://localhost:8080/api/crypto/generateUserKey?algo=ec&isPkcs8=true&password=${password} 生成 userkey.zip 文件包。解压该 .zip 包后得到 user.key 和 pub.txt。其中，user.key 为用户私钥，pub.txt 中的内容为用户公钥。

可以执行该命令两次，生成两个公私钥对，一个用做账户的公私钥对，另一个用做恢复该账户的公私钥对。