Asp.Net Core实战JWT认证数据接口网关
148 浏览量
更新于2024-09-04
收藏 99KB PDF 举报
"Asp.Net Core JWT认证数据接口网关实例代码"
在Asp.Net Core中，JWT（Json Web Token）认证是一种广泛采用的安全机制，它允许客户端通过获取和携带Token来安全地访问受保护的API资源。这个实例代码示例展示了如何在Asp.Net Core中构建一个基于JWT的数据接口网关，提供了对前后端分离架构的数据服务支持。
首先，我们需要理解JWT的工作原理。JWT是一种自包含的、紧凑的、安全的身份验证和授权机制，它将用户信息编码成一个令牌，这个令牌由三部分组成：头部（Header）、负载（Payload）和签名（Signature）。当用户成功登录后，服务器会返回一个JWT，客户端随后在每次请求时将此Token附带在HTTP请求头中，服务器通过验证Token的有效性来确定用户的身份和权限。
在示例中，`TokenController`负责处理Token的获取和注销。用户通过提供有效凭证（如用户名和密码）获取Token，然后在后续对受保护资源的请求中携带这个Token。`UsersController`则作为一个数据接口示例，它的操作受到JWT的保护。
`ApiBase.cs`文件定义了一个基类，所有需要授权的数据接口控制器都应当继承自它。`ApiBase`包含了`CurrentAppKey`属性，这个属性用来存储来访应用程序的身份标识，并在`OnActionExecuting`事件中分析Claims（声明）并将它们赋值，这样每个控制器都能访问到当前请求的权限信息。
`ApiActionFilterAttribute.cs`是自定义的过滤器，它扩展了`ActionFilterAttribute`，用于检查调用者对特定接口的访问权限。这确保了只有拥有正确Token的请求才能访问受保护的API。
`MiddleWares`目录下的`ApiCustomExcep`可能是自定义异常中间件，它处理在处理请求过程中可能出现的错误，提供统一的异常处理机制，确保了服务的健壮性。
这个实例代码不仅展示了如何在Asp.Net Core中实现JWT认证，还演示了如何使用自定义过滤器和异常处理中间件来增强API的安全性和稳定性。对于开发人员来说，这样的示例可以帮助他们快速理解和应用JWT认证到自己的项目中，提高安全性并简化身份验证流程。
Asp.Net Core基于基于JWT认证的数据接口网关实例代码认证的数据接口网关实例代码
主要给大家介绍了关于Asp.Net Core基于JWT认证的数据接口网关的相关资料，文中通过示例代码以及图文介绍的非常详细，对大家的学习或者使用Asp.net Core具有一定的参考
学习价值，需要的朋友们下面来一起学习学习吧
前言前言
近日，应一位朋友的邀请写了个Asp.Net Core基于JWT认证的数据接口网关Demo。朋友自己开了个公司，接到的一个升级项目，客户要求用Aps.Net Core做数据网关服务且基于JWT认证实现对前后端
分离的数据服务支持，于是想到我一直做.Net开发，问我是否对.Net Core有所了解？能不能做个简单Demo出来看看？我说，分道扬镳之后我不是调用别人的接口就是提供接口给别人调用，于是便有了
以下示例代码。
示例要求能演示获取Token及如何使用该Token访问数据资源，在Demo中实现了JWT的颁发及验证以及重写一个ActionAuthorizeAttribute实现对具体数据接口的调用权限控制，先看一下项目截图：
[项目截图]
项目文件介绍项目文件介绍
解决方案下只有一个项目，项目名称就叫Jwt.Gateway，包含主要文件有：
1. Controllers目录下的ApiActionFilterAttribute.cs文件，继承Microsoft.AspNetCore.Mvc.Filters.ActionFilterAttribute，用于校验接口调用者对具体接口的访问权限。
2. Controllers目录下的ApiBase.cs文件，继承Microsoft.AspNetCore.Mvc.Controller，具有Microsoft.AspNetCore.Authorization.Authorize特性引用，用于让所有数据接口用途的控制器继承，定义有
CurrentAppKey属性(来访应用程序的身份标识)并在OnActionExecuting事件中统一分析Claims并赋值。
3. Controllers目录下的TokenController.cs控制器文件，用于对调用方应用程序获取及注销Token。
4. Controllers目录下的UsersController.cs控制器文件，继承ApiBase.cs，作为数据调用示例。
5. MiddleWares目录下的ApiCustomException.cs文件，是一个数据接口的统一异常处理中间件。
6. Models目录下的ApiResponse.cs文件，用于做数据接口的统一数据及错误信息输出实体模型。
7. Models目录下的User.cs文件，示例数据实体模型。
8. Program.cs及Startup.cs文件就不介绍了，随便建个空项目都有。
项目文件代码项目文件代码
ApiActionFilterAttribute.cs
Controllers目录下的ApiActionFilterAttribute.cs文件，继承Microsoft.AspNetCore.Mvc.Filters.ActionFilterAttribute，用于校验接口调用者对具体接口的访问权限。
设想每一个到访的请求都是一个应用程序，每一个应用程序都分配有基本的Key和Password，每一个应用程序具有不同的接口访问权限，所以在具体的数据接口上应该声明该接口所要求的权限值，比如
修改用户信息的接口应该在接口方法上声明需要具有“修改用户”的权限，用例： [ApiActionFilter("用户修改")] 。
大部分情况下一个接口(方法)对应一个操作，这样基本上就能应付了，但是不排除有时候可能需要多个权限组合进行验证，所以该文件中有一个对多个权限值进行校验的“与”和“和”枚举，用例：
[ApiActionFilter(new string[] { "用户修改", "用户录入", "用户删除" },ApiActionFilterAttributeOption.AND)] ，这样好像就差不多了。
由于在一个接口调用之后可能需要将该接口所声明需要的权限值记入日志等需求，因此权限值集合将被写入到HttpContext.Items["Permissions"]中以方便可能的后续操作访问，看代码：
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc.Filters;
namespace Jwt.Gateway.Controllers
{
public enum ApiActionFilterAttributeOption
{
OR,AND
}
public class ApiActionFilterAttribute : Microsoft.AspNetCore.Mvc.Filters.ActionFilterAttribute
{
List<string> Permissions = new List<string>();
ApiActionFilterAttributeOption Option = ApiActionFilterAttributeOption.AND;
public ApiActionFilterAttribute(string permission)
{
Permissions.Add(permission);
}
public ApiActionFilterAttribute(string[] permissions, ApiActionFilterAttributeOption option)
{
foreach(var permission in permissions) {
if (Permissions.Contains(permission))
{
continue;
}
Permissions.Add(permission);
}
Option = option;
}
public override void OnActionExecuting(ActionExecutingContext context)
{
var key = GetAppKey(context);
List<string> keyPermissions = GetAppKeyPermissions(key);
var isAnd = Option == ApiActionFilterAttributeOption.AND;
var permissionsCount = Permissions.Count;
var keyPermissionsCount = keyPermissions.Count;
for (var i = 0; i < permissionsCount; i++)
{
bool flag = false;
for (var j = 0; j < keyPermissions.Count; j++)
{
if (flag = string.Equals(Permissions[i], keyPermissions[j], StringComparison.OrdinalIgnoreCase))
{
break;
}
}
if (flag)
{
continue;
}
if (isAnd)
{
throw new Exception("应用“" + key + "”缺少“" + Permissions[i] + "”的权限");
}
}
context.HttpContext.Items.Add("Permissions", Permissions);
base.OnActionExecuting(context);
}
private string GetAppKey(ActionExecutingContext context)
{
var claims = context.HttpContext.User.Claims;
if (claims == null)
{
throw new Exception("未能获取到应用标识");
}
var claimKey = claims.ToList().Find(o => string.Equals(o.Type, "AppKey", StringComparison.OrdinalIgnoreCase));
if (claimKey == null)
{
throw new Exception("未能获取到应用标识");
}
return claimKey.Value;
}
private List<string> GetAppKeyPermissions(string appKey)
下载后可阅读完整内容，剩余5页未读，立即下载
2019-08-15 上传
2022-09-26 上传
点击了解资源详情
2020-10-24 上传
2020-10-21 上传
2021-03-04 上传
2021-03-06 上传
点击了解资源详情
点击了解资源详情
