ASP.NET實現企業微信接入應用實現身份認證

willingtolove發表於2020-09-25

#需求場景

一個.net開發的web應用接入到企業微信的應用中，實現微信使用者點選應用，開啟web，獲取到使用者資訊，並實現自動登入功能。

#參考

企業微信官方API文件：https://work.weixin.qq.com/api/doc/90000/90135/91020

#具體步驟

1、獲取access_token

獲取access_token是呼叫企業微信API介面的第一步，相當於建立了一個登入憑證，其它的業務API介面，都需要依賴於access_token來鑑權呼叫者身份。

請求方式： GET（HTTPS）
請求地址： https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
注：此處標註大寫的單詞ID和SECRET，為需要替換的變數，根據實際獲取值更新。其它介面也採用相同的標註，不再說明。
引數說明：
許可權說明：
每個應用有獨立的secret，獲取到的access_token只能本應用使用，所以每個應用的access_token應該分開來獲取
返回結果：

{
   "errcode": 0,
   "errmsg": "ok",
   "access_token": "accesstoken000001",
   "expires_in": 7200
}

2、構造網頁授權連結

如果企業需要在開啟的網頁裡面攜帶使用者的身份資訊，第一步需要構造如下的連結來獲取code引數：

https://open.weixin.qq.com/connect/oauth2/authorize?appid=CORPID&redirect_uri=REDIRECT_URI&response_type=code&scope=snsapi_base&state=STATE#wechat_redirect

引數說明：

員工點選後，頁面將跳轉至 redirect_uri?code=CODE&state=STATE，企業可根據code引數獲得員工的userid。code長度最大為512位元組。

示例：
假定當前企業CorpID：wxCorpId
訪問連結：http://www.wanwone.com?action=get
根據URL規範，將上述引數分別進行UrlEncode，得到拼接的OAuth2連結為：

https://open.weixin.qq.com/connect/oauth2/authorize?appid=wxCorpId&redirect_uri=http%3A%2F%2Fwww.wanwone.com%2Fcgi-bin%2Fquery%3Faction%3Dget&response_type=code&scope=snsapi_base&state=#wechat_redirect

注意，構造OAuth2連結中引數的redirect_uri是經過UrlEncode的

員工點選後，頁面將跳轉至

http://www.wanwone.com?action=get&code=AAAAAAgG333qs9EdaPbCAP1VaOrjuNkiAZHTWgaWsZQ&state=

企業可根據code引數呼叫獲取員工的資訊.

3、獲取訪問使用者身份

該介面用於根據code獲取成員資訊

請求方式：GET（HTTPS）
請求地址：https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?access_token=ACCESS_TOKEN&code=CODE
引數說明：
引數
許可權說明：
跳轉的域名須完全匹配access_token對應應用的可信域名，否則會返回50001錯誤。
返回結果：
a) 當使用者為企業成員時返回示例如下：

{
   "errcode": 0,
   "errmsg": "ok",
   "UserId":"USERID",
   "DeviceId":"DEVICEID"
}

在這裡插入圖片描述

b) 非企業成員授權時返回示例如下：

{
   "errcode": 0,
   "errmsg": "ok",
   "OpenId":"OPENID",
   "DeviceId":"DEVICEID"
}

在這裡插入圖片描述

#.Net具體程式碼

