HTTP API 认证技术详解（二）：Digest Access Authentication

什么是 Digest Access Authentication 认证

Digest Access Authentication 认证的原理

Digest Access Authentication 认证的安全性

使用 Golang 实现 Digest Access Authentication

使用建议

小结

HTTP API 认证技术主要用于验证客户端身份，并确保只有经过授权的实体才能访问受保护的资源。随着安全需求的日益增长，API 认证技术也在不断发展和演进。本文将详细讲解 Digest Access Authentication 认证技术。

什么是 Digest Access Authentication 认证

Digest Access Authentication 是一种基于 HTTP 协议的身份验证机制，通过数字摘要来验证用户的身份，相较于基本认证（Basic Authentication）使用用户名密码的方式，提供了更高的安全性和灵活性。在 Digest 认证中，不会直接发送密码，而是发送摘要信息，这样即使在非安全的通道上也不会因被截获数据而泄露密码。

Digest Access Authentication 认证的原理

Digest Access Authentication 认证使用一种挑战-响应机制来进行身份验证。当用户尝试访问受保护的资源时，服务器会向客户端发送一个挑战（challenge），要求客户端提供有效的身份验证信息。客户端收到挑战后，使用用户的凭证和约定的摘要算法生成摘要信息。客户端将摘要信息随请求内容发送给服务器，服务器使用相同的密钥对响应进行验证。Digest 认证的流程通常如下：

客户端请求: 客户端发起请求到服务器。
服务器返回一个认证挑战，返回 401 Unauthorized 状态码及 WWW-Authenticate 头，其中包含认证类型（"Digest"）、随机生成的 nonce 值以及其他必要参数如 realm 等。WWW-Authenticate 的值示例如下：

Digest realm="myrealm", qop="auth", nonce="unique-nonce", opaque="0000000000000000"

客户端响应: 客户端收到对应的相应信息后，使用用户名、密码、nonce、请求方法、请求的 URI 和其他参数计算一个摘要，并将其与认证请求一起发送给服务器。header 中 Authorization 的值示例如下：

Digest username="user1", realm="myrealm", nonce="dcd98b7102dd2f0e8b11d0f600bfb0c093", uri="/protected", qop=auth, nc=00000001, cnonce="0a4f113b", response="dd51a70556e6a3342945ef0feac79afb", opaque=""

服务器验证: 服务器使用存储的密码和客户端发送的参数计算摘要，如果与客户端发送的摘要匹配，则认证成功。

Digest Access Authentication 认证的安全性

Digest Access Authentication 认证方式与 Basic Authentication 认证方式相比安全更高，因为：

不会发送明文密码。
可以使用随机数防止重放攻击。
可以结合使用质询/响应机制进一步提高安全性。

但是 Digest Access Authentication 认证并方式不是完全安全的，依然存在以下缺陷：

如果摘要数据被攻击者截获，密码可能会被离线破解。
不提供消息完整性和机密性保护，因此最好与 HTTPS 结合使用。

使用 Golang 实现 Digest Access Authentication

服务端简单示例代码如下：

