Skip to content

An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作

15.1 KB
Raw Blame
// SiYuan - https://github.com/siyuan-note/siyuan
// Copyright (c) 2020-present, b3log.org
// SPDX-License-Identifier: AGPL-3.0-or-later

package crypto

import (
	"bytes"
	"encoding/base64"
	"encoding/json"
	"testing"
)

func TestGenerateAESKeyLengths(t *testing.T) {
	for _, length := range []int{128, 192, 256} {
		alg := Algorithm{Name: AlgAESGCM, Length: new(length)}
		pair, err := GenerateKey(alg, true, []KeyUsage{UsageEncrypt, UsageDecrypt})
		if err != nil {
			t.Fatalf("length %d: %v", length, err)
		}
		if len(pair.Secret.secret) != length/8 {
			t.Fatalf("length %d: key material = %d bytes", length, len(pair.Secret.secret))
		}
	}

	// 非法长度返回 OperationError,缺少 length 返回 TypeError。
	bad := Algorithm{Name: AlgAESGCM, Length: new(100)}
	if _, err := GenerateKey(bad, true, []KeyUsage{UsageEncrypt}); errorName(t, err) != ErrNameOperation {
		t.Fatalf("error = %v, want OperationError", err)
	}
	missing := Algorithm{Name: AlgAESGCM}
	if _, err := GenerateKey(missing, true, []KeyUsage{UsageEncrypt}); errorName(t, err) != ErrNameType {
		t.Fatalf("error = %v, want TypeError", err)
	}
}

func TestGenerateHMACKeyDefaultLength(t *testing.T) {
	// 未指定 length 时使用摘要算法的分组长度。
	cases := map[string]int{AlgSHA1: 512, AlgSHA256: 512, AlgSHA384: 1024, AlgSHA512: 1024}
	for hashName, want := range cases {
		alg := Algorithm{Name: AlgHMAC, Hash: hashName}
		pair, err := GenerateKey(alg, true, []KeyUsage{UsageSign})
		if err != nil {
			t.Fatalf("%s: %v", hashName, err)
		}
		if *pair.Secret.Algorithm.Length != want {
			t.Fatalf("%s: length = %d, want %d", hashName, *pair.Secret.Algorithm.Length, want)
		}
		if len(pair.Secret.secret) != want/8 {
			t.Fatalf("%s: key material = %d bytes, want %d", hashName, len(pair.Secret.secret), want/8)
		}
	}

	// 缺少 hash 返回 TypeError,length 为零返回 OperationError。
	if _, err := GenerateKey(Algorithm{Name: AlgHMAC}, true, []KeyUsage{UsageSign}); errorName(t, err) != ErrNameType {
		t.Fatalf("error = %v, want TypeError", err)
	}
	zero := Algorithm{Name: AlgHMAC, Hash: AlgSHA256, Length: new(0)}
	if _, err := GenerateKey(zero, true, []KeyUsage{UsageSign}); errorName(t, err) != ErrNameOperation {
		t.Fatalf("error = %v, want OperationError", err)
	}
}

func TestCheckUsagesRejectsDisallowedAndEmpty(t *testing.T) {
	// AES 密钥不能用于签名。
	alg := Algorithm{Name: AlgAESGCM, Length: new(128)}
	if _, err := GenerateKey(alg, true, []KeyUsage{UsageSign}); errorName(t, err) != ErrNameSyntax {
		t.Fatalf("error = %v, want SyntaxError", err)
	}

	// 对称密钥必须至少声明一种用法。
	if _, err := GenerateKey(alg, true, nil); errorName(t, err) != ErrNameSyntax {
		t.Fatalf("error = %v, want SyntaxError", err)
	}
}

func TestOperationsRequireMatchingKey(t *testing.T) {
	alg := Algorithm{Name: AlgAESGCM, IV: bytes.Repeat([]byte{1}, 12)}

	// 密钥未声明 encrypt 用法。
	key := newSecretKey(AlgAESGCM, "", bytes.Repeat([]byte{2}, 16), UsageDecrypt)
	if _, err := Encrypt(alg, key, nil); errorName(t, err) != ErrNameInvalidAccess {
		t.Fatalf("error = %v, want InvalidAccessError", err)
	}

	// 密钥算法与请求算法不一致。
	other := newSecretKey(AlgAESCBC, "", bytes.Repeat([]byte{2}, 16), UsageEncrypt)
	if _, err := Encrypt(alg, other, nil); errorName(t, err) != ErrNameInvalidAccess {
		t.Fatalf("error = %v, want InvalidAccessError", err)
	}

	// 缺少密钥。
	if _, err := Encrypt(alg, nil, nil); errorName(t, err) != ErrNameType {
		t.Fatalf("error = %v, want TypeError", err)
	}
}

