完善不同加密方法的使用
This commit is contained in:
yun
+88
-7
@@ -1,18 +1,99 @@
|
||||
// Package sha1x 提供 SHA-1 摘要计算，以及十六进制/Base64 编码与流式、文件接口。
|
||||
//
|
||||
// # 安全警告
|
||||
//
|
||||
// SHA-1 已被证明无法抵抗碰撞攻击（SHAttered 等实际攻击已能在可控成本下构造碰撞），
|
||||
// 本包仅用于兼容旧系统或非安全用途（如 Git 对象名、旧版校验和），
|
||||
// 不可用于口令存储、口令派生、消息认证或数字签名。
|
||||
// 新代码请使用 sha256x、sha512x、sha3x 或 blake2x。
|
||||
package sha1x
|
||||
|
||||
import (
|
||||
"crypto/sha1"
|
||||
"encoding/base64"
|
||||
"encoding/hex"
|
||||
"fmt"
|
||||
"hash"
|
||||
"io"
|
||||
"os"
|
||||
)
|
||||
|
||||
func Sha1(s string) string {
|
||||
h := sha1.New()
|
||||
h.Write([]byte(s))
|
||||
const (
|
||||
// Size 是 SHA-1 摘要的字节数（20）。
|
||||
Size = sha1.Size
|
||||
// BlockSize 是 SHA-1 分组的字节数（64）。
|
||||
BlockSize = sha1.BlockSize
|
||||
)
|
||||
|
||||
bs := h.Sum(nil)
|
||||
return hex.EncodeToString(bs)
|
||||
// New 返回一个计算 SHA-1 摘要的 hash.Hash，可反复 Write 以流式处理数据。
|
||||
//
|
||||
// 安全警告：SHA-1 不安全，仅用于兼容旧系统或非安全用途（如校验和），不可用于口令或签名。
|
||||
func New() hash.Hash {
|
||||
return sha1.New()
|
||||
}
|
||||
|
||||
// return fmt.Sprintf("%x", bs)
|
||||
// Sum 返回 data 的 SHA-1 摘要（Size 字节原始数据）。
|
||||
//
|
||||
// 安全警告：SHA-1 不安全，仅用于兼容旧系统或非安全用途（如校验和），不可用于口令或签名。
|
||||
func Sum(data []byte) []byte {
|
||||
h := sha1.New()
|
||||
_, _ = h.Write(data)
|
||||
return h.Sum(nil)
|
||||
}
|
||||
|
||||
// return res
|
||||
// Hex 返回 data 的 SHA-1 摘要的小写十六进制字符串。
|
||||
//
|
||||
// 安全警告：SHA-1 不安全，仅用于兼容旧系统或非安全用途（如校验和），不可用于口令或签名。
|
||||
func Hex(data []byte) string {
|
||||
return hex.EncodeToString(Sum(data))
|
||||
}
|
||||
|
||||
// Base64 返回 data 的 SHA-1 摘要的标准 Base64 字符串。
|
||||
//
|
||||
// 安全警告：SHA-1 不安全，仅用于兼容旧系统或非安全用途（如校验和），不可用于口令或签名。
|
||||
func Base64(data []byte) string {
|
||||
return base64.StdEncoding.EncodeToString(Sum(data))
|
||||
}
|
||||
|
||||
// SumReader 读取 r 中的全部数据并返回其 SHA-1 摘要；读取失败时返回包装后的 error。
|
||||
//
|
||||
// 安全警告：SHA-1 不安全，仅用于兼容旧系统或非安全用途（如校验和），不可用于口令或签名。
|
||||
func SumReader(r io.Reader) ([]byte, error) {
|
||||
if r == nil {
|
||||
return nil, fmt.Errorf("sha1x: 读取器为 nil")
|
||||
}
|
||||
h := sha1.New()
|
||||
if _, err := io.Copy(h, r); err != nil {
|
||||
return nil, fmt.Errorf("sha1x: 读取数据失败: %w", err)
|
||||
}
|
||||
return h.Sum(nil), nil
|
||||
}
|
||||
|
||||
// HexReader 读取 r 中的全部数据并返回其 SHA-1 摘要的小写十六进制字符串。
|
||||
//
|
||||
// 安全警告：SHA-1 不安全，仅用于兼容旧系统或非安全用途（如校验和），不可用于口令或签名。
|
||||
func HexReader(r io.Reader) (string, error) {
|
||||
sum, err := SumReader(r)
|
||||
if err != nil {
|
||||
return "", err
|
||||
}
|
||||
return hex.EncodeToString(sum), nil
|
||||
}
|
||||
|
||||
// HexFile 计算 path 所指向文件的 SHA-1 摘要并返回小写十六进制字符串；
|
||||
// 文件不存在或读取失败时返回包装后的 error，不 panic。
|
||||
//
|
||||
// 安全警告：SHA-1 不安全，仅用于兼容旧系统或非安全用途（如校验和），不可用于口令或签名。
|
||||
func HexFile(path string) (string, error) {
|
||||
f, err := os.Open(path)
|
||||
if err != nil {
|
||||
return "", fmt.Errorf("sha1x: 打开文件 %q 失败: %w", path, err)
|
||||
}
|
||||
defer f.Close()
|
||||
|
||||
sum, err := SumReader(f)
|
||||
if err != nil {
|
||||
return "", fmt.Errorf("sha1x: 计算文件 %q 摘要失败: %w", path, err)
|
||||
}
|
||||
return hex.EncodeToString(sum), nil
|
||||
}
|
||||
|
||||
+169
-5
@@ -1,14 +1,178 @@
|
||||
package sha1x_test
|
||||
|
||||
import (
|
||||
"fmt"
|
||||
"bytes"
|
||||
"encoding/base64"
|
||||
"encoding/hex"
|
||||
"errors"
|
||||
"os"
|
||||
"path/filepath"
|
||||
"strings"
|
||||
"testing"
|
||||
|
||||
"code.yun.ink/pkg/encryptx/sha1x"
|
||||
)
|
||||
|
||||
func TestSha1(t *testing.T) {
|
||||
s := "sha1 this string"
|
||||
r := sha1x.Sha1(s)
|
||||
fmt.Println(r)
|
||||
// 测试向量来源：FIPS 180-1 / RFC 3174 附录 A，并经 Python 3 hashlib 独立复算确认。
|
||||
var vectors = []struct {
|
||||
name string
|
||||
input string
|
||||
want string
|
||||
}{
|
||||
{"空串", "", "da39a3ee5e6b4b0d3255bfef95601890afd80709"},
|
||||
{"abc", "abc", "a9993e364706816aba3e25717850c26c9cd0d89d"},
|
||||
{"message digest", "message digest", "c12252ceda8be8994d5fa0290a47231c1d16aae3"},
|
||||
{"The quick brown fox jumps over the lazy dog", "The quick brown fox jumps over the lazy dog", "2fd4e1c67a2d28fced849ee1bb76e7391b93eb12"},
|
||||
}
|
||||
|
||||
type failingReader struct{}
|
||||
|
||||
func (failingReader) Read([]byte) (int, error) { return 0, errors.New("模拟读取失败") }
|
||||
|
||||
func TestConstants(t *testing.T) {
|
||||
if sha1x.Size != 20 {
|
||||
t.Fatalf("Size = %d, 期望 20", sha1x.Size)
|
||||
}
|
||||
if sha1x.BlockSize != 64 {
|
||||
t.Fatalf("BlockSize = %d, 期望 64", sha1x.BlockSize)
|
||||
}
|
||||
}
|
||||
|
||||
func TestVectors(t *testing.T) {
|
||||
for _, v := range vectors {
|
||||
t.Run(v.name, func(t *testing.T) {
|
||||
data := []byte(v.input)
|
||||
sum := sha1x.Sum(data)
|
||||
if len(sum) != sha1x.Size {
|
||||
t.Fatalf("Sum 长度 = %d, 期望 %d", len(sum), sha1x.Size)
|
||||
}
|
||||
if got := hex.EncodeToString(sum); got != v.want {
|
||||
t.Errorf("Sum = %s, 期望 %s", got, v.want)
|
||||
}
|
||||
if got := sha1x.Hex(data); got != v.want {
|
||||
t.Errorf("Hex = %s, 期望 %s", got, v.want)
|
||||
}
|
||||
if want := base64.StdEncoding.EncodeToString(sum); sha1x.Base64(data) != want {
|
||||
t.Errorf("Base64 = %s, 期望 %s", sha1x.Base64(data), want)
|
||||
}
|
||||
h := sha1x.New()
|
||||
if _, err := h.Write(data); err != nil {
|
||||
t.Fatalf("Write 失败: %v", err)
|
||||
}
|
||||
if got := hex.EncodeToString(h.Sum(nil)); got != v.want {
|
||||
t.Errorf("New+Write = %s, 期望 %s", got, v.want)
|
||||
}
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
func TestStreamingMatchesSum(t *testing.T) {
|
||||
data := []byte(strings.Repeat("encryptx-sha1-", 100))
|
||||
h := sha1x.New()
|
||||
for i := 0; i < len(data); i += 13 {
|
||||
end := i + 13
|
||||
if end > len(data) {
|
||||
end = len(data)
|
||||
}
|
||||
if _, err := h.Write(data[i:end]); err != nil {
|
||||
t.Fatalf("Write 失败: %v", err)
|
||||
}
|
||||
}
|
||||
if got, want := h.Sum(nil), sha1x.Sum(data); !bytes.Equal(got, want) {
|
||||
t.Errorf("分块写入 = %x, 期望 %x", got, want)
|
||||
}
|
||||
}
|
||||
|
||||
func TestReaderConsistency(t *testing.T) {
|
||||
const s = "encryptx 一致性检查"
|
||||
sum, err := sha1x.SumReader(strings.NewReader(s))
|
||||
if err != nil {
|
||||
t.Fatalf("SumReader 失败: %v", err)
|
||||
}
|
||||
if want := sha1x.Sum([]byte(s)); !bytes.Equal(sum, want) {
|
||||
t.Errorf("SumReader = %x, 期望 %x", sum, want)
|
||||
}
|
||||
hexStr, err := sha1x.HexReader(strings.NewReader(s))
|
||||
if err != nil {
|
||||
t.Fatalf("HexReader 失败: %v", err)
|
||||
}
|
||||
if want := sha1x.Hex([]byte(s)); hexStr != want {
|
||||
t.Errorf("HexReader = %s, 期望 %s", hexStr, want)
|
||||
}
|
||||
}
|
||||
|
||||
func TestReaderErrors(t *testing.T) {
|
||||
if _, err := sha1x.SumReader(nil); err == nil {
|
||||
t.Fatal("nil 读取器应返回 error")
|
||||
}
|
||||
if _, err := sha1x.HexReader(nil); err == nil {
|
||||
t.Fatal("nil 读取器应返回 error")
|
||||
}
|
||||
if _, err := sha1x.SumReader(failingReader{}); err == nil {
|
||||
t.Fatal("读取失败时应返回 error")
|
||||
}
|
||||
}
|
||||
|
||||
func TestHexFile(t *testing.T) {
|
||||
dir := t.TempDir()
|
||||
content := []byte("文件内容 file content\n")
|
||||
path := filepath.Join(dir, "sample.bin")
|
||||
if err := os.WriteFile(path, content, 0o600); err != nil {
|
||||
t.Fatalf("写入测试文件失败: %v", err)
|
||||
}
|
||||
got, err := sha1x.HexFile(path)
|
||||
if err != nil {
|
||||
t.Fatalf("HexFile 失败: %v", err)
|
||||
}
|
||||
if want := sha1x.Hex(content); got != want {
|
||||
t.Errorf("HexFile = %s, 期望 %s", got, want)
|
||||
}
|
||||
}
|
||||
|
||||
func TestHexFileErrors(t *testing.T) {
|
||||
if _, err := sha1x.HexFile(filepath.Join(t.TempDir(), "不存在.bin")); err == nil {
|
||||
t.Fatal("不存在的文件应返回 error")
|
||||
}
|
||||
if _, err := sha1x.HexFile(""); err == nil {
|
||||
t.Fatal("空路径应返回 error")
|
||||
}
|
||||
if _, err := sha1x.HexFile(t.TempDir()); err == nil {
|
||||
t.Fatal("目录路径应返回 error")
|
||||
}
|
||||
}
|
||||
|
||||
func TestLargeInput(t *testing.T) {
|
||||
data := largeData(1 << 20)
|
||||
want := sha1x.Hex(data)
|
||||
if got := sha1x.Hex(data); got != want {
|
||||
t.Errorf("重复计算结果不一致: %s vs %s", got, want)
|
||||
}
|
||||
|
||||
got, err := sha1x.HexReader(bytes.NewReader(data))
|
||||
if err != nil {
|
||||
t.Fatalf("HexReader 失败: %v", err)
|
||||
}
|
||||
if got != want {
|
||||
t.Errorf("HexReader = %s, 期望 %s", got, want)
|
||||
}
|
||||
|
||||
h := sha1x.New()
|
||||
if _, err := h.Write(data[:1<<19]); err != nil {
|
||||
t.Fatalf("Write 失败: %v", err)
|
||||
}
|
||||
if _, err := h.Write(data[1<<19:]); err != nil {
|
||||
t.Fatalf("Write 失败: %v", err)
|
||||
}
|
||||
if got := hex.EncodeToString(h.Sum(nil)); got != want {
|
||||
t.Errorf("1MiB 分块 = %s, 期望 %s", got, want)
|
||||
}
|
||||
}
|
||||
|
||||
// largeData 生成确定性的 n 字节数据。
|
||||
func largeData(n int) []byte {
|
||||
b := make([]byte, n)
|
||||
for i := range b {
|
||||
b[i] = byte(i*31 + i/7)
|
||||
}
|
||||
return b
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user