1、Web首頁服務端程式碼

    protected void Page_Load(object sender, EventArgs e)
    {
        //獲取配置資訊（CorpId，Secret）
        Dictionary<string, string> configs = GetConfig();
        string access_token = Context.Cache["access_token"] as string;
        if (!(Context.Request["code"] != null && Context.Request["state"] != null && Context.Request["state"].ToString() == "parasaga"))
        {
            if (access_token == null)
            {
                access_token = WXQYHelper.GetAccess_token(configs["CorpId"], configs["Secret"]);
                //快取到Cache
                Context.Cache.Insert("access_token", access_token, null, Cache.NoAbsoluteExpiration, TimeSpan.FromMinutes(30));
            }

            if (string.IsNullOrEmpty(access_token))
            {
                //獲取token失敗
            }
            else
            {
                string service = Context.Request.Url.GetLeftPart(UriPartial.Path);
                //構造網頁授權連結
                string redirectUrl = WXQYHelper.GetAuthLink(configs["CorpId"], service);
                //重定向到授權連結
                Context.Response.Redirect(redirectUrl);
            }
        }
        else
        {
            string code = Context.Request["code"].ToString();
            //根據code獲取訪問使用者身份
            string uid = WXQYHelper.GetUserIdByCode(access_token, code);
            if (string.IsNullOrEmpty(uid))
            {
                //獲取失敗
            }
            else
            {
                //獲取成功
                //進行應用本身的登入邏輯
            }
        }
    }
    public Dictionary<string, string> GetConfig()
    {
        Dictionary<string, string> configs = new Dictionary<string, string>();

        string CorpId = System.Configuration.ConfigurationManager.AppSettings["CorpId"].ToString();
        string Secret = System.Configuration.ConfigurationManager.AppSettings["Secret"].ToString();
        configs.Add("CorpId", CorpId);
        configs.Add("Secret", Secret);
        return configs;
    }

2、幫助類程式碼

    public class WXQYHelper
    {
        /// <summary>
        /// 獲取登陸標識access_token
        /// </summary>
        /// <returns></returns>
        public static string GetAccess_token(string corpId,string secret)
        {
            string result = "";
            try
            {
                //https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
                string tokenUrl = "https://qyapi.weixin.qq.com/cgi-bin/gettoken";
                var getStr = "corpid=" + corpId + "&corpsecret=" + secret;
                result = Common.HttpWebRequest(tokenUrl, getStr, "GET");
            }
            catch (Exception e)
            {
                //PsLog.Error("獲取登陸標識失敗,返回結果：" + e.ToString());
                return "";
            }
            //{
            //  "errcode": 0,
            //   "errmsg": "ok",
            //   "access_token": "accesstoken000001",
            //   "expires_in": 7200
            //}
            var jsonObj = (JObject)JsonConvert.DeserializeObject(result);

            var token = jsonObj["access_token"].ToString();
            if (!string.IsNullOrEmpty(token))
            {
                return token;
            }
            else
            {
                return "";
            }
        }
        /// <summary>
        /// 構造網頁授權連結
        /// </summary>
        /// <param name="corpId"></param>
        /// <param name="appUrl"></param>
        /// <returns></returns>
        public static string GetAuthLink(string corpId,string appUrl)
        {
            string link = "";
            //https://open.weixin.qq.com/connect/oauth2/authorize
            //?appid=wxCorpId
            //&redirect_uri=http%3a%2f%2fapi.3dept.com%2fcgi-bin%2fquery%3faction%3dget
            //&response_type=code
            //&scope=snsapi_base
            //&state=#wechat_redirect
            link = string.Format("{0}?appid={1}&redirect_uri={2}&response_type={3}&scope={4}&state={5}#wechat_redirect",
                "https://open.weixin.qq.com/connect/oauth2/authorize",
                corpId,
                HttpUtility.UrlEncode(appUrl),
                "code",
                "snsapi_base",
                "parasaga"
                );
            return link;
        }
        /// <summary>
        /// 獲取訪問使用者身份
        /// </summary>
        /// <param name="accessToken"></param>
        /// <param name="code"></param>
        /// <returns></returns>
        public static string GetUserIdByCode(string accessToken, string code)
        {
            //https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?access_token=ACCESS_TOKEN&code=CODE

            string result = "";
            try
            {
                //https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
                string tokenUrl = "https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo";
                var getStr = "access_token=" + accessToken + "&code=" + code;
                result = Common.HttpWebRequest(tokenUrl, getStr, "GET");
            }
            catch (Exception e)
            {
                //PsLog.Error("獲取userid失敗,返回結果：" + e.ToString());
                return "";
            }
			//{
			//   "errcode": 0,
			//   "errmsg": "ok",
			//   "UserId":"USERID",
			//   "DeviceId":"DEVICEID"
			//}
            var jsonObj = (JObject)JsonConvert.DeserializeObject(result);

            var uid = jsonObj["UserId"].ToString();
            if (!string.IsNullOrEmpty(uid))
            {
                return uid;
            }
            else
            {
                return "";
            }
        }
    }