func TestImportExportRawAES(t *testing.T) {
	secret := bytes.Repeat([]byte{5}, 32)
	alg := Algorithm{Name: AlgAESGCM}

	key, err := ImportKey(FormatRaw, KeyData{Raw: secret}, alg, true, []KeyUsage{UsageEncrypt})
	if err != nil {
		t.Fatal(err)
	}
	if *key.Algorithm.Length != 256 {
		t.Fatalf("length = %d, want 256", *key.Algorithm.Length)
	}

	data, err := ExportKey(FormatRaw, key)
	if err != nil {
		t.Fatal(err)
	}
	if !bytes.Equal(data.Raw, secret) {
		t.Fatalf("exported = %x, want %x", data.Raw, secret)
	}

	// 密钥长度非法。
	if _, err = ImportKey(FormatRaw, KeyData{Raw: secret[:20]}, alg, true, []KeyUsage{UsageEncrypt}); errorName(t, err) != ErrNameData {
		t.Fatalf("error = %v, want DataError", err)
	}

	// 规范的 AES 导入参数只有 name,参数中的 length 不参与导入,位长取自密钥数据。
	for _, other := range []Algorithm{
		{Name: AlgAESGCM, Length: new(128)},
		{Name: AlgAESCTR, Counter: make([]byte, 16), Length: new(64)},
	} {
		imported, importErr := ImportKey(FormatRaw, KeyData{Raw: secret}, other, true, []KeyUsage{UsageEncrypt})
		if importErr != nil {
			t.Fatalf("%s with length %d: %v", other.Name, *other.Length, importErr)
		}
		if *imported.Algorithm.Length != 256 {
			t.Fatalf("%s with length %d: key length = %d, want 256",
				other.Name, *other.Length, *imported.Algorithm.Length)
		}
	}
}

func TestImportHMACKeyLength(t *testing.T) {
	// 规范要求 length 不大于密钥材料位长,且大于位长减八,因此 64 位数据允许 57 到 64。
	raw := make([]byte, 8)
	cases := map[int]bool{64: true, 63: true, 57: true, 56: false, 65: false, 0: false}
	for length, ok := range cases {
		alg := Algorithm{Name: AlgHMAC, Hash: AlgSHA256, Length: new(length)}
		key, err := ImportKey(FormatRaw, KeyData{Raw: raw}, alg, true, []KeyUsage{UsageSign})
		if ok {
			if err != nil {
				t.Fatalf("length %d: %v", length, err)
			}
			if *key.Algorithm.Length != length {
				t.Fatalf("length %d: algorithm length = %d", length, *key.Algorithm.Length)
			}
			continue
		}
		if errorName(t, err) != ErrNameData {
			t.Fatalf("length %d: error = %v, want DataError", length, err)
		}
	}

	// 未指定 length 时使用密钥材料的位长。
	alg := Algorithm{Name: AlgHMAC, Hash: AlgSHA256}
	key, err := ImportKey(FormatRaw, KeyData{Raw: raw}, alg, true, []KeyUsage{UsageSign})
	if err != nil {
		t.Fatal(err)
	}
	if *key.Algorithm.Length != 64 {
		t.Fatalf("length = %d, want 64", *key.Algorithm.Length)
	}

	// 空密钥材料无效。
	if _, err = ImportKey(FormatRaw, KeyData{Raw: nil}, alg, true, []KeyUsage{UsageSign}); errorName(t, err) != ErrNameData {
		t.Fatalf("error = %v, want DataError", err)
	}
}

