shadow.enabled in housecarl.yaml loads Housecarl's ruleset so that it blocks, rejects and translates nothing: drops and rejects count and accept (an accept only ends Housecarl's chain), policies accept and log what they would drop, NAT only counts, MSS clamping and the flowtable are left out, and raw rules that do more than accept, drop or reject are left out with a warning. Comments mark what would happen ([would drop]). Filter chains run after the other firewall's (+10) or before (-10); NAT chains always first. Every change is checked by nftables in both forms. No probation; takeovers and closing connections are refused. The boot fallback filters nothing. internal/tablewatch puts the table back after a flush ruleset. Mode in status, healthz, whoami, the web UI, the log and the tracer; hc ruleset --enforcing. docs/shadow.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
51 lines
1.8 KiB
Go
51 lines
1.8 KiB
Go
package config
|
|
|
|
import (
|
|
"os"
|
|
"path/filepath"
|
|
"reflect"
|
|
"strings"
|
|
"testing"
|
|
)
|
|
|
|
func TestExampleIsTheDefaults(t *testing.T) {
|
|
path := filepath.Join(t.TempDir(), "housecarl.yaml")
|
|
os.WriteFile(path, []byte(Example), 0o644)
|
|
c, err := Load(path, false)
|
|
if err != nil {
|
|
t.Fatal(err)
|
|
}
|
|
if !reflect.DeepEqual(c, Default()) {
|
|
t.Errorf("example differs from the defaults:\n%+v\n%+v", c, Default())
|
|
}
|
|
}
|
|
|
|
func TestErrors(t *testing.T) {
|
|
cases := map[string]string{
|
|
"listen: []": "listen",
|
|
"database: relative.db": "database",
|
|
"session: {cookie_secure: x}": "cookie_secure",
|
|
"tls: {cert_file: /a}": "tls",
|
|
"no_such_setting: 1": "no_such_setting",
|
|
"backup: {retention: 3x}": "duration",
|
|
"tls: {acme: {domain: dhcp.example.com}}": "needs Jarl",
|
|
"jarl: {server: https://dns.example.com}": "token or token_file",
|
|
"jarl: {server: dns.example.com, token: x}": "Jarl's URL",
|
|
"{tls: {cert_file: /a, key_file: /b, acme: {domain: d.example.com}}, jarl: {server: https://j, token: x}}": "can't both",
|
|
"{tls: {acme: {domain: '*.example.com'}}, jarl: {server: https://j, token: x}}": "full name",
|
|
"{tls: {acme: {domain: d.example.com, directory: http://x}}, jarl: {server: https://j, token: x}}": "https://",
|
|
"ruleset: relative.nft": "ruleset",
|
|
"shadow: {position: x}": "shadow.position",
|
|
}
|
|
for yml, want := range cases {
|
|
path := filepath.Join(t.TempDir(), "s.yaml")
|
|
os.WriteFile(path, []byte(yml), 0o644)
|
|
if _, err := Load(path, false); err == nil || !strings.Contains(err.Error(), want) {
|
|
t.Errorf("%q: %v", yml, err)
|
|
}
|
|
}
|
|
if _, err := Load("/nonexistent/housecarl.yaml", true); err != nil {
|
|
t.Errorf("missing file allowed: %v", err)
|
|
}
|
|
}
|