python項目對接釘釘SDK的實現(xiàn)
釘釘SDK
對接sdk還是遇到不少問題的
釘釘python版SDK文檔地址:https://dingtalk-sdk.readthedocs.io/zh_CN/latest/
釘釘官方服務(wù)端文檔:https://open-doc.dingtalk.com/microapp/serverapi2
為了避免調(diào)試出現(xiàn)不必要的參數(shù)錯誤,前期釘釘配置要做好,血和淚的教訓(xùn)😭
準(zhǔn)備好下面幾個參數(shù)
DINGTALK_CORP_ID = "重點:企業(yè)應(yīng)用ID" # 釘釘微應(yīng)用 DINGTALK_APP_KEY = "微應(yīng)用APP_KEY" DINGTALK_CORP_SECRET = "微應(yīng)用SERCRET" # 釘釘移動應(yīng)用(掃碼登錄),在移動應(yīng)用接入菜單里配置 DINGTALK_APP_ID = "移動應(yīng)用APP_ID" DINGTALK_APP_SECRET = "移動應(yīng)用APP_SECRET" # 釘釘aes加密(隨機(jī)) DINGTALK_AES_TOKEN = "43位字符串 a-zA-Z0-9中生成" DINGTALK_TOKEN = "字符串隨便填"
一. 第三方web網(wǎng)站掃碼登錄1. 流程
釘釘掃碼—>判斷是否公司員工—>登錄
關(guān)于web系統(tǒng)的兩種接入方式,都只能獲取到用戶的釘釘身份,并不能獲取到用戶是否在企業(yè)中
解決方法:
批量同步釘釘人員信息到數(shù)據(jù)庫,登錄后匹配數(shù)據(jù)庫,新進(jìn)員工通過釘釘回調(diào)同步到數(shù)據(jù)庫,回調(diào)未生效人工審核后手動更新數(shù)據(jù)庫
由于釘釘開發(fā)文檔讀的不夠仔細(xì)導(dǎo)致調(diào)試頻繁出錯,所以開發(fā)流程我簡單說,把細(xì)節(jié)放大
前端導(dǎo)入釘釘scrpit文件開發(fā)掃碼頁面
<script src="http://g.alicdn.com/dingding/dinglogin/0.0.5/ddLogin.js"></script> <script> var url="http://erp.vaiwan.com/api/v1.0/ding_test"; var goto = encodeURIComponent('https://oapi.dingtalk.com/connect/oauth2/sns_authorize?appid=dingoadwjj1iszubeh9rnf&response_type=code&scope=snsapi_login&state=STATE&redirect_uri='+url); var obj = DDLogin({ id:"login_container", goto: goto, style: "border:none;background-color:#FFFFFF;", width : "365", height: "400" }); var hanndleMessage = function (event) { var origin = event.origin; console.log("origin", event.origin); //判斷是否來自ddLogin掃碼事件。 if( origin == "https://login.dingtalk.com" ) { //拿到loginTmpCode后就可以在這里構(gòu)造跳轉(zhuǎn)鏈接進(jìn)行跳轉(zhuǎn)了 var loginTmpCode = event.data; console.log("loginTmpCode", loginTmpCode); if(loginTmpCode){ let uri="https://oapi.dingtalk.com/connect/oauth2/sns_authorize?appid=dingoadwjj1iszubeh9rnf&response_type=code&scope=snsapi_login&state=STATE&redirect_uri="+url+"&loginTmpCode="+loginTmpCode; // 跳轉(zhuǎn) location.href = uri; } } }; if (typeof window.addEventListener != 'undefined') { window.addEventListener('message', hanndleMessage, false); } else if (typeof window.attachEvent != 'undefined') { window.attachEvent('onmessage', hanndleMessage); } </script>
配置掃碼后跳轉(zhuǎn)頁面(就是第一步goto參數(shù)里的url),釘釘會自動在跳轉(zhuǎn)頁面路由后添加code
和state
參數(shù)
拿到code請求后端接口
<script src="https://cdn.bootcss.com/jquery/3.1.0/jquery.min.js"></script> <script> // location.search: "?code=bb42ec66ed5...&state=STATE" let code = location.search.split("&")[0].split("=")[1]; $.ajax({ type:"post", url:'http://erp.vaiwan.com.cn/api/v1.0/getinfo', data:{ "code":code }, success:function(data){ console.log(data) } }) </script>
后端用appid和appsecret獲取access_token
import requests from dingtalk.client import SecretClient class GetInfoByCode(object): def __init__(self): self.url = "https://oapi.dingtalk.com/sns" def get_access_token(self): resp = requests.get( url=self.url + "/gettoken", params=dict(appid=DINGTALK_APP_ID, appsecret=DINGTALK_APP_SECRET) ) resp = resp.json() return resp["access_token"]
用access_token和code獲取用戶unionid
def get_persistent_code(self, code, token): resp = requests.post( url="%s/get_persistent_code?access_token=%s" % (self.url, token), json=dict(tmp_auth_code=code), ) resp = resp.json() return resp["unionid"]
用unionid換取userid
ding_client = SecretClient(corp_id=DINGTALK_CORP_ID, corp_secret=DINGTALK_CORP_SECRET) # 這塊提醒下一定要做緩存,由于我之前沒做緩存,超過釘釘使用頻率而被限制了,修改下上面那句代碼 import redis from dingtalk.storage.kvstorage import KvStorage # redis做緩存 redis_ding = redis.StrictRedis(REDIS_HOST, REDIS_PORT, db=0) # 劃重點,因為我是第三方web網(wǎng)站,沒有使用E應(yīng)用,所以我的corp_id填的是微應(yīng)用的id,而不是企業(yè)應(yīng)用ID(corp_id) ding_client = SecretClient( corp_id=DINGTALK_APP_KEY, corp_secret=DINGTALK_CORP_SECRET, storage=KvStorage(redis_ding)) userid = ding_client.user.get_userid_by_unionid(unionid)
userid換取user詳情
user = ding_client.user.get(userid["userid"])
二. 加解密
應(yīng)用場景: 釘釘回調(diào)
事件流程:注冊回調(diào)事件—>處理事件內(nèi)容(新增員工、更新部門等),返回釘釘加密json
就是說你調(diào)用注冊事件API,釘釘會給你需要注冊的url發(fā)送一個post請求,你得按要求返回success,否則注冊失敗
1.注冊事件
再看看什么是success
的加密json數(shù)據(jù)
如果你沒有看懂的話,很巧 我也看不懂…
json數(shù)據(jù)包含這些參數(shù)
時間戳和nonce
容易拿,問題在于encrypt
和msg_signature
的生成
因為釘釘沒有提供python的加解密庫,所以看到這塊我有點懵
釘釘?shù)奈臋n看不太懂…
百度搜了下 發(fā)現(xiàn)有人自己封裝了這個庫,我看了下名字XXXcrypto
,crypto這個單詞
好像在sdk里邊見過。
看了sdk目錄,果然,雖然釘釘sdk雖然沒寫關(guān)于加解密的內(nèi)容,但是它其實已經(jīng)封裝了這個庫
使用
from dingtalk.crypto import DingTalkCrypto class Crypto(object): def __init__(self): # 隨便填的字符串 self.token = DINGTALK_TOKEN # 自己生成的43位隨機(jī)字符串 self.aes_key = DINGTALK_AES_TOKEN # 釘釘企業(yè)ID self.corpid = DINGTALK_APP_ID self.crypto = DingTalkCrypto( token=self.token, encoding_aes_key=self.aes_key, corpid_or_suitekey=self.corpid )
說明
原本是不需要自己封裝的??磀ingtalk的源碼