func TestKeyMaterialIsNotAliased(t *testing.T) {
	secret := bytes.Repeat([]byte{5}, 16)
	alg := Algorithm{Name: AlgAESGCM}

	key, err := ImportKey(FormatRaw, KeyData{Raw: secret}, alg, true, []KeyUsage{UsageEncrypt})
	if err != nil {
		t.Fatal(err)
	}

	// 修改导入时传入的切片不应影响密钥。
	secret[0] ^= 0xff
	if key.secret[0] != 5 {
		t.Fatal("import aliases the caller's key material")
	}

	// 修改导出结果也不应影响密钥。
	data, err := ExportKey(FormatRaw, key)
	if err != nil {
		t.Fatal(err)
	}
	data.Raw[0] ^= 0xff
	if key.secret[0] != 5 {
		t.Fatal("export aliases the key material")
	}
}

func TestExportKeyRequiresExtractable(t *testing.T) {
	key := newSecretKey(AlgAESGCM, "", bytes.Repeat([]byte{1}, 16), UsageEncrypt)
	key.Extractable = false

	if _, err := ExportKey(FormatRaw, key); errorName(t, err) != ErrNameInvalidAccess {
		t.Fatalf("error = %v, want InvalidAccessError", err)
	}
	if _, err := ExportKey(FormatJWK, key); errorName(t, err) != ErrNameInvalidAccess {
		t.Fatalf("error = %v, want InvalidAccessError", err)
	}
}

func TestJWKRoundTrip(t *testing.T) {
	// AES 密钥的 alg 取值与密钥位长相关。
	aesCases := map[string]string{
		AlgAESGCM: "A256GCM", AlgAESCBC: "A256CBC", AlgAESCTR: "A256CTR", AlgAESKW: "A256KW",
	}
	for algName, wantAlg := range aesCases {
		// AES-KW 只接受包装用法。
		usages := []KeyUsage{UsageEncrypt, UsageDecrypt}
		if algName == AlgAESKW {
			usages = []KeyUsage{UsageWrapKey, UsageUnwrapKey}
		}

		key := newSecretKey(algName, "", bytes.Repeat([]byte{3}, 32), usages...)
		data, err := ExportKey(FormatJWK, key)
		if err != nil {
			t.Fatalf("%s: %v", algName, err)
		}

		var jwk jsonWebKey
		if err = json.Unmarshal(data.JSON, &jwk); err != nil {
			t.Fatal(err)
		}
		if jwk.Kty != jwkKeyTypeOct || jwk.Alg != wantAlg {
			t.Fatalf("%s: kty = %q, alg = %q, want oct / %s", algName, jwk.Kty, jwk.Alg, wantAlg)
		}
		if jwk.Ext == nil || !*jwk.Ext {
			t.Fatalf("%s: ext = %v, want true", algName, jwk.Ext)
		}
		if len(jwk.KeyOps) != 2 {
			t.Fatalf("%s: key_ops = %v", algName, jwk.KeyOps)
		}

		imported, err := ImportKey(FormatJWK, KeyData{JSON: data.JSON},
			Algorithm{Name: algName}, true, usages)
		if err != nil {
			t.Fatalf("%s: %v", algName, err)
		}
		if !bytes.Equal(imported.secret, key.secret) {
			t.Fatalf("%s: key material changed", algName)
		}
	}

	// HMAC 的 alg 取值与摘要算法相关。
	hmacKey := newSecretKey(AlgHMAC, AlgSHA384, bytes.Repeat([]byte{4}, 48), UsageSign, UsageVerify)
	data, err := ExportKey(FormatJWK, hmacKey)
	if err != nil {
		t.Fatal(err)
	}
	var jwk jsonWebKey
	if err = json.Unmarshal(data.JSON, &jwk); err != nil {
		t.Fatal(err)
	}
	if jwk.Alg != "HS384" {
		t.Fatalf("alg = %q, want HS384", jwk.Alg)
	}
}

