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