在開始定義ding_client
的時候,只需要填參數(shù)就可以,經(jīng)過我反復(fù)的調(diào)試,發(fā)現(xiàn)因為我開發(fā)的是企業(yè)內(nèi)部應(yīng)用-微應(yīng)用,而不是E應(yīng)用,所以這里填的corp_id其實是微應(yīng)用app_key
,參數(shù)不正確導(dǎo)致后邊調(diào)試一直返回文本非success
錯誤,為了不與上邊填的參數(shù)沖突,所以自己封裝Crypto
類,填寫的corp_id是企業(yè)應(yīng)用id
封裝好Crypto
這個類,就可以調(diào)用啦, 先測試返回給釘釘?shù)慕Y(jié)果是否正確
from ... import Crypto class EventCallBack(Resource): def __init__(self): self.crypto = Crypto().crypto def post(self): # 返回加密success result = self.crypto.encrypt_message( msg="success", nonce="123456", timestamp=int(time.time()*1000) ) return result
事情沒這么容易結(jié)束…
這個post方法你需要對回調(diào)事件作出處理而不是僅僅返回success,所以最終需要這樣, 對結(jié)果進(jìn)行處理
def post(self): po = request.json["encrypt"] data = request.values # 返回加密success result = self.crypto.encrypt_message( msg="success", nonce="123456", timestamp=int(time.time()*1000) ) # 獲取到事件及其他信息 callback = self.crypto.decrypt_encrypt_str( encrypt_str=po, nonce=data["nonce"], timestamp=data["timestamp"], signature=data["signature"] ) # demjson可以把字符串轉(zhuǎn)為字典,否則取值失敗 # 安裝 pip install demjson callback = demjson.decode(callback) # 判斷事件類型,作出相應(yīng)回調(diào) if callback["EventType"] == "user_add_org": # 添加員工 ... elif callback["EventType"] == "org_dept_create": # 添加部門 ... return result
三. 調(diào)試
# 釘釘內(nèi)網(wǎng)穿透工具,主要作用是方便本地調(diào)試需要回調(diào)域名的接口 # 地址: https://open-doc.dingtalk.com/microapp/debug/ucof2g 可以后臺啟動
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
一篇文章從零開始創(chuàng)建conda環(huán)境、常用命令的使用及pycharm配置項目環(huán)境
在Conda中創(chuàng)建新環(huán)境是一個非常有用的做法,尤其是當(dāng)你需要為不同的項目安裝不同版本的軟件包時,這篇文章主要給大家介紹了關(guān)于從零開始創(chuàng)建conda環(huán)境、常用命令的使用及pycharm配置項目環(huán)境的相關(guān)資料,需要的朋友可以參考下2024-07-07Python使用cx_Oracle調(diào)用Oracle存儲過程的方法示例
這篇文章主要介紹了Python使用cx_Oracle調(diào)用Oracle存儲過程的方法,結(jié)合具體實例分析了Python中通過cx_Oracle調(diào)用PL/SQL的具體步驟與相關(guān)操作技巧,需要的朋友可以參考下2017-10-10Python面向?qū)ο笾惡蛯ο髮傩缘脑鰟h改查操作示例
這篇文章主要介紹了Python面向?qū)ο笾惡蛯ο髮傩缘脑鰟h改查操作,結(jié)合實例形式分析了Python面向?qū)ο笙嚓P(guān)的類與對象屬性常見操作技巧,需要的朋友可以參考下2018-12-12初學(xué)python的操作難點總結(jié)(新手必看篇)
下面小編就為大家?guī)硪黄鯇W(xué)python的操作難點總結(jié)(新手必看篇)。小編覺得挺不錯的,現(xiàn)在就分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2017-08-08Python異常處理機(jī)制結(jié)構(gòu)實例解析
這篇文章主要介紹了Python異常處理機(jī)制結(jié)構(gòu)實例解析,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友可以參考下2020-07-07Python進(jìn)階篇之正則表達(dá)式常用語法總結(jié)
正則表達(dá)式是一個特殊的字符序列,它能幫助你方便的檢查一個字符串是否與某種模式匹配。本文為大家總結(jié)了一些正則表達(dá)式常用語法,希望有所幫助2022-08-08