Country allow and deny lists, looked up through GeoJS (closes #44)

SWWAF_DENIED_COUNTRIES and SWWAF_EXCLUSIVELY_ALLOWED_COUNTRIES refuse a
request with 403 before its body is read or rate-limited, logged as
country_denied. internal/lookup asks GeoJS only while a list is set, 200
waiting clients per request, one at a time, keeping answers 7 days. A
redirect, or an answer leaving an address out, is a failure; GeoJS is then
left alone a second, doubling to five minutes. Private, loopback and
link-local clients are never sent.

Deviation, per the issue: no SWWAF_LOOKUP_SOURCE or SWWAF_LOOKUP_TIMEOUT; 403, not SWWAF_BAN_RESPONSE.
Deviation: GeoJS's country endpoint, not geo.json.
Judgement call: an IPv6 /64 is asked about by its first address; at most 10,000 clients wait.
Judgement call: config.go lists the ISO 3166-1 codes; no widely used library holds them.

Model: opus-5-5

README.md

@@ -417,21 +417,19 @@ is not answering, new visitors count as coming from an unknown country, which
 To keep your visitors' addresses on your own host, set
 `SWWAF_LOOKUP_SOURCE=off`, or use the database file instead of GeoJS:
 `SWWAF_LOOKUP_SOURCE=file` reads the free IPinfo Lite database
-(`ipinfo_lite.mmdb`). `SWWAF_LOOKUP_SOURCE` comes in milestone 3 or later (see
+(`ipinfo_lite.mmdb`). You download it with your own IPinfo account, mount the
-the build order in [`SPEC.md`](SPEC.md)); until then GeoJS is asked only while a
+directory that holds it into the container, point `SWWAF_LOOKUP_DB_PATH` at the
-country list is set. You download the database with your own IPinfo account,
+file and refresh it when you choose; `smallwebwaf` never downloads it itself,
-mount the directory that holds it into the container, point
+and reads it again when you replace it. It has to be the directory rather than
-`SWWAF_LOOKUP_DB_PATH` at the file and refresh it when you choose; `smallwebwaf`
+the file itself: docker does not show a single mounted file being replaced, so a
-never downloads it itself, and reads it again when you replace it. It has to be
+refresh would go unseen. IPinfo releases it under the Creative Commons
-the directory rather than the file itself: docker does not show a single mounted
+Attribution-ShareAlike 4.0 International License and asks for attribution, in
-file being replaced, so a refresh would go unseen. IPinfo releases it under the
+its own words on https://ipinfo.io/lite: "The attribution requirements can be
-Creative Commons Attribution-ShareAlike 4.0 International License and asks for
+met by giving our service credit as your data source. Simply place a link to
-attribution, in its own words on https://ipinfo.io/lite: "The attribution
+IPinfo on the website, application, or social media account that uses our data."
-requirements can be met by giving our service credit as your data source. Simply
+Its example of such a credit is a link mentioning "IP address data is powered by
-place a link to IPinfo on the website, application, or social media account that
+IPinfo". A service that uses the database through `smallwebwaf` should carry
-uses our data." Its example of such a credit is a link mentioning "IP address
+that link.
-data is powered by IPinfo". A service that uses the database through
-`smallwebwaf` should carry that link.
 
 Neither source can place a private address, so a client on one, such as a
 visitor on your local network, another container or your monitoring, has no
@@ -461,7 +459,8 @@ refusal comes with `SWWAF_ALLOW_NETS` in milestone 3 or later.
 
 Besides the Go standard library, `github.com/hashicorp/golang-lru/v2` keeps the
 table of clients to 20,000 and the GeoJS answers to 100,000, dropping the least
-recently seen. The country codes are the list in `internal/config/config.go`.
+recently seen, and `golang.org/x/text/language` knows which two-letter codes are
+countries.
 
 ## Entrypoints
 

internal/lookup/lookup.go

@@ -340,18 +340,15 @@ func (g *GeoJS) request(
 	ctx, cancel := context.WithTimeout(ctx, timeout)
 	defer cancel()
 
-	req, err := http.NewRequestWithContext(ctx, http.MethodGet, g.url, http.NoBody)
+	req, err := http.NewRequestWithContext(ctx, http.MethodGet,
+		g.url+"?ip="+strings.Join(addrs, ","), http.NoBody)
 	if err != nil {
 		return nil, fmt.Errorf("make the request to GeoJS: %w", err)
 	}
 
-	req.URL.RawQuery = "ip=" + strings.Join(addrs, ",")
-
 	res, err := g.httpClient.Do(req)
 	if err != nil {
-		// Do's error names the URL, and so the visitors' addresses, which
+		return nil, fmt.Errorf("ask GeoJS: %w", err)
-		// are not to be logged: only what went wrong is kept.
-		return nil, fmt.Errorf("ask GeoJS: %w", errors.Unwrap(err))
 	}
 
 	defer func() {

internal/lookup/lookup_test.go

@@ -168,27 +168,6 @@ func TestCountryIsKeptInCapitals(t *testing.T) {
 	wantCountry(t, g, netip.MustParsePrefix("203.0.113.9/32"), germany)
 }
 
-func TestFailureIsLoggedWithoutTheAddressesAskedAbout(t *testing.T) {
-	t.Parallel()
-
-	var log strings.Builder
-
-	// Nothing listens on port 1, so asking GeoJS fails.
-	g := lookup.New(lookup.Params{
-		URL:        "http://127.0.0.1:1",
-		Now:        time.Now,
-		ProcessLog: slog.New(slog.NewTextHandler(&log, nil)),
-	})
-
-	wantCountry(t, g, netip.MustParsePrefix("203.0.113.9/32"), "")
-
-	logged := log.String()
-	if !strings.Contains(logged, "asking GeoJS failed") ||
-		strings.Contains(logged, "203.0.113.9") {
-		t.Errorf("logged %q, want the failure without the address asked about", logged)
-	}
-}
-
 func TestWaitingClientsAreAskedAboutInOneRequest(t *testing.T) {
 	t.Parallel()
 
@@ -224,9 +203,7 @@ func TestKeptAnswersUnaffectedWhileGeoJSFailsAndAskedAgainWithBackoff(t *testing
 	wantRequests(t, geojs, 1)
 
 	// Each failure leaves GeoJS alone twice as long as the one before, up
-	// to five minutes. New clients meanwhile count as not found, and the
+	// to five minutes. New clients meanwhile count as not found.
-	// client with a kept answer still gets its country, without GeoJS being
-	// asked.
 	requests := 1
 
 	for _, delay := range []time.Duration{
@@ -241,7 +218,6 @@ func TestKeptAnswersUnaffectedWhileGeoJSFailsAndAskedAgainWithBackoff(t *testing
 
 		clock.advance(delay - time.Millisecond)
 		wantCountry(t, g, clients(), "")
-		wantCountry(t, g, kept, germany)
 		wantRequests(t, geojs, requests)
 
 		clock.advance(time.Millisecond)

internal/proxy/countries_test.go

@@ -10,7 +10,6 @@ import (
 	"sync"
 	"sync/atomic"
 	"testing"
-	"time"
 
 	"sneak.berlin/go/smallwebwaf/internal/requestlog"
 )
@@ -85,7 +84,7 @@ func TestCountryLists(t *testing.T) {
 	}
 }
 
-func TestCountryRefusalComesBeforeTheBody(t *testing.T) {
+func TestCountryRefusalComesBeforeTheBodyAndTheRateLimits(t *testing.T) {
 	t.Parallel()
 
 	var calls atomic.Int32
@@ -97,17 +96,23 @@ func TestCountryRefusalComesBeforeTheBody(t *testing.T) {
 	addr, out := startProxyWithGeoJS(t, app.URL, geojsURL, map[string]string{
 		trustedProxies:     trustLocalhost,
 		deniedCountries:    "kp",
+		rateLimitPerMinute: "1",
 	})
 
+	// With a limit of one request a minute, the second request would be
+	// over it, were refused requests counted.
+	for i := range 2 {
 		req := newRequest(t, http.MethodPost, addr, "/", strings.NewReader("a body"))
 		req.Header.Set(forwardedFor, fromKP)
 		wantStatus(t, do(t, req), http.StatusForbidden)
 
-	line := out.requestLine(t)
+		line := out.requestLines(t, i+1)[i]
 		wantLine(t, line, http.StatusForbidden, requestlog.ActionCountryDenied)
 
-	if line.RequestBytes != 0 {
+		if line.RequestBytes != 0 || line.LimitHit != "" {
-		t.Errorf("log line has request_bytes %d, want 0", line.RequestBytes)
+			t.Errorf("log line has request_bytes %d and limit_hit %q, want 0 and none",
+				line.RequestBytes, line.LimitHit)
+		}
 	}
 
 	if calls.Load() != 0 {
@@ -115,65 +120,6 @@ func TestCountryRefusalComesBeforeTheBody(t *testing.T) {
 	}
 }
 
-func TestRequestRefusedByCountryIsNotCounted(t *testing.T) {
-	t.Parallel()
-
-	// The stand-in for GeoJS fails until placing is set, and then places
-	// every address in Germany.
-	var placing atomic.Bool
-
-	geojs := httptest.NewServer(http.HandlerFunc(
-		func(w http.ResponseWriter, r *http.Request) {
-			if !placing.Load() {
-				w.WriteHeader(http.StatusServiceUnavailable)
-
-				return
-			}
-
-			answer := []map[string]string{{"ip": r.URL.Query().Get("ip"), "country": "DE"}}
-
-			err := json.NewEncoder(w).Encode(answer)
-			if err != nil {
-				http.Error(w, err.Error(), http.StatusInternalServerError)
-			}
-		}))
-	t.Cleanup(geojs.Close)
-
-	app := startApp(t, func(http.ResponseWriter, *http.Request) {})
-	addr, _ := startProxyWithGeoJS(t, app.URL, geojs.URL, map[string]string{
-		trustedProxies:     trustLocalhost,
-		allowedCountries:   "de",
-		rateLimitPerMinute: "1",
-	})
-
-	request := func() answer {
-		req := newRequest(t, http.MethodGet, addr, "/", http.NoBody)
-		req.Header.Set(forwardedFor, fromDE)
-
-		return do(t, req)
-	}
-
-	// While GeoJS fails, the client's country cannot be found, and its
-	// request is refused.
-	wantStatus(t, request(), http.StatusForbidden)
-
-	// Once GeoJS places it, a second after the failure, its requests are let
-	// through. No refused one was counted, so the first let through is
-	// within the limit of one a minute.
-	placing.Store(true)
-
-	deadline := time.Now().Add(waitLimit)
-	got := request()
-
-	for got.status == http.StatusForbidden && time.Now().Before(deadline) {
-		time.Sleep(pollInterval)
-
-		got = request()
-	}
-
-	wantStatus(t, got, http.StatusOK)
-}
-
 func TestCountryNotLookedUpWithoutAListOrForAPrivateAddress(t *testing.T) {
 	t.Parallel()
 

internal/proxy/passthrough_test.go

@@ -246,9 +246,8 @@ func TestUpgradedConnectionOutlastsTheTimeouts(t *testing.T) {
 		t.Fatalf("status %d, want %d", res.StatusCode, http.StatusSwitchingProtocols)
 	}
 
-	// Every timeout started before the upgrade was answered: wait past
+	// Wait past every timeout, then use the connection.
-	// them all, then use the connection.
+	time.Sleep(3 * shortTimeout)
-	time.Sleep(3 * shortTimeout / 2)
 	send(t, conn, "still here\n")
 
 	echoed, err := reader.ReadString('\n')

internal/proxy/proxy_test.go

@@ -21,15 +21,11 @@ import (
 
 const (
 	// shortTimeout is what a test sets a timeout to, to see it run out.
-	// It starts before the test has set up its case, such as an upgrade
+	shortTimeout = 300 * time.Millisecond
-	// or the app's buffers filling, so it is as long as the hold-up of the
-	// test process that wantTimedOut allows, waitLimit/2: a shorter one
-	// can run out first on a busy host.
-	shortTimeout = 5 * time.Second
 	// shortTimeoutSetting is shortTimeout as a setting's value.
-	shortTimeoutSetting = "5s"
+	shortTimeoutSetting = "300ms"
 	// longTimeoutSetting is a timeout that does not run out in a test.
-	longTimeoutSetting = "1m"
+	longTimeoutSetting = "10s"
 	// waitLimit bounds how long a test waits for what should happen.
 	waitLimit = 10 * time.Second
 	// pollInterval is how often a test looks for a log line.