demo部署后,一定要确认isv.log和filecache.php两个文件有写权限。
###创建套件前
登录到 http://open-dev.dingtalk.com/#/index?_k=lluyaq 创建套件(需要先注册开发者账号和钉钉企业才能创建套件)
###创建套件 3.填写套件信息 其中:
- Token: 可以随意填写,填写完之后,打开工程的isv/config.php文件,把Token的值复制给TOKEN
- 数据加密密钥:点击自动生成,然后打开工程的isv/config.php文件,把值复制给给ENCODING_AES_KEY
- 应用ID:把应用ID的值复制给APPID
- IP白名单: 调用钉钉API的合法IP列表(例如,工程部署在ip地址为123.xxx.xxx.xxx的主机上,那就填写"123.xxx.xxx.xxx")
- 回调URL: url为
工程地址/receive.php
(例如,工程将部署在ip地址为123.xxx.xxx.xxx的主机上,端口为8080,那么我的回调URL即为:http://123.xxx.xxx.xxx:8080/receive.php
,假如你有域名的话,也可以把IP地址换成域名)
4.配置PHP服务器环境(php+apache/nginx),安装mcrypt扩展(注意,一定要安装mcrypt扩展),保证apache服务根目录与可写权限(存储json数据)
5.将demo工程(isv)部署到服务器上
6.部署成功之后,点击『创建套件』弹窗中的『验证有效性』。
具体是如何验证回调URL有效性的,请查看(isv/receive.php)
7.创建套件成功之后,将得到的SuiteKey和SuiteSecret填写到工程的config.php中。
8.点击['测试企业和文档'],注册测试企业,注册完成后,点击『登录管理』到oa.dingtalk.com
完成测试企业的激活
9.测试企业激活完成后,进入套件『管理』,在页面底部选择要授权的测试企业进行授权
10.修改微应用主页地址和PC主页地址
点击应用最右侧的编辑
,编辑微应用信息,例如,工程部署在ip地址为123.xxx.xxx.xxx的主机上,端口为8080,那么微应用首页地址即为:http://123.xxx.xxx.xxx:8080/index.php?corpid=$CORPID$
,PC版首页地址为:http://123.xxx.xxx.xxx:8080/indexpc.php?corpid=$CORPID$
,点击保存。
11.打开钉钉,进入对应企业,即可看到微应用,点击进入
注意:Ticket推送状态成功之后,再授权企业
###创建企业应用
1.进入https://oa.dingtalk.com/#/microApp/microAppList
,点击『新建应用』
2.配置PHP服务器环境(php+apache/nginx),安装mcrypt扩展(注意,一定要安装mcrypt扩展),保证apache服务根目录与可写权限(存储json数据)
3.微应用主页地址填写。地址为根目录/index.php
,(例如,工程部署在ip地址为123.xxx.xxx.xxx的主机上,端口为8080,那么微应用首页地址即为:http://123.xxx.xxx.xxx:8080/index.php
,PC版首页地址为:http://123.xxx.xxx.xxx:8080/indexpc.php
,假如你有域名的话,也可以把IP地址换成域名)
修改config.php中的CORPID,SECRET,AGENTID,其中CORPID,SECRET在微应用设置页面https://oa.dingtalk.com/#/microApp/microAppSet
获取,AGENTID在创建微应用的时候可以获取
4.微应用创建成功后,需要把微应用首页地址改为'根目录/index.php'
5.打开钉钉,进入对应企业,即可看到微应用,点击进入
###本DEMO具体实现
1.URL回调流程
请查看文档
2.jsapi权限验证配置流程
请查看文档
3.免登流程
请查看文档