相關文章

springboot整合shiro實現身份認證
2020-04-07
Spring Boot
ASP.NET Core - JWT認證實現
2021-01-17
ASP.NETJWT
接入企業微信
2020-07-16
企業微信開發——身份驗證模組
2018-04-24
增強版實名認證介面-Java身份證實名認證介面程式碼-身份認證
2024-03-13
Java
身份證真偽查詢介面、身份證實名認證一行python程式碼即可實現，實時資料
2024-04-07
Python
gRPC中整合asp.net identity實現oAuth認證
2019-05-27
RPCASP.NETIDEOAuth
企業微信整合openai實現ChatGPT機器人
2023-02-09
OpenAIChatGPT機器人
PHP身份實名認證介面小白也能輕鬆實現，ocr介面
2024-04-26
PHP
企業微信JS-SDK實現會話聊天功能
2020-12-23
JS會話
Rust中實現JWT身份驗證
2024-02-24
RustJWT
Shiro實現Basic認證
2020-12-17
koa 實現 jwt 認證
2019-02-16
JWT
網路實名制、電商實名認證、身份證實名認證介面
2024-06-28
C++身份證二要素實名認證api、實名認證介面
2024-05-20
C++API
Java身份證實名認證、身份證識別介面讓您認證任性的“懶”
2024-07-01
Java
【Azure 應用服務】NodeJS Express + MSAL 實現API應用Token認證(AAD OAuth2 idToken)的認證實驗 -- passport.authenticate()
2022-06-11
NodeJSExpressAPIOAuthPassport
將ChatGPT接入微信實現智慧回覆
2022-12-18
ChatGPT
Java身份證實名認證介面解鎖認證新速度
2024-08-20
Java
asp.net core + Ocelot 實現負載均衡、熔斷、認證、限流
2024-06-04
ASP.NET負載
ASP.NET Core Authentication系列（二）實現認證、登入和登出
2020-11-02
ASP.NET
C++身份核驗介面程式碼、身份證OCR、身份證實名認證API
2024-04-16
C++API
飛書 + Lua 實現企業級組織架構登入認證
2021-09-09
架構
php實現微信企業號支付個人的方法詳解
2019-11-02
PHP
ASP.NET Core2利用Jwt技術在服務端實現對客戶端的身份認證
2018-08-27
ASP.NETJWT服務端客戶端
Spring Security認證器實現
2022-06-23
Spring
Spark 框架安全認證實現
2021-09-09
Spark框架
實現微信分享功能
2018-11-05
Android | 教你如何在安卓上實現二代身份證識別，一鍵實名認證
2020-05-12
Android安卓
企業應用架構研究系列二十八：身份認證 Beginning Out With IdentityServer4
2022-04-28
應用架構IDEServer
Node.js應用接入Skywalking實現APM監控
2021-12-03
Node.js
微信小程式實現釋出作業
2018-12-12
微信小程式
鴻蒙 Next 企業級應用安全認證體系構建實戰
2024-11-08
鴻蒙
node實現基於token的身份驗證
2019-03-04
破解使用radius實現802.1x認證的企業無線網路
2020-08-19
微信小程式支付接入實戰
2019-01-29
微信小程式
微服務整合springsecurity實現認證
2024-07-27
微服務SpringGse
java實現微信登入
2024-07-02
Java