Projeto bot pontos

backend/internal/adapters/crypto/crypto_test.go

@@ -0,0 +1,83 @@
+package crypto
+
+import (
+	"strings"
+	"testing"
+)
+
+const (
+	keyA = "chave-de-teste-numero-um-com-32-caracteres!"
+	keyB = "chave-de-teste-numero-dois-com-32-caracteres"
+)
+
+func TestKeyringRoundTrip(t *testing.T) {
+	k, err := NewKeyring(keyA, 1, "", 0)
+	if err != nil {
+		t.Fatal(err)
+	}
+	data, version, err := k.Encrypt("senha-pontomais")
+	if err != nil || version != 1 {
+		t.Fatalf("Encrypt: version=%d err=%v", version, err)
+	}
+	if strings.Contains(string(data), "senha-pontomais") {
+		t.Fatal("texto cifrado contém a senha em claro")
+	}
+	plain, err := k.Decrypt(data, version)
+	if err != nil || plain != "senha-pontomais" {
+		t.Fatalf("Decrypt = %q, %v", plain, err)
+	}
+}
+
+func TestKeyringRotation(t *testing.T) {
+	old, _ := NewKeyring(keyA, 1, "", 0)
+	data, version, _ := old.Encrypt("segredo")
+
+	rotated, err := NewKeyring(keyB, 2, keyA, 1)
+	if err != nil {
+		t.Fatal(err)
+	}
+	if plain, err := rotated.Decrypt(data, version); err != nil || plain != "segredo" {
+		t.Fatalf("chave anterior deveria decifrar: %q, %v", plain, err)
+	}
+	if _, v, _ := rotated.Encrypt("novo"); v != 2 {
+		t.Fatalf("novas cifras deveriam usar a versão 2, usaram %d", v)
+	}
+	if _, err := rotated.Decrypt(data, 9); err == nil {
+		t.Fatal("versão desconhecida deveria falhar")
+	}
+}
+
+func TestKeyringRejectsShortKey(t *testing.T) {
+	if _, err := NewKeyring("curta", 1, "", 0); err == nil {
+		t.Fatal("chave curta deveria ser recusada")
+	}
+}
+
+func TestPasswordHash(t *testing.T) {
+	hash, err := HashPassword("senha-forte-do-painel")
+	if err != nil {
+		t.Fatal(err)
+	}
+	if !VerifyPassword(hash, "senha-forte-do-painel") {
+		t.Fatal("senha correta deveria conferir")
+	}
+	if VerifyPassword(hash, "senha-errada-do-painel") {
+		t.Fatal("senha errada não deveria conferir")
+	}
+	if _, err := HashPassword("curta"); err == nil {
+		t.Fatal("senha curta deveria ser recusada")
+	}
+}
+
+func TestToken(t *testing.T) {
+	token, hash, err := NewToken()
+	if err != nil {
+		t.Fatal(err)
+	}
+	if !ValidTokenFormat(token) || !TokenMatches(token, hash) {
+		t.Fatal("token gerado deveria ser válido e conferir com o hash")
+	}
+	if TokenMatches(token+"x", hash) {
+		t.Fatal("token alterado não deveria conferir")
+	}
+}

backend/internal/adapters/crypto/keyring.go

@@ -0,0 +1,90 @@
+// Package crypto cifra as senhas da PontoMais (AES-256-GCM), faz hash das
+// senhas do painel (Argon2id) e gera tokens de sessão.
+package crypto
+
+import (
+	"crypto/aes"
+	"crypto/cipher"
+	"crypto/rand"
+	"crypto/sha256"
+	"errors"
+	"fmt"
+	"io"
+)
+
+const MinKeyLength = 32
+
+var ErrUnknownKeyVersion = errors.New("versão de chave de criptografia desconhecida")
+
+// Keyring guarda a chave atual e, opcionalmente, a anterior. Cada senha cifrada
+// registra a versão usada (point_credentials.key_version), o que permite trocar
+// a chave sem perder as credenciais já gravadas (comando admin rotate-key).
+type Keyring struct {
+	current int16
+	keys    map[int16][]byte
+}
+
+// NewKeyring recebe o segredo atual e sua versão; previous é opcional (vazio = sem chave anterior).
+func NewKeyring(current string, currentVersion int16, previous string, previousVersion int16) (*Keyring, error) {
+	if len(current) < MinKeyLength {
+		return nil, fmt.Errorf("a chave de criptografia precisa ter pelo menos %d caracteres", MinKeyLength)
+	}
+	k := &Keyring{current: currentVersion, keys: map[int16][]byte{currentVersion: derive(current)}}
+	if previous != "" {
+		if previousVersion == currentVersion {
+			return nil, errors.New("a chave anterior precisa ter uma versão diferente da atual")
+		}
+		if len(previous) < MinKeyLength {
+			return nil, fmt.Errorf("a chave anterior precisa ter pelo menos %d caracteres", MinKeyLength)
+		}
+		k.keys[previousVersion] = derive(previous)
+	}
+	return k, nil
+}
+
+func derive(secret string) []byte {
+	sum := sha256.Sum256([]byte(secret))
+	return sum[:]
+}
+
+func (k *Keyring) CurrentVersion() int16 { return k.current }
+
+// Encrypt cifra com a chave atual e devolve nonce||ciphertext e a versão usada.
+func (k *Keyring) Encrypt(plain string) ([]byte, int16, error) {
+	gcm, err := newGCM(k.keys[k.current])
+	if err != nil {
+		return nil, 0, err
+	}
+	nonce := make([]byte, gcm.NonceSize())
+	if _, err := io.ReadFull(rand.Reader, nonce); err != nil {
+		return nil, 0, err
+	}
+	return gcm.Seal(nonce, nonce, []byte(plain), nil), k.current, nil
+}
+
+func (k *Keyring) Decrypt(data []byte, version int16) (string, error) {
+	key, ok := k.keys[version]
+	if !ok {
+		return "", fmt.Errorf("%w: %d", ErrUnknownKeyVersion, version)
+	}
+	gcm, err := newGCM(key)
+	if err != nil {
+		return "", err
+	}
+	if len(data) < gcm.NonceSize() {
+		return "", errors.New("credencial cifrada inválida")
+	}
+	plain, err := gcm.Open(nil, data[:gcm.NonceSize()], data[gcm.NonceSize():], nil)
+	if err != nil {
+		return "", errors.New("não foi possível decifrar a credencial (chave incorreta?)")
+	}
+	return string(plain), nil
+}
+
+func newGCM(key []byte) (cipher.AEAD, error) {
+	block, err := aes.NewCipher(key)
+	if err != nil {
+		return nil, err
+	}
+	return cipher.NewGCM(block)
+}

