区块链应用平台9BaaS的接入指南

九宽科技提供的区块链服务（ 9BaaS）利用区块链技术的数据校验、信息共享、快速传输、多方鉴证特点，为企业与企业之间订制化搭建业务区块链网络应用。通过可信可靠的信息共享网络，企业用户间可达成多方参与、对等协作、智能协同、专业分工、价值分享等协作目标。其应用范围涵括金融服务、供应链管理、医疗健康、慈善公益、文化及IP版权、社会管理、教育、共享经济、智能制造等多种行业领域。

区块链技术发展至今，已发展出Hyperledger Fabric、ETH、EOS、LedgerOne、BCOS、TrustSQL、Corda、EEA等不同区块链公链和联盟底层技术框架，但因其涉及密码学、网络传输、系统架构、共识算法、智能合约构建等复杂知识体系，学习曲线陡峭，且各种技术框架差异性也非常大，业务场景选型困难，成为了普通开发者拥抱区块链技术的巨大门槛。

针对上述行业领域需求，九宽科技将推出多种的行业解决方案，提供订制化区块链网络应用服务，让普通开发者通过图形化的后台配置完成应用创建、自动化部署网络、联盟成员管理、智能合约管理等系列流程，轻松构建联盟链网络，并通过场景化的API访问区块链网络，实现业务逻辑，让用户能够抛开区块链技术复杂度而专注到业务场景开发本身上来。

接入指南

1. 基本接入流程

9BaaS平台是面向企业开发者的区块链应用平台，用户可以按以下流程通过图形化的后台界面创建区块链应用、自动化部署网络环境、联盟成员管理，极大的降低开发的难度。

流程分为申请应用的组织和受邀请的联盟成员加入两类，如下图所示：

2. 注册和组织认证

2.1 账号注册/登录

点击顶部导航右上角的注册进入9BaaS平台注册页面，根据提示页面信息填写表单完成9BaaS平台账号注册。新注册的用户，将进入企业/组织认证页面，9BaaS平台需要通过提交的认证信息来验证企业或组织的真实性。 若已注册过9BaaS平台账号可以直接登录。

2.2 企业/组织认证

9BaaS平台暂仅开放企业和组织用户，须要用户填写企业/组织信息和相关联系人信息，以便9BaaS平台核查真实性。

2.2.1填写企业组织信息

企业全称：按营业执照上的企业全称完整填写，请勿使用简称或其他产品商标名等。

企业简称：简称是您在所有区块链应用中的代号，其长度在4-64个字符之间，支持数字、英文字母大小写。

企业规模：包含三个选项20人以下、20-100人、100人以上。

社会统一信用代码：统一社会信用代码是一组长度为18位的用于法人和其他组织身份识别的代码。国家标准委发布了强制性国家标准《法人和其他组织统一社会信用代码编码规则》。该标准于2015年10月1日实施。

营业执照：请提供证件的原件照片或彩色扫描件（正副本均可），文字/盖章清晰可辨认。格式要求 JPG、PNG，大小不超过2MB。

认证公函：请先下载《九宽区块链服务平台认证公函》，并仔细阅读认证公函并填写相关信息，在认证公函指定位置上盖公司印章。

2.2.2 填写联系人信息

填写联系人相关信息，为方便认证过程中的信息确认及问题反馈。

3. 申请开通区块链应用

新注册9BaaS平台的用户提交企业认证信息后，可直接在控制台页面申请创建新的区块链应用。

3.1. 申请创建新的区块链应用

在控制台页面点击“申请创建新的区块链应用”选项的按钮进入应用申请页面。

业务场景：根据需求勾选相应的业务场景。

业务描述：请尽量详细说明您的业务信息，以便9BaaS了解您的需求。

提交申请后，该应用将会处于“受理中”的状态， 请保持电话畅通，以便后续客服人员与您取得联系。

3.2 创建区块链应用

受理通过后，状态变化为已受理，点击“创建应用”按钮继续。

3.3 填写应用名称

按应用实际的业务信息填写您的区块链应用名称。

在9BaaS平台，应用名称为您创建的区块链网络应用的唯一代号。

