Files
AuraVPN/singbox-aura/aura/session/session_test.go
T
xah30 a070da0be9 feat(singbox-aura,tools): Go port of Aura UDP client + KAT bridge to Rust
Lays the foundation for sing-box mobile clients (Option B from
docs/sing-box.md): an independent Go module that speaks the AuraVPN wire
protocol byte-for-byte. Proof of equivalence is in KAT tests cross-loaded
from a Rust-side deterministic vector exporter.

- tools/export-kat (new Rust bin in workspace): captures a handshake +
  derived keys + a sealed datagram record + a knock token using seeded
  RNGs (rand::rngs::StdRng + ml-kem's *_deterministic public API), emits
  JSON. Reproducible byte-for-byte.
- singbox-aura/ (new Go module, ~3000 LOC, 22 files):
  - aura/frame: 5-byte protocol header + Frame{Data,Ping,Pong,Close,
    Control} + magic envelope (0xAA,0xAA,0xC0,0x01) — encode/decode
    matching aura-proto::frame.
  - aura/crypto: hybrid X25519 + ML-KEM-768 (stdlib crypto/ecdh +
    crypto/mlkem on Go 1.24+; falls back to circl on older Go via a
    documented swap), HKDF-SHA256 derive_session_keys, ChaCha20-Poly1305
    with the **LE(u64 counter) || [0;4]** nonce scheme that matches
    aura-crypto::AeadKey/AeadSession.
  - aura/handshake: client_handshake state machine reproducing protocol.md
    §6.2 exactly (CH→SH→ServerAuth→ClientAuth→Finished×2; transcript hash;
    ECDSA-P256 transcript signature; HMAC-SHA256 Finished).
  - aura/session: DatagramSender/Receiver + 64-wide sliding replay window.
  - aura/transport: reliable HS-adapter (DTLS-flight retransmit) + UDP
    datagram data path + 16-byte HMAC port-knock with ±1-minute window.
  - aura/outbound: sing-box-shaped shim (interface signatures only — sing-
    box upstream registration is one more step, documented in README).
  - cmd/aura-client: standalone Go binary; reads client.toml via
    pelletier/go-toml/v2 and connects to a real aura server. Validates
    end-to-end interop with the Rust side.
- KAT: 6 comparisons against Rust vectors — session_keys (HKDF), hybrid
  KEM ek/encaps roundtrip, c2s + s2c Finished HMAC, sealed datagram
  record at seq=2 (incl. 16-byte Poly1305 tag), knock token. All byte-
  for-byte.

Go: 29 tests across 5 packages, all green. Only deps: golang.org/x/crypto
and pelletier/go-toml/v2. Rust: 293 tests still green; tools/export-kat
added to workspace members.

v1 limits documented in singbox-aura/README.md: UDP-only (no TCP/QUIC
fallback yet), no cell padding / cover traffic, no relay/exit role, no
multi-hop, sing-box upstream-registration sketch (vendor sagernet/sing-box +
init() RegisterOutbound) for follow-up.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-27 21:14:23 +03:00

124 lines
2.9 KiB
Go

package session
import (
"bytes"
"errors"
"testing"
"github.com/aura/singbox-aura/aura/frame"
)
func TestReplayWindowBasicMonotonic(t *testing.T) {
w := NewReplay(2)
for _, s := range []uint64{2, 3, 4} {
if err := w.CheckAndSet(s); err != nil {
t.Fatalf("seq %d: unexpected %v", s, err)
}
}
for _, s := range []uint64{2, 3, 4} {
var e *ErrReplay
if err := w.CheckAndSet(s); !errors.As(err, &e) {
t.Fatalf("seq %d: want replay, got %v", s, err)
}
}
}
func TestReplayWindowOutOfOrderWithinWindow(t *testing.T) {
w := NewReplay(0)
if err := w.CheckAndSet(0); err != nil {
t.Fatal(err)
}
if err := w.CheckAndSet(10); err != nil {
t.Fatal(err)
}
if err := w.CheckAndSet(5); err != nil {
t.Fatalf("5 inside window: %v", err)
}
if err := w.CheckAndSet(5); err == nil {
t.Fatal("replay of 5 must be rejected")
}
if err := w.CheckAndSet(10); err == nil {
t.Fatal("replay of 10 must be rejected")
}
if err := w.CheckAndSet(11); err != nil {
t.Fatalf("new high 11: %v", err)
}
}
func TestReplayWindowRejectsTooOld(t *testing.T) {
w := NewReplay(0)
if err := w.CheckAndSet(0); err != nil {
t.Fatal(err)
}
if err := w.CheckAndSet(200); err != nil {
t.Fatal(err)
}
if err := w.CheckAndSet(1); err == nil {
t.Fatal("far below window must be rejected")
}
if err := w.CheckAndSet(200 - ReplayWindow); err == nil {
t.Fatal("at the floor of the window must be rejected")
}
if err := w.CheckAndSet(200 - ReplayWindow + 1); err != nil {
t.Fatalf("just inside window: %v", err)
}
}
func TestDatagramRoundtripReorderAndReplay(t *testing.T) {
key := make([]byte, 32)
for i := range key {
key[i] = 11
}
tx, err := NewDatagramSender(key, 2)
if err != nil {
t.Fatal(err)
}
rx, err := NewDatagramReceiver(key, 2)
if err != nil {
t.Fatal(err)
}
d0 := tx.Seal(&frame.Frame{Kind: frame.FrameData, StreamID: 0, Payload: []byte("pkt-a")})
d1 := tx.Seal(&frame.Frame{Kind: frame.FrameData, StreamID: 0, Payload: []byte("pkt-b")})
// Out-of-order delivery within the window.
gotB, err := rx.Open(d1)
if err != nil {
t.Fatalf("open d1: %v", err)
}
if gotB.Kind != frame.FrameData || string(gotB.Payload) != "pkt-b" {
t.Fatalf("d1: %+v", gotB)
}
gotA, err := rx.Open(d0)
if err != nil {
t.Fatalf("open d0: %v", err)
}
if string(gotA.Payload) != "pkt-a" {
t.Fatalf("d0: %+v", gotA)
}
if _, err := rx.Open(d1); err == nil {
t.Fatal("replay of d1 must be rejected")
}
bad := tx.Seal(&frame.Frame{Kind: frame.FramePing, Seq: 7})
bad[len(bad)-1] ^= 1
if _, err := rx.Open(bad); err == nil {
t.Fatal("tampered ciphertext must fail")
}
}
func TestSenderNextSeqAdvances(t *testing.T) {
tx, err := NewDatagramSender(bytes.Repeat([]byte{1}, 32), 2)
if err != nil {
t.Fatal(err)
}
if tx.NextSeq() != 2 {
t.Fatalf("initial next seq %d", tx.NextSeq())
}
_ = tx.Seal(&frame.Frame{Kind: frame.FramePing, Seq: 1})
if tx.NextSeq() != 3 {
t.Fatalf("after seal: %d", tx.NextSeq())
}
}