TW DIW 串接總覽
如果您的組織想在自己的服務中提供數位憑證的發證或驗證,把憑證發到持卡人的數位憑證皮夾(TW DIW,以下簡稱錢包),或讓持卡人用錢包出示憑證,可以透過台灣圖靈鏈股份有限公司提供的 TCS 服務串接。本手冊說明串接方式,以及上線前須了解的限制。
這份手冊給誰
Section titled “這份手冊給誰”- 決策者:評估是否串接的人。請依序閱讀本頁、運作方式、限制與注意事項與開始使用。這幾頁不說明 API 呼叫方式,只會出現少數狀態與識別碼,例如
pending(等待中)、cid(憑證識別碼)。 - 工程師:負責串接的人。先讀完運作方式與限制與注意事項,再從 API 基礎依序閱讀。代碼申請方式見開始使用。
數位憑證皮夾由數位發展部推出
Section titled “數位憑證皮夾由數位發展部推出”數位憑證皮夾是數位發展部推出的手機 app,英文名稱是 Taiwan Digital Identity Wallet(TW DIW)。持卡人把憑證存在錢包裡,需要時掃描 QR code 或點開手機連結,向要求出示的單位出示憑證。
您只需串接 TCS API for DIW
Section titled “您只需串接 TCS API for DIW”您的系統只需串接 TCS API for DIW,就能發證、驗證與撤銷。所需的憑證類型(VC Template)與驗證情境(VP Template)由 TCS 團隊建立,見開始使用。TCS 團隊會核發金鑰(API Key)給您的組織,您的系統呼叫 API 時,以此金鑰作為組織識別。與持卡人錢包之間的往來由 TCS 處理。
錢包上的驗證要求方與發證方只顯示台灣圖靈鏈股份有限公司
Section titled “錢包上的驗證要求方與發證方只顯示台灣圖靈鏈股份有限公司”錢包有兩處顯示台灣圖靈鏈股份有限公司,不是您的組織:
- 驗證時,錢包同意畫面上的驗證要求方。
- 發證時,憑證上的發證方。
台灣圖靈鏈股份有限公司的統一編號為 83588104。
如果您的服務要求這兩處顯示您的組織,透過 TCS 串接無法滿足此需求,請在決定串接前評估。卡面上的憑證名稱由您指定,卡面圖片也可以放您組織的品牌,見開始使用。
可使用的三項功能
Section titled “可使用的三項功能”- 發證:把您指定內容的憑證發到持卡人的錢包。
- 驗證:請持卡人出示憑證,您拿到憑證上的欄位與驗證結果。
- 撤銷:讓您發出的某一張憑證永久失效,無法恢復。
每個流程怎麼走,見運作方式。