func TestJWKImportValidation(t *testing.T) {
	secret := base64.RawURLEncoding.EncodeToString(bytes.Repeat([]byte{7}, 16))
	alg := Algorithm{Name: AlgAESGCM}
	usages := []KeyUsage{UsageEncrypt}

	cases := []struct {
		label string
		jwk   string
		want  string
	}{
		{"invalid JSON", `{`, ErrNameData},
		{"missing kty", `{"k":"` + secret + `"}`, ErrNameData},
		{"wrong kty", `{"kty":"RSA"}`, ErrNameData},
		{"missing k", `{"kty":"oct"}`, ErrNameData},
		{"invalid base64url", `{"kty":"oct","k":"not base64!"}`, ErrNameData},
		{"non-extractable", `{"kty":"oct","k":"` + secret + `","ext":false}`, ErrNameData},
		{"key_ops mismatch", `{"kty":"oct","k":"` + secret + `","key_ops":["decrypt"]}`, ErrNameData},
		{"empty key_ops", `{"kty":"oct","k":"` + secret + `","key_ops":[]}`, ErrNameData},
		{"duplicate key_ops", `{"kty":"oct","k":"` + secret + `","key_ops":["encrypt","encrypt"]}`, ErrNameData},
		{"use mismatch", `{"kty":"oct","k":"` + secret + `","use":"sig"}`, ErrNameData},
		{"alg mismatch", `{"kty":"oct","k":"` + secret + `","alg":"A256GCM"}`, ErrNameData},
	}

	for _, c := range cases {
		_, err := ImportKey(FormatJWK, KeyData{JSON: []byte(c.jwk)}, alg, true, usages)
		if name := errorName(t, err); name != c.want {
			t.Errorf("%s: error name = %q, want %q", c.label, name, c.want)
		}
	}

	// 正确的 JWK 可以导入,alg 与 ext 相符。
	valid := `{"kty":"oct","k":"` + secret + `","alg":"A128GCM","ext":true,"key_ops":["encrypt","decrypt"]}`
	if _, err := ImportKey(FormatJWK, KeyData{JSON: []byte(valid)}, alg, true, usages); err != nil {
		t.Fatal(err)
	}

	// 缺少 key_ops 时不限制用法。
	withoutKeyOps := `{"kty":"oct","k":"` + secret + `"}`
	if _, err := ImportKey(FormatJWK, KeyData{JSON: []byte(withoutKeyOps)}, alg, true, usages); err != nil {
		t.Fatal(err)
	}
}

