Files
team-api/internal/utility/crypto/crypto.go
T
2026-05-10 12:21:27 +08:00

118 lines
2.9 KiB
Go

package crypto
import (
"crypto/aes"
"crypto/cipher"
"crypto/rand"
"encoding/base64"
"encoding/hex"
"errors"
"fmt"
"io"
)
var (
ErrInvalidCiphertext = errors.New("invalid ciphertext")
ErrInvalidKeyLength = errors.New("key must be 32 bytes for AES-256")
)
// Encrypt encrypts plaintext using AES-256-GCM.
// Returns base64-encoded ciphertext (nonce prepended).
func Encrypt(key, plaintext []byte) (string, error) {
if len(key) != 32 {
return "", ErrInvalidKeyLength
}
block, err := aes.NewCipher(key)
if err != nil {
return "", fmt.Errorf("create cipher: %w", err)
}
gcm, err := cipher.NewGCM(block)
if err != nil {
return "", fmt.Errorf("create gcm: %w", err)
}
nonce := make([]byte, gcm.NonceSize())
if _, err := io.ReadFull(rand.Reader, nonce); err != nil {
return "", fmt.Errorf("generate nonce: %w", err)
}
ciphertext := gcm.Seal(nonce, nonce, plaintext, nil)
return base64.StdEncoding.EncodeToString(ciphertext), nil
}
// Decrypt decrypts base64-encoded AES-256-GCM ciphertext.
func Decrypt(key []byte, encoded string) ([]byte, error) {
if len(key) != 32 {
return nil, ErrInvalidKeyLength
}
ciphertext, err := base64.StdEncoding.DecodeString(encoded)
if err != nil {
return nil, fmt.Errorf("decode base64: %w", err)
}
block, err := aes.NewCipher(key)
if err != nil {
return nil, fmt.Errorf("create cipher: %w", err)
}
gcm, err := cipher.NewGCM(block)
if err != nil {
return nil, fmt.Errorf("create gcm: %w", err)
}
nonceSize := gcm.NonceSize()
if len(ciphertext) < nonceSize {
return nil, ErrInvalidCiphertext
}
nonce, ciphertext := ciphertext[:nonceSize], ciphertext[nonceSize:]
plaintext, err := gcm.Open(nil, nonce, ciphertext, nil)
if err != nil {
return nil, fmt.Errorf("decrypt: %w", err)
}
return plaintext, nil
}
// EncryptString is a convenience wrapper for string input/output.
func EncryptString(key []byte, plaintext string) (string, error) {
return Encrypt(key, []byte(plaintext))
}
// DecryptString is a convenience wrapper for string input/output.
func DecryptString(key []byte, encoded string) (string, error) {
plain, err := Decrypt(key, encoded)
if err != nil {
return "", err
}
return string(plain), nil
}
// MustGetEncryptionKey returns the encryption key from a hex-encoded string.
// Panics if the key is invalid.
func MustGetEncryptionKey(hexKey string) []byte {
key, err := hex.DecodeString(hexKey)
if err != nil {
panic(fmt.Sprintf("invalid encryption key hex: %v", err))
}
if len(key) != 32 {
panic(fmt.Sprintf("encryption key must be 32 bytes, got %d", len(key)))
}
return key
}
// HashPassword hashes a password using bcrypt.
// This is a convenience wrapper to keep crypto utilities together.
func HashPassword(password string) (string, error) {
// Use Go's standard library bcrypt
return hashPasswordBcrypt(password)
}
// VerifyPassword verifies a password against a bcrypt hash.
func VerifyPassword(password, hash string) bool {
return verifyPasswordBcrypt(password, hash)
}