通義靈碼釘釘集成配置詳細(xì)教程
釘釘集成支持同步釘釘通訊錄到企業(yè)的用戶管理，同時(shí)支持釘釘?shù)膯吸c(diǎn)登錄、消息通知。本文介紹通過釘釘?shù)卿浶薷耐x靈碼的相關(guān)功能。
|
適用版本 |
專屬版 |
前提條件
服務(wù)器出口 IP：需提供企業(yè)實(shí)例的對(duì)外IP地址（專屬版用戶請(qǐng)聯(lián)系技術(shù)支持獲?。?。
流程概覽
釘釘集成配置
步驟一 創(chuàng)建釘釘集成
企業(yè)管理員可以在企業(yè)管理 > 第三方集成創(chuàng)建釘釘集成。如果需要?jiǎng)?chuàng)建不在釘釘同步范圍的用戶，可以勾選支持內(nèi)建用戶，以創(chuàng)建同步范圍外的用戶。
步驟二 創(chuàng)建釘釘應(yīng)用
-
需要在釘釘開放平臺(tái)上創(chuàng)建企業(yè)內(nèi)部應(yīng)用，可參考查看如何創(chuàng)建內(nèi)部應(yīng)用。也可按照下方提示填寫創(chuàng)建企業(yè)內(nèi)部應(yīng)用表單信息，然后單擊確定創(chuàng)建，需注意：
-
應(yīng)用類型：選擇小程序。
-
開發(fā)方式：選擇企業(yè)自主開發(fā)。
-
應(yīng)用圖標(biāo)：選擇您需要得應(yīng)用圖標(biāo)。
-
-
其次，在左側(cè)導(dǎo)航欄選擇開發(fā)管理，填寫服務(wù)器出口 IP。
-
在左側(cè)導(dǎo)航欄選擇應(yīng)用信息，記錄關(guān)鍵憑證：
-
Corpid（企業(yè)ID）
-
AppKey/AppSecret
-
AgentId
-
-
將上一步的信息填寫到下圖的表單中，填寫完成后單擊下一步。
步驟三 配置應(yīng)用權(quán)限
-
通義靈碼需要獲取釘釘?shù)南鄳?yīng)權(quán)限，才能夠同步釘釘通訊錄、通過釘釘?shù)卿浕蛲扑歪斸斚⑼ㄖ?，所需?quán)限如下圖所示。 進(jìn)入釘釘開放平臺(tái)，在步驟一中已創(chuàng)建的組織內(nèi)部應(yīng)用詳情頁面 > 權(quán)限管理中配置權(quán)限，如果需要限制釘釘通訊錄同步的用戶范圍，請(qǐng)配置權(quán)限范圍。
-
在釘釘開放平臺(tái)配置完成后，回到通義靈碼釘釘集成配置頁面，單擊下一步。
步驟四 賬號(hào)綁定和屬性映射
-
賬號(hào)綁定方式：自動(dòng)綁定郵箱相同的用戶，通義靈碼將按照同步策略，自動(dòng)將通義靈碼上、釘釘組織中郵箱賬號(hào)相同的用戶綁定在一起。
-
通義靈碼將按照下圖中字段映射關(guān)系，自動(dòng)將釘釘?shù)挠脩粜畔⑴c通義靈碼中的用戶信息，按照同步策略進(jìn)行映射同步，目前暫不支持修改字段映射關(guān)系，確認(rèn)后單擊下一步。
步驟五 開啟功能服務(wù)
目前提供四種功能服務(wù)：在配置過程中默認(rèn)關(guān)閉。如果在未開啟功能的情況下保存釘釘集成配置，后續(xù)可以在釘釘集成詳情頁面中開啟相應(yīng)的功能服務(wù)。
-
用戶和組織同步：啟用后，通義靈碼用戶管理與釘釘通訊錄保持同步，請(qǐng)確認(rèn)釘釘應(yīng)用的可見權(quán)限范圍。
-
單點(diǎn)登錄：啟用后，可在通義靈碼登錄頁面快速跳轉(zhuǎn)至釘釘?shù)卿?，通過釘釘訪問通義靈碼。
-
消息通知：啟用后，支持釘釘消息通知，通義靈碼內(nèi)的消息訂閱功能可通知用戶。
-
釘釘工作臺(tái)訪問通義靈碼：啟用后，可在釘釘工作臺(tái)直接打開通義靈碼網(wǎng)頁。
當(dāng)完成所有配置后，單擊保存配置按鈕即可完成釘釘集成的配置，該服務(wù)配置后續(xù)可進(jìn)行修改。
功能使用說明
用戶組織同步策略
開啟釘釘?shù)挠脩艉徒M織同步
當(dāng)通義靈碼上未開啟其他第三方的用戶和組織同步功能時(shí)，可以配置釘釘?shù)挠脩艉徒M織同步，支持配置同步時(shí)機(jī)、用戶差異處理、組織差異處理的規(guī)則。
|
|
|
|
場(chǎng)景選項(xiàng) |
影響結(jié)果 |
|
數(shù)據(jù)同步時(shí)機(jī) |
說明
手動(dòng)同步建議每次操作間隔 1 個(gè)小時(shí)以上。 |
|
用戶差異處理：默認(rèn)忽略通義靈碼中多余的賬號(hào)，并為同步范圍內(nèi)的釘釘賬號(hào)創(chuàng)建并綁定通義靈碼賬號(hào)。 |
已有通義靈碼賬號(hào)未匹配到釘釘賬號(hào)：
|
|
已有釘釘賬號(hào)未匹配到通義靈碼賬號(hào)：
|
|
|
組織差異處理：默認(rèn)忽略通義靈碼中多余的部門節(jié)點(diǎn)，并為同步范圍內(nèi)的釘釘部門節(jié)點(diǎn)創(chuàng)建并綁定通義靈碼部門。 |
已有通義靈碼部門未匹配到釘釘部門：
|
|
已有釘釘部門未匹配到通義靈碼部門：
|
查看用戶和組織同步結(jié)果
在開啟用戶和組織同步的情況下，打開釘釘集成詳情頁面，可以查看最新同步結(jié)果：未執(zhí)行同步、同步成功、同步失敗、部分同步成功。
當(dāng)同步過程中發(fā)生了同步失敗情況，可參考釘釘開放平臺(tái)API 調(diào)用錯(cuò)誤碼，排查同步失敗的原因。
單點(diǎn)登錄配置
開啟單點(diǎn)登錄
打開單點(diǎn)登錄的開關(guān)后，需要將通義靈碼的回調(diào)地址配置在第一步創(chuàng)建的釘釘應(yīng)用的應(yīng)用詳情 > 安全設(shè)置 > 重定向 URL的輸入框，即可完成釘釘單點(diǎn)登錄的配置。
通過釘釘?shù)卿?/b>通義靈碼
開啟單點(diǎn)登錄后，通義靈碼登錄頁面將顯示釘釘?shù)卿浫肟?，點(diǎn)擊后可進(jìn)入釘釘?shù)卿涰撁?，已綁定釘釘賬號(hào)的用戶可以通過釘釘?shù)卿浲x靈碼。
開啟消息通知
在開啟用戶和組織同步或單點(diǎn)登錄的情況下，可開啟釘釘?shù)南⑼ㄖδ?，同時(shí)需要完善釘釘應(yīng)用中的機(jī)器人配置信息。
釘釘工作臺(tái)訪問配置
如果需要通過釘釘 PC 客戶端的工作臺(tái)訪問通義靈碼，可打開釘釘工作臺(tái)訪問通義靈碼的開關(guān)，同時(shí)將通義靈碼網(wǎng)頁地址粘貼到第一步創(chuàng)建的釘釘應(yīng)用的應(yīng)用詳情 > 開發(fā)管理 > PC 端首頁地址的輸入框中。
功能的修改與移除
功能修改/關(guān)閉
在釘釘集成詳情頁中，如果開啟了某個(gè)功能服務(wù)，可以看到修改服務(wù)配置的按鈕，點(diǎn)擊后即可進(jìn)行相關(guān)功能服務(wù)配置的修改或者關(guān)閉該功能。
-
修改服務(wù)：可按需調(diào)整。
-
關(guān)閉服務(wù)：功能使用會(huì)有影響，具體請(qǐng)參見下表。
功能
影響結(jié)果
用戶和組織同步
-
不解除通義靈碼賬號(hào)與釘釘賬號(hào)的綁定關(guān)系。
-
不再執(zhí)行釘釘通訊錄的用戶和組織同步。
單點(diǎn)登錄
-
不會(huì)解除通義靈碼賬號(hào)與釘釘賬號(hào)的綁定關(guān)系。
-
不支持通過釘釘賬號(hào)登錄通義靈碼，用戶若需要登錄通義靈碼，可使用通義靈碼的登錄賬號(hào)和密碼進(jìn)行登錄。
消息通知
-
如果同時(shí)關(guān)閉了用戶和組織同步、單點(diǎn)登錄功能，將關(guān)閉消息通知功能。
-
關(guān)閉后，不會(huì)再通過釘釘給用戶發(fā)送消息通知。
釘釘工作臺(tái)訪問通義靈碼
不支持通過釘釘 PC 端工作臺(tái)直接訪問通義靈碼。
-
移除釘釘集成
在釘釘集成詳情頁中，可單擊移除集成按鈕，二次確認(rèn)后即可移除釘釘集成，移除集成后：
-
解除通義靈碼賬號(hào)和釘釘賬號(hào)的綁定關(guān)系，不會(huì)影響已同步的用戶和組織架構(gòu)信息。
-
不支持接收釘釘消息通知。
-
不支持通過釘釘?shù)卿浲x靈碼，用戶若需要登錄通義靈碼，可使用通義靈碼的登錄賬號(hào)和密碼進(jìn)行登錄。
更多建議：