func TestJWKUseFollowsAlgorithm(t *testing.T) {
	rsa := func(name string) Algorithm {
		return Algorithm{Name: name, Hash: AlgSHA256, ModulusLength: new(2048), PublicExponent: []byte{1, 0, 1}}
	}

	// use 的取值由算法决定,与请求的用法无关。
	cases := []struct {
		alg      Algorithm
		generate []KeyUsage
		usages   []KeyUsage
		want     string
	}{
		{Algorithm{Name: AlgAESGCM, Length: new(128)}, []KeyUsage{UsageEncrypt}, []KeyUsage{UsageEncrypt}, "enc"},
		{Algorithm{Name: AlgAESKW, Length: new(128)}, []KeyUsage{UsageWrapKey}, []KeyUsage{UsageWrapKey}, "enc"},
		{Algorithm{Name: AlgAESECB, Length: new(128)}, []KeyUsage{UsageEncrypt}, []KeyUsage{UsageEncrypt}, "enc"},
		{Algorithm{Name: AlgHMAC, Hash: AlgSHA256}, []KeyUsage{UsageSign}, []KeyUsage{UsageSign}, "sig"},
		{rsa(AlgRSASSAPKCS1), []KeyUsage{UsageSign, UsageVerify}, []KeyUsage{UsageSign}, "sig"},
		{rsa(AlgRSAOAEP), []KeyUsage{UsageEncrypt, UsageDecrypt}, []KeyUsage{UsageDecrypt}, "enc"},
		{Algorithm{Name: AlgECDSA, NamedCurve: CurveP256}, []KeyUsage{UsageSign, UsageVerify}, []KeyUsage{UsageSign}, "sig"},
		{Algorithm{Name: AlgECDH, NamedCurve: CurveP256}, []KeyUsage{UsageDeriveBits}, []KeyUsage{UsageDeriveBits}, "enc"},
		{Algorithm{Name: AlgEd25519}, []KeyUsage{UsageSign, UsageVerify}, []KeyUsage{UsageSign}, "sig"},
		{Algorithm{Name: AlgX25519}, []KeyUsage{UsageDeriveBits}, []KeyUsage{UsageDeriveBits}, "enc"},
	}

	for _, c := range cases {
		pair, err := GenerateKey(c.alg, true, c.generate)
		if err != nil {
			t.Fatalf("%s: %v", c.alg.Name, err)
		}
		key := pair.Secret
		if key == nil {
			key = pair.PrivateKey
		}
		data, err := ExportKey(FormatJWK, key)
		if err != nil {
			t.Fatalf("%s: %v", c.alg.Name, err)
		}
		var jwk map[string]any
		if err = json.Unmarshal(data.JSON, &jwk); err != nil {
			t.Fatal(err)
		}
		// 去掉 key_ops,只观察 use 的校验。
		delete(jwk, "key_ops")

		wrong := "sig"
		if c.want == "sig" {
			wrong = "enc"
		}
		// 空串同样是存在的成员,必须参与校验。
		for _, entry := range []struct {
			use  string
			want string
		}{{c.want, ""}, {wrong, ErrNameData}, {"", ErrNameData}} {
			jwk["use"] = entry.use
			encoded, marshalErr := json.Marshal(jwk)
			if marshalErr != nil {
				t.Fatal(marshalErr)
			}
			_, err = ImportKey(FormatJWK, KeyData{JSON: encoded}, c.alg, true, c.usages)
			if entry.want == "" {
				if err != nil {
					t.Errorf("%s use %q: %v", c.alg.Name, entry.use, err)
				}
				continue
			}
			if name := errorName(t, err); name != entry.want {
				t.Errorf("%s use %q: error name = %q, want %q", c.alg.Name, entry.use, name, entry.want)
			}
		}
	}

	// 未请求任何用法时不校验 use,没有用法的 ECDH 公钥带 sig 仍可导入。
	pair, err := GenerateKey(Algorithm{Name: AlgECDH, NamedCurve: CurveP256}, true, []KeyUsage{UsageDeriveBits})
	if err != nil {
		t.Fatal(err)
	}
	data, err := ExportKey(FormatJWK, pair.PublicKey)
	if err != nil {
		t.Fatal(err)
	}
	var jwk map[string]any
	if err = json.Unmarshal(data.JSON, &jwk); err != nil {
		t.Fatal(err)
	}
	jwk["use"] = "sig"
	encoded, err := json.Marshal(jwk)
	if err != nil {
		t.Fatal(err)
	}
	if _, err = ImportKey(FormatJWK, KeyData{JSON: encoded}, Algorithm{Name: AlgECDH, NamedCurve: CurveP256},
		true, []KeyUsage{}); err != nil {
		t.Fatal(err)
	}
}

func TestWrapKeyRoundTrip(t *testing.T) {
	wrappingKey := newSecretKey(AlgAESGCM, "", bytes.Repeat([]byte{1}, 32), UsageWrapKey, UsageUnwrapKey)
	target := newSecretKey(AlgAESCBC, "", bytes.Repeat([]byte{2}, 16), UsageEncrypt, UsageDecrypt)
	alg := Algorithm{Name: AlgAESGCM, IV: bytes.Repeat([]byte{3}, 12)}

	for _, format := range []KeyFormat{FormatRaw, FormatJWK} {
		wrapped, err := WrapKey(format, target, wrappingKey, alg)
		if err != nil {
			t.Fatalf("%s: %v", format, err)
		}

		unwrapped, err := UnwrapKey(format, wrapped, wrappingKey, alg,
			Algorithm{Name: AlgAESCBC}, true, []KeyUsage{UsageEncrypt, UsageDecrypt})
		if err != nil {
			t.Fatalf("%s: %v", format, err)
		}
		if !bytes.Equal(unwrapped.secret, target.secret) {
			t.Fatalf("%s: unwrapped key material differs", format)
		}
	}

	// 不可导出的密钥不能被包装。
	target.Extractable = false
	if _, err := WrapKey(FormatRaw, target, wrappingKey, alg); errorName(t, err) != ErrNameInvalidAccess {
		t.Fatalf("error = %v, want InvalidAccessError", err)
	}

	// 包装密钥未声明 wrapKey 用法。
	target.Extractable = true
	plain := newSecretKey(AlgAESGCM, "", bytes.Repeat([]byte{1}, 32), UsageEncrypt)
	if _, err := WrapKey(FormatRaw, target, plain, alg); errorName(t, err) != ErrNameInvalidAccess {
		t.Fatalf("error = %v, want InvalidAccessError", err)
	}
}