Go 中实现 HTTP Basic Auth 的完整指南-Golang-PHP中文网

Go 中实现 HTTP Basic Auth 的完整指南

心靈之曲

发布： 2025-10-11 10:12:49

原创

297人浏览过

go 中实现 http basic auth 的完整指南

本文详细介绍了如何在 Go 语言中实现 HTTP Basic Authentication。首先，我们将了解 Basic Auth 的基本原理，然后提供示例代码演示如何使用 `net/http` 包发送带有 Basic Auth 头的请求。同时，我们还将讨论处理重定向时可能遇到的问题，并提供解决方案，确保认证信息在重定向过程中不会丢失。通过学习本文，你将能够轻松地在 Go 项目中实现安全的身份验证。

HTTP Basic Authentication 是一种简单的身份验证方案，客户端通过在 HTTP 请求头中包含 Authorization 字段来提供用户名和密码。本文将指导你如何在 Go 语言中实现这种认证方式，并处理一些常见问题。

Basic Auth 的原理

Basic Auth 的原理很简单：

客户端将用户名和密码组合成 username:password 的字符串。
客户端对该字符串进行 Base64 编码。
客户端将编码后的字符串添加到 HTTP 请求头的 Authorization 字段中，格式为 Basic <encoded_string>。
服务器接收到请求后，解码 Authorization 字段，验证用户名和密码。

使用 net/http 包实现 Basic Auth

Go 语言的 net/http 包提供了方便的 API 来发送 HTTP 请求并设置请求头。以下是一个简单的示例，演示了如何使用 net/http 包实现 Basic Auth：

package main

import (
    "encoding/base64"
    "fmt"
    "io/ioutil"
    "log"
    "net/http"
)

// basicAuth 生成 Basic Auth 字符串
func basicAuth(username, password string) string {
    auth := username + ":" + password
    return base64.StdEncoding.EncodeToString([]byte(auth))
}

func main() {
    username := "your_username"
    password := "your_password"
    url := "http://your_domain.com/protected_resource"

    client := &http.Client{}
    req, err := http.NewRequest("GET", url, nil)
    if err != nil {
        log.Fatal(err)
    }

    req.Header.Add("Authorization", "Basic "+basicAuth(username, password))

    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()

    bodyText, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }

    fmt.Printf("%s\n", string(bodyText))
}

登录后复制

代码解释：

basicAuth 函数接收用户名和密码作为参数，生成 Base64 编码的 Basic Auth 字符串。
http.NewRequest 创建一个新的 HTTP 请求。
req.Header.Add 将 Authorization 头添加到请求中。
client.Do 发送请求并接收响应。
ioutil.ReadAll 读取响应体。

注意事项：

请将 your_username、your_password 和 http://your_domain.com/protected_resource 替换为实际的值。
在生产环境中，请务必使用 HTTPS 来保护用户名和密码的安全。

处理重定向

当服务器返回重定向响应（例如 301 或 302）时，net/http 包默认会跟随重定向。但是，默认情况下，net/http 包会丢弃 Authorization 头。这意味着如果服务器在重定向后的地址也需要 Basic Auth，则认证将失败。

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

为了解决这个问题，我们需要自定义重定向策略，在重定向时手动添加 Authorization 头。

package main

import (
    "encoding/base64"
    "fmt"
    "io/ioutil"
    "log"
    "net/http"
    "net/http/cookiejar"
)

// basicAuth 生成 Basic Auth 字符串
func basicAuth(username, password string) string {
    auth := username + ":" + password
    return base64.StdEncoding.EncodeToString([]byte(auth))
}

// redirectPolicyFunc 是自定义的重定向策略
func redirectPolicyFunc(req *http.Request, via []*http.Request) error {
    // 将 Authorization 头添加到重定向请求中
    if len(via) > 0 {
        req.Header.Add("Authorization", "Basic "+basicAuth("your_username", "your_password"))
    }
    return nil
}

func main() {
    username := "your_username"
    password := "your_password"
    url := "http://your_domain.com/protected_resource"

    // 创建一个 cookie jar，用于处理 cookie
    cookieJar, _ := cookiejar.New(nil)

    // 创建一个带有自定义重定向策略的 HTTP 客户端
    client := &http.Client{
        Jar:           cookieJar,
        CheckRedirect: redirectPolicyFunc,
    }

    req, err := http.NewRequest("GET", url, nil)
    if err != nil {
        log.Fatal(err)
    }

    // 首次请求添加 Authorization 头
    req.Header.Add("Authorization", "Basic "+basicAuth(username, password))

    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()

    bodyText, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }

    fmt.Printf("%s\n", string(bodyText))
}

登录后复制

代码解释：

redirectPolicyFunc 函数是一个自定义的重定向策略函数。它接收重定向请求和之前的请求列表作为参数。
在 redirectPolicyFunc 函数中，我们检查 via 列表的长度，如果大于 0，则表示发生了重定向。然后，我们将 Authorization 头添加到重定向请求中。
我们创建了一个带有自定义重定向策略的 HTTP 客户端。
首次请求也需要添加 Authorization 头。

注意事项：

请将 your_username、your_password 和 http://your_domain.com/protected_resource 替换为实际的值。
在生产环境中，请务必使用 HTTPS 来保护用户名和密码的安全。
创建 cookieJar 可以处理服务器返回的 Cookie，某些需要登录的网站可能会用到。

总结

本文介绍了如何在 Go 语言中实现 HTTP Basic Authentication。我们学习了 Basic Auth 的基本原理，并提供了示例代码演示如何使用 net/http 包发送带有 Basic Auth 头的请求。同时，我们还讨论了处理重定向时可能遇到的问题，并提供了解决方案，确保认证信息在重定向过程中不会丢失。

通过学习本文，你将能够轻松地在 Go 项目中实现安全的身份验证。记住，在生产环境中，请务必使用 HTTPS 来保护用户名和密码的安全。

以上就是Go 中实现 HTTP Basic Auth 的完整指南的详细内容，更多请关注php中文网其它相关文章！