4. 自动化部署网络

首次创建或加入的区块链应用在控制台页面显示为“尚未启用网络服务”的状态，点击“部署”按钮开始自动化部署流程。

4.1 获取Access Key和Secret Key（简称：AK&SK）

点击“获取 AK&SK”的按钮获得您访问区块链网络的Access Key和Secret Key

安全起见，须要校验您的账号密码。

点击下载按钮将主网和测试网络的AK&SK保存到本地，以便后续配置接口访问使用。

4.2 等待网络部署完成

自动化部署大概会花费您3到10分钟时间，在此期间请耐心等待。

4.3 部署完成

自动化部署完成，之后您可以按引导进行业务接入。

控制面板：

基本信息：查看联盟链应用的主网及测试网络基本信息，管理联盟成员。

数据监控：监控联盟链网络的关键指标数据。

链上数据查询：通过时间查询区块及交易的详细数据。

开发文档：下载和更新SDK，查看联盟链相关开发文档。

申请组织接入联盟链应用：

1.邀请组织加入联盟链，协作开发。

2.前往开发文档中心查阅文档，配置联盟链测试网络，开始接入API。

3.通过9BaaS平台联盟链应用的API与联盟成员一起协作完成业务开发。

4.与联盟成员一起切换SDK主网配置，发布业务，主网上线。

受邀请组织接入联盟链应用：

1.查看当前联盟成员信息，协同开发。

2.前往开发文档查阅开发文档，配置联盟链测试网络，开始接入。

3.通过9BaaS平台联盟链应用的API与联盟成员一起协作完成业务开发。

4.与联盟成员一起切换SDK主网配置，发布业务，主网上线。

5. 联盟成员管理

在区块链应用的基本信息页面，您可以邀请组织加入当前应用。

5.1 邀请新组织加入区块链应用

点击“邀请新组织”的按钮，弹出邀请面板。根据面板提示填写受邀请组织的联系人邮箱。

邀请邮件发送成功后申请组织需通知对方在24小时内按照邮件链接完成注册或登录，否则链接将会失效。

5.2 审核申请加入的组织

邀请发出后，受邀组织将通过邀请邮件中引导步骤接受邀请。（详情参见受邀请加入流程）

因联盟链应用归所有联盟成员所有，受邀组织接受邀请后并未真正加入区块链应用，新成员的加入需要通过所有联盟成员的审核。

联盟成员可以通过基本信息中点击“查看申请列表”的按钮查看最近想要加入的受邀组织。

联盟成员审核采取一票否决制，受邀加入联盟的组织申请状态包含待审核、已通过、已拒绝三种。

待审核：通过操作项中的审核查看受邀组织信息及申请理由并可做出本组织的判断。

已通过：所有联盟成员同意受邀组织申请后，联盟成员会新增此受邀组织。

已拒绝：任一联盟成员拒绝受邀组织申请，则拒绝受邀组织加入联盟。

通过联盟成员审核的组织会显示在联盟成员列表，成员列表中组织状态包括本组织和联盟组织。

6. 加入区块链应用

6.1 通过受邀请页面注册/登录9BaaS平台接受邀请

受邀请用户收到邀请邮件后，按邮件提示打开邀请邮件当中的链接地址，访问9BaaS平台接受邀请的登录/注册页面。

根据提示页面信息填写表单完成9BaaS平台账号注册。新注册的用户，将进入企业/组织认证页面，完成企业/组织认证。（详情参见注册和组织认证流程）

若已注册过9BaaS平台账号的用户可以直接在此页面登录接受邀请。

6.2 提交加入联盟的申请

通过企业/组织认证后，在控制台页面可看到受邀请的区块链应用。

点击接受邀请进入申请加入应用面板，此面板显示受邀请应用的基本信息，因为应用归联盟成员所有，所以受邀请者还需要在此写明申请加入此应用的理由，联盟成员审核时会根据您的申请理由来决定是否同意加入此区块链应用。（理由默认填写为邀请相关信息）

6.3 联盟成员审核

提交加入的申请后需要先等待当前区块链应用中联盟成员的审核，联盟所有成员同意后才能加入到区块链应用中。