基本认证
Hertz 提供了 basic auth 的实现。
在 HTTP 中,基本认证(Basic access authentication)是一种用来允许网页浏览器或其他客户端程序在请求时提供用户名和密码形式的身份凭证的一种登录验证方式。
在基本认证中,请求包含一个格式为 Authorization: Basic <credentials>
的头部字段,其中 credentials 是用户名和密码的 Base64 编码,用一个冒号 :
连接。
Hertz 也提供了 basic auth 的 实现 ,参考了 gin 的 实现 。
导入
示例代码
配置
Hertz 通过使用中间件可以实现让网页浏览器或其他客户端程序在请求时提供用户名和密码形式作为身份凭证进行登录验证,Hertz 提供了两种函数帮助用户快速使用基本认证(Basic access authentication)功能,用户可以根据业务场景自行选择不同的函数进行使用。
上述示例代码中,只使用了基本配置函数 BasicAuth
,扩展配置函数 BasicAuthForRealm
的参数配置项如下:
注意: BasicAuth
是对 BasicAuthForRealm
的封装并提供了默认配置项。
参数 | 介绍 |
---|---|
accounts | Accounts 被定义为 map[string]string 类型,以键值对的形式存储用户名和密码 |
realm | 安全域字符串,默认值为 Authorization Required |
userKey | 认证通过后在上下文中设置的用户名所对应的键值,默认值为 user |
BasicAuth
basic_auth
中间件提供了 BasicAuth
用于在客户端对服务端发起请求时进行用户名密码形式的身份验证。
函数签名:
示例代码:
BasicAuthForRealm
basic_auth
中间件提供了 BasicAuthForRealm
用于在使用 BasicAuth
进行身份验证的基础上提供更多例如 Realm 等的扩展配置。
函数签名:
示例代码:
完整示例
完整用法示例详见 example
最后修改
January 14, 2025
: Update release-v0_12_0.md (#1205) (bd11c02)