ASP.NET Core Authentication系列(三)Cookie选项
前言
在本系列第一篇文章介绍了ASP.NET时代如何认证,并且介绍了如何通过web.config文件来配置Auth Cookie的选项。
第二篇文章介绍了如何使用Cookie认证,本文介绍几个常见的Cookie选项及其用法。
CookieBuilder
Cookie选项设置主要在AddCookie
的CookieAuthenticationOptions.Cookie
:
services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)
.AddCookie(options =>
{
options.Cookie.Name = "Name"; // 设置Cookie名称
options.Cookie.Expiration = new TimeSpan(1, 0, 0); // 有效期1小时
options.Cookie.Domain = ".91suke.com"; // 设置Cookie域名
});
下面我们具体看一下CookieAuthenticationOptions.Cookie
的结构:
namespace Microsoft.AspNetCore.Http
{
public class CookieBuilder
{
public CookieBuilder();
public virtual string Domain { get; set; }
public virtual TimeSpan? Expiration { get; set; }
public virtual bool HttpOnly { get; set; }
public virtual bool IsEssential { get; set; }
public virtual TimeSpan? MaxAge { get; set; }
public virtual string Name { get; set; }
public virtual string Path { get; set; }
public virtual SameSiteMode SameSite { get; set; }
public virtual CookieSecurePolicy SecurePolicy { get; set; }
public CookieOptions Build(HttpContext context);
public virtual CookieOptions Build(HttpContext context, DateTimeOffset expiresFrom);
}
}
常用的几个选项:
- Domain:Cookie域名,只有相同域名(或子域名)才会携带Cookie
- Expiration:Cookie有效期
- Name:Cookie名称
- Path:Cookie路径,只有访问路径下的子路径才会携带Cookie
- HttpOnly:此属性为true,则只有在http请求头中会带有此cookie的信息,而不能通过document.cookie来访问此cookie。
通过Configuration来设置Cookie选项
在实际开发中,一般不会对选项或配置项硬编码,因为开发环境与生产环境会有差异。这时候一般会通过配置文件来管理配置项,这样不需要重新编译。
在appsettings.json
里添加配置项:
{
// other configuration
"Cookie":{
"Name" : "TestCookie",
"Path": "/"
}
// other configuration
}
然后在Startup
里设置:
services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)
.AddCookie(options =>
{
Configuration.GetSection("Cookie").Bind(options.Cookie);
});
效果图:
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】凌霞软件回馈社区,博客园 & 1Panel & Halo 联合会员上线
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】博客园社区专享云产品让利特惠,阿里云新客6.5折上折
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· C++代码改造为UTF-8编码问题的总结
· DeepSeek 解答了困扰我五年的技术问题
· 为什么说在企业级应用开发中,后端往往是效率杀手?
· 用 C# 插值字符串处理器写一个 sscanf
· Java 中堆内存和栈内存上的数据分布和特点
· 为DeepSeek添加本地知识库
· 精选4款基于.NET开源、功能强大的通讯调试工具
· DeepSeek智能编程
· 大模型工具KTransformer的安装
· [计算机/硬件/GPU] 显卡