package mainimport ("crypto/md5""fmt""io""net/http""strings"
)const (// 为了举例的目的，暂时先写死，实际编码中不要写死Realm    = "myrealm"QOP      = "auth"Nonce    = "dcd98b7102dd2f0e8b11d0f600bfb0c093"Opaque   = "5ccc069c403ebaf9f0171e9517f40e41"User     = "user1"Password = "mypassword"
)func computeMD5Hash(text string) string {hasher := md5.New()io.WriteString(hasher, text)return fmt.Sprintf("%x", hasher.Sum(nil))
}func parseAuthorizationHeader(header string) (username, realm, nonce, uri, qop, nc, cnonce, response string) {fields := strings.Split(header[6:], ", ")parts := make(map[string]string)for _, field := range fields {pair := strings.SplitN(field, "=", 2)if len(pair) == 2 {fmt.Println(strings.TrimSpace(pair[0]))parts[strings.TrimSpace(pair[0])] = strings.Trim(pair[1], `"`)}}return parts["username"], parts["realm"], parts["nonce"], parts["uri"], parts["qop"], parts["nc"], parts["cnonce"], parts["response"]
}func checkAuth(r *http.Request) bool {authHeader := r.Header.Get("Authorization")if authHeader == "" {return false}username, realm, nonce, uri, qop, nc, cnonce, response := parseAuthorizationHeader(authHeader)// HA1 = MD5(username:realm:password)HA1 := computeMD5Hash(fmt.Sprintf("%s:%s:%s", username, realm, Password))// HA2 = MD5(method:digestURI)HA2 := computeMD5Hash(fmt.Sprintf("%s:%s", r.Method, uri))// response = MD5(HA1:nonce:nonceCount:cnonce:qop:HA2)validResponse := computeMD5Hash(fmt.Sprintf("%s:%s:%s:%s:%s:%s", HA1, nonce, nc, cnonce, qop, HA2))return response == validResponse
}func protectedHandler(w http.ResponseWriter, r *http.Request) {if checkAuth(r) {w.Write([]byte("You're in the protected area"))} else {w.Header().Set("WWW-Authenticate", fmt.Sprintf(`Digest realm="%s", qop="%s", nonce="%s", opaque="%s"`, Realm, QOP, Nonce, Opaque))w.WriteHeader(http.StatusUnauthorized)w.Write([]byte("401 Unauthorized\n"))}
}func main() {http.HandleFunc("/protected", protectedHandler)http.ListenAndServe(":8080", nil)
}

使用 Golang 模拟客户端代码如下：

package mainimport ("crypto/md5""fmt""io""net/http"
)const (Username = "user1"Password = "mypassword"Realm    = "myrealm"Nonce    = "dcd98b7102dd2f0e8b11d0f600bfb0c093"NC       = "00000001"CNonce   = "0a4f113b"QOP      = "auth"URI      = "/protected"Method   = "GET"
)func computeMD5Hash(text string) string {hasher := md5.New()io.WriteString(hasher, text)return fmt.Sprintf("%x", hasher.Sum(nil))
}func createDigestAuthorizationHeader() string {// HA1 = MD5(username:realm:password)HA1 := computeMD5Hash(fmt.Sprintf("%s:%s:%s", Username, Realm, Password))// HA2 = MD5(method:URI)HA2 := computeMD5Hash(fmt.Sprintf("%s:%s", Method, URI))// response = MD5(HA1:nonce:NC:cnonce:qop:HA2)response := computeMD5Hash(fmt.Sprintf("%s:%s:%s:%s:%s:%s", HA1, Nonce, NC, CNonce, QOP, HA2))return fmt.Sprintf(`Digest username="%s", realm="%s", nonce="%s", uri="%s", qop=%s, nc=%s, cnonce="%s", response="%s", opaque=""`,Username, Realm, Nonce, URI, QOP, NC, CNonce, response)
}func main() {client := &http.Client{}req, err := http.NewRequest(Method, "http://localhost:8080"+URI, nil)if err != nil {panic(err)}fmt.Println(createDigestAuthorizationHeader())req.Header.Set("Authorization", createDigestAuthorizationHeader())resp, err := client.Do(req)if err != nil {panic(err)}defer resp.Body.Close()if resp.StatusCode == http.StatusOK {fmt.Println("Successfully authenticated.")} else {fmt.Println("Failed to authenticate.")}
}

先运行服务端代码，在运行客户端代码可以发现验证成功。

使用建议

Digest Access Authentication 认证方式相比 Basic Authentication 认证方式的安全性有一定的增强，但也不建议使用。如果非要使用的话，仅限于以下几种对安全要求不是特别高的场景：

简单的内部应用：如果你正在开发一个只有少数用户使用的内部工具，而这些用户都是可信的，那么 Basic Authentication 可以作为一个简单的解决方案。
快速原型开发：在初期的开发阶段，当需要快速实现认证机制的时候，Basic Authentication 可以作为一种临时措施。
服务端之间的通信：当两个服务端之间需要进行简单的身份验证时，可以使用 Basic Authentication，最好是双方都处于安全的内部网络中。
对于安全性要求不太高的系统，但又想要比基本认证更安全的场景

如果真的采用了 Digest Access Authentication 认证方式，可以考虑添加如下增强措施：