/isv_demo_php

ISV应用demo

Primary LanguagePHP

Getting Started

注意!注意!注意!demo中的数据库存储一定要修改为mysql等持久化存储。

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.56.71.118的主机上,那就填写"123.56.71.118")
  • 回调URL: url为工程地址/receive.php(例如,工程将部署在ip地址为123.56.71.118的主机上,端口为8080,那么我的回调URL即为:http://123.56.71.118: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.56.71.118的主机上,端口为8080,那么微应用首页地址即为:http://123.56.71.118:8080/index.php?corpid=$CORPID$,PC版首页地址为:http://123.56.71.118: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.56.71.118的主机上,端口为8080,那么微应用首页地址即为:http://123.56.71.118:8080/index.php,PC版首页地址为:http://123.56.71.118: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.免登流程

请查看文档