區(qū)塊鏈應用平臺9BaaS的接入指南
九寬科技提供的區(qū)塊鏈服務( 9BaaS)利用區(qū)塊鏈技術的數據校驗、信息共享、快速傳輸、多方鑒證特點,為企業(yè)與企業(yè)之間訂制化搭建業(yè)務區(qū)塊鏈網絡應用。通過可信可靠的信息共享網絡,企業(yè)用戶間可達成多方參與、對等協(xié)作、智能協(xié)同、專業(yè)分工、價值分享等協(xié)作目標。其應用范圍涵括金融服務、供應鏈管理、醫(yī)療健康、慈善公益、文化及IP版權、社會管理、教育、共享經濟、智能制造等多種行業(yè)領域。
區(qū)塊鏈技術發(fā)展至今,已發(fā)展出Hyperledger Fabric、ETH、EOS、LedgerOne、BCOS、TrustSQL、Corda、EEA等不同區(qū)塊鏈公鏈和聯盟底層技術框架,但因其涉及密碼學、網絡傳輸、系統(tǒng)架構、共識算法、智能合約構建等復雜知識體系,學習曲線陡峭,且各種技術框架差異性也非常大,業(yè)務場景選型困難,成為了普通開發(fā)者擁抱區(qū)塊鏈技術的巨大門檻。
針對上述行業(yè)領域需求,九寬科技將推出多種的行業(yè)解決方案,提供訂制化區(qū)塊鏈網絡應用服務,讓普通開發(fā)者通過圖形化的后臺配置完成應用創(chuàng)建、自動化部署網絡、聯盟成員管理、智能合約管理等系列流程,輕松構建聯盟鏈網絡,并通過場景化的API訪問區(qū)塊鏈網絡,實現業(yè)務邏輯,讓用戶能夠拋開區(qū)塊鏈技術復雜度而專注到業(yè)務場景開發(fā)本身上來。
接入指南
1. 基本接入流程
9BaaS平臺是面向企業(yè)開發(fā)者的區(qū)塊鏈應用平臺,用戶可以按以下流程通過圖形化的后臺界面創(chuàng)建區(qū)塊鏈應用、自動化部署網絡環(huán)境、聯盟成員管理,極大的降低開發(fā)的難度。
流程分為申請應用的組織和受邀請的聯盟成員加入兩類,如下圖所示:
2. 注冊和組織認證
2.1 賬號注冊/登錄
點擊頂部導航右上角的注冊進入9BaaS平臺注冊頁面,根據提示頁面信息填寫表單完成9BaaS平臺賬號注冊。新注冊的用戶,將進入企業(yè)/組織認證頁面,9BaaS平臺需要通過提交的認證信息來驗證企業(yè)或組織的真實性。 若已注冊過9BaaS平臺賬號可以直接登錄。
2.2 企業(yè)/組織認證
9BaaS平臺暫僅開放企業(yè)和組織用戶,須要用戶填寫企業(yè)/組織信息和相關聯系人信息,以便9BaaS平臺核查真實性。
2.2.1填寫企業(yè)組織信息
企業(yè)全稱:按營業(yè)執(zhí)照上的企業(yè)全稱完整填寫,請勿使用簡稱或其他產品商標名等。
企業(yè)簡稱:簡稱是您在所有區(qū)塊鏈應用中的代號,其長度在4-64個字符之間,支持數字、英文字母大小寫。
企業(yè)規(guī)模:包含三個選項20人以下、20-100人、100人以上。
社會統(tǒng)一信用代碼:統(tǒng)一社會信用代碼是一組長度為18位的用于法人和其他組織身份識別的代碼。國家標準委發(fā)布了強制性國家標準《法人和其他組織統(tǒng)一社會信用代碼編碼規(guī)則》。該標準于2015年10月1日實施。
營業(yè)執(zhí)照:請?zhí)峁┳C件的原件照片或彩色掃描件(正副本均可),文字/蓋章清晰可辨認。格式要求 JPG、PNG,大小不超過2MB。
認證公函:請先下載《九寬區(qū)塊鏈服務平臺認證公函》,并仔細閱讀認證公函并填寫相關信息,在認證公函指定位置上蓋公司印章。
2.2.2 填寫聯系人信息
填寫聯系人相關信息,為方便認證過程中的信息確認及問題反饋。
3. 申請開通區(qū)塊鏈應用
新注冊9BaaS平臺的用戶提交企業(yè)認證信息后,可直接在控制臺頁面申請創(chuàng)建新的區(qū)塊鏈應用。
3.1. 申請創(chuàng)建新的區(qū)塊鏈應用
在控制臺頁面點擊“申請創(chuàng)建新的區(qū)塊鏈應用”選項的按鈕進入應用申請頁面。
業(yè)務場景:根據需求勾選相應的業(yè)務場景。
業(yè)務描述:請盡量詳細說明您的業(yè)務信息,以便9BaaS了解您的需求。
提交申請后,該應用將會處于“受理中”的狀態(tài), 請保持電話暢通,以便后續(xù)客服人員與您取得聯系。
3.2 創(chuàng)建區(qū)塊鏈應用
受理通過后,狀態(tài)變化為已受理,點擊“創(chuàng)建應用”按鈕繼續(xù)。
3.3 填寫應用名稱
按應用實際的業(yè)務信息填寫您的區(qū)塊鏈應用名稱。
在9BaaS平臺,應用名稱為您創(chuàng)建的區(qū)塊鏈網絡應用的唯一代號。
4. 自動化部署網絡
首次創(chuàng)建或加入的區(qū)塊鏈應用在控制臺頁面顯示為“尚未啟用網絡服務”的狀態(tài),點擊“部署”按鈕開始自動化部署流程。
4.1 獲取Access Key和Secret Key(簡稱:AK&SK)
點擊“獲取 AK&SK”的按鈕獲得您訪問區(qū)塊鏈網絡的Access Key和Secret Key
安全起見,須要校驗您的賬號密碼。
點擊下載按鈕將主網和測試網絡的AK&SK保存到本地,以便后續(xù)配置接口訪問使用。
4.2 等待網絡部署完成
自動化部署大概會花費您3到10分鐘時間,在此期間請耐心等待。
4.3 部署完成
自動化部署完成,之后您可以按引導進行業(yè)務接入。
控制面板:
基本信息:查看聯盟鏈應用的主網及測試網絡基本信息,管理聯盟成員。
數據監(jiān)控:監(jiān)控聯盟鏈網絡的關鍵指標數據。
鏈上數據查詢:通過時間查詢區(qū)塊及交易的詳細數據。
開發(fā)文檔:下載和更新SDK,查看聯盟鏈相關開發(fā)文檔。
申請組織接入聯盟鏈應用:
1.邀請組織加入聯盟鏈,協(xié)作開發(fā)。
2.前往開發(fā)文檔中心查閱文檔,配置聯盟鏈測試網絡,開始接入API。
3.通過9BaaS平臺聯盟鏈應用的API與聯盟成員一起協(xié)作完成業(yè)務開發(fā)。
4.與聯盟成員一起切換SDK主網配置,發(fā)布業(yè)務,主網上線。
受邀請組織接入聯盟鏈應用:
1.查看當前聯盟成員信息,協(xié)同開發(fā)。
2.前往開發(fā)文檔查閱開發(fā)文檔,配置聯盟鏈測試網絡,開始接入。
3.通過9BaaS平臺聯盟鏈應用的API與聯盟成員一起協(xié)作完成業(yè)務開發(fā)。
4.與聯盟成員一起切換SDK主網配置,發(fā)布業(yè)務,主網上線。
5. 聯盟成員管理
在區(qū)塊鏈應用的基本信息頁面,您可以邀請組織加入當前應用。
5.1 邀請新組織加入區(qū)塊鏈應用
點擊“邀請新組織”的按鈕,彈出邀請面板。根據面板提示填寫受邀請組織的聯系人郵箱。
邀請郵件發(fā)送成功后申請組織需通知對方在24小時內按照郵件鏈接完成注冊或登錄,否則鏈接將會失效。
5.2 審核申請加入的組織
邀請發(fā)出后,受邀組織將通過邀請郵件中引導步驟接受邀請。(詳情參見受邀請加入流程)
因聯盟鏈應用歸所有聯盟成員所有,受邀組織接受邀請后并未真正加入區(qū)塊鏈應用,新成員的加入需要通過所有聯盟成員的審核。
聯盟成員可以通過基本信息中點擊“查看申請列表”的按鈕查看最近想要加入的受邀組織。
聯盟成員審核采取一票否決制,受邀加入聯盟的組織申請狀態(tài)包含待審核、已通過、已拒絕三種。
待審核:通過操作項中的審核查看受邀組織信息及申請理由并可做出本組織的判斷。
已通過:所有聯盟成員同意受邀組織申請后,聯盟成員會新增此受邀組織。
已拒絕:任一聯盟成員拒絕受邀組織申請,則拒絕受邀組織加入聯盟。
通過聯盟成員審核的組織會顯示在聯盟成員列表,成員列表中組織狀態(tài)包括本組織和聯盟組織。
6. 加入區(qū)塊鏈應用
6.1 通過受邀請頁面注冊/登錄9BaaS平臺接受邀請
受邀請用戶收到邀請郵件后,按郵件提示打開邀請郵件當中的鏈接地址,訪問9BaaS平臺接受邀請的登錄/注冊頁面。
根據提示頁面信息填寫表單完成9BaaS平臺賬號注冊。新注冊的用戶,將進入企業(yè)/組織認證頁面,完成企業(yè)/組織認證。(詳情參見注冊和組織認證流程)
若已注冊過9BaaS平臺賬號的用戶可以直接在此頁面登錄接受邀請。
6.2 提交加入聯盟的申請
通過企業(yè)/組織認證后,在控制臺頁面可看到受邀請的區(qū)塊鏈應用。
點擊接受邀請進入申請加入應用面板,此面板顯示受邀請應用的基本信息,因為應用歸聯盟成員所有,所以受邀請者還需要在此寫明申請加入此應用的理由,聯盟成員審核時會根據您的申請理由來決定是否同意加入此區(qū)塊鏈應用。(理由默認填寫為邀請相關信息)
6.3 聯盟成員審核
提交加入的申請后需要先等待當前區(qū)塊鏈應用中聯盟成員的審核,聯盟所有成員同意后才能加入到區(qū)塊鏈應用中。