backend/internal/adapters/crypto/password.go

@@ -0,0 +1,107 @@
+package crypto
+
+import (
+	"crypto/rand"
+	"crypto/sha256"
+	"crypto/subtle"
+	"encoding/base64"
+	"fmt"
+	"strings"
+	"unicode/utf8"
+
+	"golang.org/x/crypto/argon2"
+)
+
+const (
+	MinPasswordLength = 12
+
+	argonMemory      = 64 * 1024
+	argonIterations  = 3
+	argonParallelism = 2
+	argonSaltLength  = 16
+	argonKeyLength   = 32
+)
+
+// ValidatePassword aplica a política mínima das senhas do painel.
+func ValidatePassword(password string) error {
+	if utf8.RuneCountInString(password) < MinPasswordLength {
+		return fmt.Errorf("a senha deve ter no mínimo %d caracteres", MinPasswordLength)
+	}
+	return nil
+}
+
+// HashPassword gera um hash Argon2id no formato PHC ($argon2id$v=19$m=...,t=...,p=...$salt$hash).
+func HashPassword(password string) (string, error) {
+	if err := ValidatePassword(password); err != nil {
+		return "", err
+	}
+	salt := make([]byte, argonSaltLength)
+	if _, err := rand.Read(salt); err != nil {
+		return "", err
+	}
+	hash := argon2.IDKey([]byte(password), salt, argonIterations, argonMemory, argonParallelism, argonKeyLength)
+	return fmt.Sprintf("$argon2id$v=19$m=%d,t=%d,p=%d$%s$%s",
+		argonMemory, argonIterations, argonParallelism,
+		base64.RawStdEncoding.EncodeToString(salt),
+		base64.RawStdEncoding.EncodeToString(hash)), nil
+}
+
+// VerifyPassword compara em tempo constante. Parâmetros fora de limites
+// razoáveis são recusados, para um hash adulterado não travar o servidor.
+func VerifyPassword(encoded, password string) bool {
+	parts := strings.Split(encoded, "$")
+	if len(parts) != 6 || parts[1] != "argon2id" || parts[2] != "v=19" {
+		return false
+	}
+	var memory, iterations uint32
+	var parallelism uint8
+	if _, err := fmt.Sscanf(parts[3], "m=%d,t=%d,p=%d", &memory, &iterations, &parallelism); err != nil {
+		return false
+	}
+	if memory < 8*1024 || memory > 256*1024 || iterations < 1 || iterations > 10 || parallelism < 1 || parallelism > 8 {
+		return false
+	}
+	salt, err := base64.RawStdEncoding.DecodeString(parts[4])
+	if err != nil || len(salt) < 8 {
+		return false
+	}
+	want, err := base64.RawStdEncoding.DecodeString(parts[5])
+	if err != nil || len(want) < 16 || len(want) > 64 {
+		return false
+	}
+	got := argon2.IDKey([]byte(password), salt, iterations, memory, parallelism, uint32(len(want)))
+	return subtle.ConstantTimeCompare(got, want) == 1
+}
+
+// DummyVerify gasta o mesmo tempo de uma verificação real; usado quando o
+// usuário não existe, para o tempo de resposta não revelar isso.
+func DummyVerify(password string) {
+	salt := sha256.Sum256([]byte("botpontos-dummy-salt"))
+	_ = argon2.IDKey([]byte(password), salt[:argonSaltLength], argonIterations, argonMemory, argonParallelism, argonKeyLength)
+}
+
+// NewToken gera um token aleatório (enviado ao navegador) e seu hash SHA-256 (gravado no banco).
+func NewToken() (token string, hash []byte, err error) {
+	raw := make([]byte, 32)
+	if _, err := rand.Read(raw); err != nil {
+		return "", nil, err
+	}
+	token = base64.RawURLEncoding.EncodeToString(raw)
+	return token, HashToken(token), nil
+}
+
+func HashToken(token string) []byte {
+	sum := sha256.Sum256([]byte(token))
+	return sum[:]
+}
+
+// ValidTokenFormat evita consultar o banco com valores claramente inválidos.
+func ValidTokenFormat(token string) bool {
+	raw, err := base64.RawURLEncoding.DecodeString(token)
+	return err == nil && len(raw) == 32
+}
+
+// TokenMatches compara um token recebido com o hash gravado, em tempo constante.
+func TokenMatches(token string, hash []byte) bool {
+	return subtle.ConstantTimeCompare(HashToken(token), hash) == 1
+}