github.com/qiniu/go-sdk/v7@v7.27.0/auth/doc.go (about)

     1  // Package auth 提供七牛云 API 的认证和签名功能。
     2  //
     3  // 通过 AK/SK（AccessKey/SecretKey）创建凭证，用于对 API 请求进行签名认证。
     4  // AK/SK 可从 https://portal.qiniu.com/user/key 获取。
     5  //
     6  // # 创建凭证
     7  //
     8  //	mac := auth.New("AccessKey", "SecretKey")
     9  //
    10  //	// 或从环境变量加载（QINIU_ACCESS_KEY、QINIU_SECRET_KEY）
    11  //	mac := auth.Default()
    12  //
    13  // # 签名方式
    14  //
    15  // 支持多种签名方式：
    16  //
    17  //   - [Credentials.Sign]: HMAC-SHA1 签名
    18  //   - [Credentials.SignRequest]: Qbox 格式请求签名
    19  //   - [Credentials.SignRequestV2]: Qiniu V2 格式请求签名
    20  //   - [Credentials.SignWithData]: 签名并包含编码数据（用于上传凭证）
    21  //   - [Credentials.VerifyCallback]: 验证回调请求签名
    22  //
    23  // # Context 传递凭证
    24  //
    25  // 支持通过 Context 传递凭证信息，适用于需要在调用链中传递认证的场景：
    26  //
    27  //	ctx = auth.WithCredentialsType(ctx, mac, auth.TokenQiniu)
    28  //	cred, tokenType, ok := auth.CredentialsFromContext(ctx)
    29  package auth