微程式用戶手冊
主頁
主頁
  • 釘釘整合設定

釘釘整合設定

微程式產品有兩種模式,通過安裝部署之後的設定文件區分:

與阿里雲合作:部署在阿里雲的專有云平臺。這種模式下,組織訊息來源於釘釘,所以需要有一個釘釘企業

**本地化部署:**本地化部署下,登入和文件儲存可以設定本地服務器,組織機構通過API接口傳入

本篇主要介紹的是專有云部署下,如何進行相關的基礎設定,確保用戶的後續正常使用。

除釘釘外目前平臺還支持企業微信整合。

注:僅系統自帶的超級管理員擁有權限進行基礎設定,系統管理員、子管理員、普通用戶可跳過此步驟

釘釘整合設定

微程式的組織機構同步於釘釘,同步前設定釘釘企業相關訊息

需在釘釘中自建應用,開通釘釘通訊錄的權限,並獲得應用訊息填寫在下方

1664417219520-7eb2f06b-c021-4750-bd82-3e84250d8caf.png

注:AppKey和AppSecret是釘釘企業微應用建立成功後自動產生的,AgentId是企業帳號的唯一識別ID,是企業帳號註冊成功後就產生的,這3個訊息需要從釘釘企業後臺獲得後回填到微程式,以實現微程式應用和釘釘的免密登入。

增量回調地址,用於釘釘組織架構變更後通過這個地址向微程式發送增量資料,若不設定則組織機構只能手動全量同步。增量回調地址是webapi地址加上後綴路徑組成,這裏只顯示的URL前半部分供查看,不支持手動修改。

具體操作步驟

以下以微程式平臺地址http://120.10.10.10/爲例說明整體設定過程

1、釘釘企業中建立應用

此項需釘釘企業管理員操作

登入釘釘管理後臺,進入工作臺-自建應用,新增應用。

釘釘後臺管理地址: https://oa.dingtalk.com/index.htm#/login

image
image

2、填寫應用的基本訊息,完成建立

1711976080223-1ab26dcc-7d11-492e-8026-eb5cf94f33bf.png

3、應用設定-建立網頁應用,設定訊息

1711976183951-c3906364-08f8-4470-81d3-d3ac7d94e909.png設定相關訊息:

  • 應用首頁連結:微程式系統行動端瀏覽地址, 格式爲:http://SERVER/mobile?corpId=$CORPID$&agentId=xxx,其中, XXX爲目前應用的AgentId,應用建立後獲得
  • 服務器出口IP:微程式系統的IP地址, 每個IP只能在一個企業中使用
    PC端首頁地址:微程式系統瀏覽PC端的地址, 格式:http://SERVER?corpId=$CORPID$&agentId=xxx
  • 管理後臺地址: 微程式系統瀏覽PC端的地址,格式:http://SERVER/admin

1726143394196-33d1ddfc-a6ed-4764-b243-c42cac22db3c.png

4、應用設定-權限設定

權限範圍:選擇全部

員工個人權限:開通所有權限

通訊錄管理:開通所有權限

1711976703738-d51b3dc9-7f86-4d06-85aa-3c046c6770ae.png

5、安全設定

服務企出口IP:企業的服務器IP

回調域名:從釘釘進入應用的免登設定,使用webapi地址+/login/dingtalk1711976674838-ab40ee7a-06df-435b-b86e-eb5a6e780534.png

6、應用發佈

建立新版本,發佈應用1711976755753-6c9b987a-b349-4c75-82c1-df112dd02f75.png

應用的狀態變爲“已上線”1711976771857-29455953-70b7-4bd1-9c56-b42b8b5e3da7.png

7、獲得釘釘整合的設定訊息

全部設定好後,釘釘企業用戶纔可以在微程式的登入頁面上釘釘掃碼登入微程式系統

1711977012068-24800a10-6bda-4977-8d82-bd008cc2492e.png

1、CorpID、SSOsecret:釘釘企業的唯一標識,獲得地址:工作臺-自建應用-開發訊息-開發帳號管理-企業自用帳號訊息

1711976921095-b535a7a0-ff3d-48f9-8116-289f2aa00dde.png

2、Agentld、AppKey、AppSecret

1712024311246-99d775c9-8082-4bd2-aee8-7dcc245dcc62.png

3、增量回調地址前綴:http://http://120.10.10.10/api

PC端首頁登入地址:http://120.10.10.10/

4、設定完成後點擊“確定”保存成功

整體設定完成後

  1. 微程式中可同步釘釘組織訊息(部門/人員/角色)
  2. 使用釘釘掃碼登入微程式平臺
  3. 使用釘釘企業中的用戶userid登入微程式平臺
  4. 釘釘工作臺通過設定的應用瀏覽 微程式平臺

更新: 2024-09-12 20:16:38
原文: https://www.yuque.com/skwme4/hyk0u0/zh2gs3