netcore接入钉钉扫码登录
- 一、首先官方文档预览
- 二、登录钉钉开发者后台
- 三、创建第三方登录授权应用
- 1.新版打开方式
- 2.旧版打开方式
- (1)先返回旧版页面
- (2)选择应用开发
- (3)编辑登录应用信息
- (4)记录下appid和appSecret后续需要
- 四、添加企业内部应用
- 1.添加应用
- 2.配置应用信息
- 3.记录下appkey和appsecret
- 4.添加回调地址
- 五、添加接口调用权限
- 六、添加内网穿透
- 七、搭建项目
- 1.代码下载
- 2.SDK下载和配置
- (1)sdk文档
- (2)下载sdk
- 3.修改博主的项目配置
- 八、代码详解
- 1.修改appsettings.json文件
- 1.view修改
- 2.代码演变以钉钉功能调试
- 3.打开钉钉提供的api调试台
- 4.根据对应的相应的信息获得demo代码直接复制到咱们的controller中
- (1)先获取access_token
- (2)通过扫码获得的code结合access_token获得用户unionid
- (3)通过上一步sns码获得的unionid去获取userid
- (4)通过上一步userid去获得用户的详细信息
- 七、剩下功能大同小异,自己更具文档和下面给出的两个api调试控制台出不多都能搞定
一、首先官方文档预览
以下信息根据这个文档来进行讲解,其中进行了补充,使得文档更加易于理解(因为这方面netcore参考不多,我收集现在资料出一个较为详细的操作信息)
实现登录第三方网站文档
二、登录钉钉开发者后台
这里需要账号权限,需要公司给与开通相应得权限,这里默认为有权限。
钉钉开发者后台
三、创建第三方登录授权应用
1.新版打开方式
现在开发后台打开得都是默认新版页面,但是我没找到创建第三方登录授权应用按钮,所以接下来都是以旧版界面为例
选择移动应用接入
2.旧版打开方式
这里开始往下都是旧版模式界面
(1)先返回旧版页面
(2)选择应用开发
(3)编辑登录应用信息
回调域名是后端接口得具体地址
(4)记录下appid和appSecret后续需要
四、添加企业内部应用
这里特别注意
第三和这第四步创建的应用用途不一样
弟三步创建的应用,是用来登录的(我现在觉得理解为登录接口api合适点,应用有点抽象),这里的appkey和secrect是用来调取二维码用的
这第四步是用来创建真正的应用,你项目(第三方网站)所依赖的应用
1.添加应用
这里可以开发其他得应用,但这里不予以展示,自行摸索
2.配置应用信息
3.记录下appkey和appsecret
4.添加回调地址
五、添加接口调用权限
六、添加内网穿透
因为钉钉需要请求后端服务的接口,但在开发前期你需要测试,或者你处于公司内网,钉钉调取不到你的接口,所以需要进行内网穿透,来让钉钉服务能通过外网访问到你的主机。
点击这里查看我收集的两种内网穿透方法文章
七、搭建项目
1.代码下载
为了方便这里没有用前后分离,直接使用netcoremvc开发
在这里是使用的这位博主得代码,是在他得基础上进一步详细讲解和补充(controller修改了部分代码,适应新版sdk,view也就是前端页面只修改了几个配置,下面会指出,其他都是没有改动的)
代码下载
2.SDK下载和配置
(1)sdk文档
SDK文档地址
(2)下载sdk
新版sdk
新版sdk直接解压
旧版sdk(netcore版本,net版本还未尝试,自行摸索)
解压红框内的文件
3.修改博主的项目配置
直接打开是无法直接使用的需要引入sdk
右键项目解决方案-》添加-》项目引用,让后分别找到上面下载sdk的csproj添加上此时项目结构如上。
右键DingQrCodeLogin-》添加-》项目应用然后添加上这两个sdk的引用
八、代码详解
1.修改appsettings.json文件
==注意本文涉及了两个应用,一个是登录授权应用,一个是你自己的三方应用,这俩分别都有一对appid(key)和appsecret。不要设置混淆了,这是是设置为自己三方应用的。
1.view修改
view(界面)只需要修改如下地方
这里用户扫扫码后会给homecontroller传递code和state两个参数,state是固定的不用管
2.代码演变以钉钉功能调试
修改刚才下载下来的homecontroller代码
什么都没干,先定义方法接收,扫码后传递过来的参数
public string DingLogin(string code, string state)
{
}
3.打开钉钉提供的api调试台
api调试台
4.根据对应的相应的信息获得demo代码直接复制到咱们的controller中
(1)先获取access_token
免密登录,需要access_token才行
public static AlibabaCloud.SDK.Dingtalkoauth2_1_0.Client CreateClient()
{
AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config();
config.Protocol = "https";
config.RegionId = "central";
return new AlibabaCloud.SDK.Dingtalkoauth2_1_0.Client(config);
}
public string DingLogin(string code, string state)
{
AlibabaCloud.SDK.Dingtalkoauth2_1_0.Client client = CreateClient();
AlibabaCloud.SDK.Dingtalkoauth2_1_0.Models.GetAccessTokenRequest getAccessTokenRequest = new AlibabaCloud.SDK.Dingtalkoauth2_1_0.Models.GetAccessTokenRequest();
try
{
// 这里获得了咱们的access_token
client.GetAccessToken { AppKey = "自己的外部appkey",AppSecret = "自己。。。" };
}
}
(2)通过扫码获得的code结合access_token获得用户unionid
public static AlibabaCloud.SDK.Dingtalkoauth2_1_0.Client CreateClient()
{
AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config();
config.Protocol = "https";
config.RegionId = "central";
return new AlibabaCloud.SDK.Dingtalkoauth2_1_0.Client(config);
}
public string DingLogin(string code, string state)
{
AlibabaCloud.SDK.Dingtalkoauth2_1_0.Client client = CreateClient();
AlibabaCloud.SDK.Dingtalkoauth2_1_0.Models.GetAccessTokenRequest getAccessTokenRequest = new AlibabaCloud.SDK.Dingtalkoauth2_1_0.Models.GetAccessTokenRequest();
try
{
// 这里获得了咱们的access_token
client.GetAccessToken { AppKey = "自己的外部appkey",AppSecret = "自己。。。" };
//通过扫码获得的code和上面获取的access_token,获取unionid
OapiSnsGetuserinfoBycodeResponse response = new OapiSnsGetuserinfoBycodeResponse();
string qrAppId = AppConfigurtaionHelper.Configuration["DingDing:QrAppId"];
string qrAppSecret = AppConfigurtaionHelper.Configuration["DingDing:QrAppSecret"];
if (string.IsNullOrWhiteSpace(qrAppId) || string.IsNullOrWhiteSpace(qrAppSecret))
{
throw new Exception("钉钉配置信息错误!");
}
DefaultDingTalkClient uclient = new DefaultDingTalkClient("https://oapi.dingtalk.com/sns/getuserinfo_bycode");
OapiSnsGetuserinfoBycodeRequest ureq = new OapiSnsGetuserinfoBycodeRequest();
ureq.TmpAuthCode = code;
response = uclient.Execute(ureq, qrAppId, qrAppSecret);
}
}
(3)通过上一步sns码获得的unionid去获取userid
public static AlibabaCloud.SDK.Dingtalkoauth2_1_0.Client CreateClient()
{
AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config();
config.Protocol = "https";
config.RegionId = "central";
return new AlibabaCloud.SDK.Dingtalkoauth2_1_0.Client(config);
}
public string DingLogin(string code, string state)
{
AlibabaCloud.SDK.Dingtalkoauth2_1_0.Client client = CreateClient();
AlibabaCloud.SDK.Dingtalkoauth2_1_0.Models.GetAccessTokenRequest getAccessTokenRequest = new AlibabaCloud.SDK.Dingtalkoauth2_1_0.Models.GetAccessTokenRequest();
try
{
// 这里获得了咱们的access_token
client.GetAccessToken { AppKey = "自己的外部appkey",AppSecret = "自己。。。" };
//通过扫码获得的code和上面获取的access_token,获取unionid
OapiSnsGetuserinfoBycodeResponse response = new OapiSnsGetuserinfoBycodeResponse();
string qrAppId = AppConfigurtaionHelper.Configuration["DingDing:QrAppId"];
string qrAppSecret = AppConfigurtaionHelper.Configuration["DingDing:QrAppSecret"];
if (string.IsNullOrWhiteSpace(qrAppId) || string.IsNullOrWhiteSpace(qrAppSecret))
{
throw new Exception("钉钉配置信息错误!");
}
DefaultDingTalkClient uclient = new DefaultDingTalkClient("https://oapi.dingtalk.com/sns/getuserinfo_bycode");
OapiSnsGetuserinfoBycodeRequest ureq = new OapiSnsGetuserinfoBycodeRequest();
ureq.TmpAuthCode = code;
response = uclient.Execute(ureq, qrAppId, qrAppSecret);
//获取用户id
IDingTalkClient ubclient = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/user/getbyunionid");
OapiUserGetbyunionidRequest ubreq = new OapiUserGetbyunionidRequest { Unionid = response.UserInfo.Unionid};
OapiUserGetbyunionidResponse ubrsp = ubclient.Execute(ubreq, a.Body.AccessToken);
Console.WriteLine(ubrsp.Body);
}
}
(4)通过上一步userid去获得用户的详细信息
public static AlibabaCloud.SDK.Dingtalkoauth2_1_0.Client CreateClient()
{
AlibabaCloud.OpenApiClient.Models.Config config = new AlibabaCloud.OpenApiClient.Models.Config();
config.Protocol = "https";
config.RegionId = "central";
return new AlibabaCloud.SDK.Dingtalkoauth2_1_0.Client(config);
}
public string DingLogin(string code, string state)
{
AlibabaCloud.SDK.Dingtalkoauth2_1_0.Client client = CreateClient();
AlibabaCloud.SDK.Dingtalkoauth2_1_0.Models.GetAccessTokenRequest getAccessTokenRequest = new AlibabaCloud.SDK.Dingtalkoauth2_1_0.Models.GetAccessTokenRequest();
try
{
// 这里获得了咱们的access_token
client.GetAccessToken { AppKey = "自己的外部appkey",AppSecret = "自己。。。" };
//通过扫码获得的code和上面获取的access_token,获取unionid
OapiSnsGetuserinfoBycodeResponse response = new OapiSnsGetuserinfoBycodeResponse();
string qrAppId = AppConfigurtaionHelper.Configuration["DingDing:QrAppId"];
string qrAppSecret = AppConfigurtaionHelper.Configuration["DingDing:QrAppSecret"];
if (string.IsNullOrWhiteSpace(qrAppId) || string.IsNullOrWhiteSpace(qrAppSecret))
{
throw new Exception("钉钉配置信息错误!");
}
DefaultDingTalkClient uclient = new DefaultDingTalkClient("https://oapi.dingtalk.com/sns/getuserinfo_bycode");
OapiSnsGetuserinfoBycodeRequest ureq = new OapiSnsGetuserinfoBycodeRequest();
ureq.TmpAuthCode = code;
response = uclient.Execute(ureq, qrAppId, qrAppSecret);
//获取用户id
IDingTalkClient ubclient = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/user/getbyunionid");
OapiUserGetbyunionidRequest ubreq = new OapiUserGetbyunionidRequest { Unionid = response.UserInfo.Unionid};
OapiUserGetbyunionidResponse ubrsp = ubclient.Execute(ubreq, a.Body.AccessToken);
Console.WriteLine(ubrsp.Body);
//获取用户信息
IDingTalkClient client2 = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/v2/user/get");
OapiV2UserGetRequest req2 = new OapiV2UserGetRequest { Userid = ubrsp.Result.Userid };
OapiV2UserGetResponse rsp2 = client2.Execute(req2, a.Body.AccessToken);
}
}
剩下的就需要直接自己去根据需求进行探索
七、剩下功能大同小异,自己更具文档和下面给出的两个api调试控制台出不多都能搞定
功能api
功能api