點擊每頁的左下角
圖標可全屏播放。
「相信」整合開發流程
為您的系統打造一個標準、安全、高效的整合體驗
版本/日期:v2.2 / 2026-05-16
製作單位:中央授權中心 開發維運團隊
整合流程概覽
相較舊版(2022年前),新流程將「業務身份」與「應用程式身份」的申請與授權分離,職責更清晰。
①
申請頻道帳號
(行政人員)
→
②
申請 ClientID
(開發人員)
→
③
申請 API Scope
(開發人員)
→
④
ClientID 綁定頻道
(行政人員、開發人員)
↓
↓
②
使用平臺及應用中心
(行政人員)
→
⑥
聯系業務推廣
(行政人員)
←
⑤
系統開發與發佈
(開發人員)
階段一:身份申請 (業務 vs. 應用)
1. 申請頻道帳號
- 負責人員:行政窗口
- 目的:為您的「業務單位」取得相信單位賬號,用於後續的內容發佈與使用者互動。
- 分類:根據服務人員範圍類型可分訂閱臺、服務臺、廣播臺。
- 產出物:一組頻道帳號。
2. 申請 OIDC ClientID
- 負責人員:開發人員
- 目的:為您的「應用程式」接中央授權中心註冊一個合法的技術身份,以實現相信單點登錄、接口權限管控。
- 產出物:一組 Client ID / Secret。
- 參考文件:快速接入單點登入
階段二:客戶端授權
3. 申請 API Scope
- 負責人員:開發人員
- 目的:為您的ClientID申請具體操作 API 的權限,應遵循最小權限原則。
- 範例:為 ClientID 申請 `civet.api.msg` 權限,使其只能發送消息,不能操作其他 API。
- 參考文件:API資源交易配置說明
操作步驟說明
- 開發負責人前往「中央授權中心 - 開發中心」,選擇對應的客戶端,點擊「修改」進入「API資源」>>「API客戶端間授權(API交易)」介面,獲取 請求TOKEN 及 申請原因(模板)。
- 向 API 提供方提出 API Scope 申請時,需一併提供 客戶端ID、請求TOKEN 及 申請原因。
- 若申請「相信」相關的 API Scope,可直接透過「相信」將上述資訊發送給以下管理員進行辦理。
- 26520(王泰元)、F3218466(劉曉飛)、F3232041(邱喜威)
階段三:關聯頻道賬號
4. ClientID 與頻道帳號綁定
- 負責人員:由開發/行政人員發起申請,平台管理員執行操作。
- 目的:將「應用程式身份」與「業務單位身份」進行關聯,正式授權該程式代表此單位執行操作。
- 核心:完成此步驟後,您的程式才能用 ClientID 獲取代表頻道帳號的 Access Token。
操作步驟說明
- 開發負責人前往「中央授權中心 - 開發中心」,選擇對應的客戶端,點擊「修改」並進入「賬號關聯」設定介面。
- 點選「新增(頻道)賬號關聯」並輸入頻道賬號,生成綁定申請連結(系統會同步產出包含申請說明的郵件模板)。
- 開發負責人將該連結發送給頻道的管理人員(通常為行政人員)。
- 頻道管理人員點擊連結並同意授權,即可完成頻道賬號與客戶端的綁定手續。
階段四:開發系統、發佈
總結
流程總結:為何要這樣設計?
相較於過去的單一步驟,新的整合流程雖然更精細,但它帶來了三大好處:
1. 職責分離:行政管「業務身份」,開發管「應用身份」,權責分明。
2. 權限最小化:應用程式需明確申請 API Scope,無法再獲取超出其職責的權限。
3. 安全性與可追溯性:每一次 API 呼叫都能精確追溯到是哪個「應用程式」代表哪個「業務單位」進行的操作,大幅提升系統安全性。
相信全球化資料訪問權限
支持登錄用戶 / 訪問令牌範圍
類型
賬號格式
Headquarters (總部版)
工號
Indian (印度版)
工號@in-foxconn
Mexico (墨西哥版)
工號@mx-foxconn
US (美國版)
工號@us-foxconn
ITE (內測版)
工號@hh.com
Internal01 (產線版01)
工號@plieve
Internal02 (產線版02)
工號@a-plieve
開通說明
- 客戶端預設僅開通 總部版 (Headquarters) 的權限。
- 開發負責人可前往「中央授權中心 - 開發中心」,選擇對應客戶端並點擊「修改」,進入「客戶端詳情」介面以確認目前具備的權限範圍。
- 如需開通其他區域的版本權限,請透過「相信」直接聯繫以下管理員進行辦理:
- 26520(王泰元)、F3218466(劉曉飛)、F3232041(邱喜威)