dd-auth-login v1.0.12

dd-auth-login

最好用的钉钉免登签名js库

:open_file_folder: 目录介绍

.
├── dist 编译产出代码
├── src 源代码目录
└── demo.html 示例文件

:rocket: 快速开始

1. 引入钉钉JSAPI

1.1如果你是浏览器环境

<script src="https://g.alicdn.com/dingding/dingtalk-jsapi/2.7.13/dingtalk.open.js"></script>

1.2如果你是webpack等环境

npm install dingtalk-jsapi --save

import * as dd from 'dingtalk-jsapi'; // 此方式为整体加载，也可按需进行加载

2. 引入本库

2.1如果你是浏览器环境

<script src="./dist/dd-auth-login.min.js"></script>

2.2如果你是webpack等环境

npm install dd-auth-login --save

或者

yarn add dd-auth-login

然后

import ddAuthLogin from 'dd-auth-login'

2.3如果你是requirejs环境

requirejs(['./dist/dd-auth-login.min.js'], function (res) {
    // xxx
})

3. 调用 login 函数进行签名&免登

ddAuthLogin.login({
  success: function(res) {
    console.log('免登成功啦啦啦', res)
  },
  fail: function(err) {
    console.log('啊哦，免登失败', err)
  }
})

:bookmark_tabs: AIP文档

ddAuthLogin.isDD()

返回当前是否钉钉环境; true: 是, false: 否

ddAuthLogin.login()

签名&免登过程

传入参数

返回参数

:loudspeaker: 接口说明(给后端同学看)

signUrl接口

请求类型: GET 传入参数: url = 'xxxxx(当前页面url)' 返回数据:

{
  content: {
    agentId: '微应用ID',
    corpId: '企业ID',
    timeStamp: '生成签名的时间戳',
    nonceStr: '生成签名的随机串',
    signature: '签名',
    hasLogin: '如果已经登录，则返回true，此时不会调用sso'
  },
  message: '接口调用成功',
  code: 200
}

ssoUrl接口

请求类型: GET 传入参数: authCode = 'xxxx(从dd.runtime.permission.requestAuthCode得到的code)' 返回数据如下:

{
  content: {},
  message: '接口调用成功',
  code: 200
}

:couple: 谁在使用

• Landray

:see_no_evil: 相关链接

• Github Pages
• 仓库地址
• NPM主页
• yarn主页
• 钉钉开放平台