Compare commits
1 Commits
issue-90-b
...
190cabe0f2
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
190cabe0f2 |
41
README.md
41
README.md
@@ -531,6 +531,30 @@ older than the expiry are pruned each time the archive is (re)opened. An
|
|||||||
archive write failure is never silent success: the delivery records a
|
archive write failure is never silent success: the delivery records a
|
||||||
failed attempt with the error and is marked failed.
|
failed attempt with the error and is marked failed.
|
||||||
|
|
||||||
|
Because reopens only happen on writes, an archive belonging to a webhook
|
||||||
|
that has stopped receiving events would never be pruned. A background
|
||||||
|
**archive sweeper** closes that gap: on the same interval as the event
|
||||||
|
retention reaper (`RETENTION_SWEEP_INTERVAL`) it prunes every archive
|
||||||
|
whose database target declares a positive expiry, whether or not the
|
||||||
|
webhook is still receiving traffic. The sweep never creates an archive —
|
||||||
|
a webhook whose archive file does not yet exist is skipped, not
|
||||||
|
initialised — it takes the same per-webhook lock the write path uses, so
|
||||||
|
it can never interleave with a write, and it leaves the archive closed
|
||||||
|
afterwards so the move-the-file-away workflow keeps working. Archives
|
||||||
|
with no expiry, or the expiry `never`, are not touched by the sweep at
|
||||||
|
all.
|
||||||
|
|
||||||
|
Deleting a webhook releases its archive: the delivery engine's cached
|
||||||
|
archive writer is dropped and its file handle closed, so nothing lingers
|
||||||
|
after the webhook is gone. The archive **file itself is deliberately
|
||||||
|
left on disk**. Unlike the event database — per-webhook working storage
|
||||||
|
that is hard-deleted with the webhook — an archive is long-term storage
|
||||||
|
an operator may still want to keep or move away for offline retention,
|
||||||
|
and destroying it as a side effect of deleting a webhook would be
|
||||||
|
unrecoverable. Removing `archive-{webhookID}.db` is the operator's call.
|
||||||
|
Deleting a webhook's last `database` target releases the writer the same
|
||||||
|
way, and for the same reason leaves the file alone.
|
||||||
|
|
||||||
The **Slack target type** sends webhook events as formatted messages to
|
The **Slack target type** sends webhook events as formatted messages to
|
||||||
any Slack-compatible incoming webhook URL (works with Slack, Mattermost,
|
any Slack-compatible incoming webhook URL (works with Slack, Mattermost,
|
||||||
and other compatible services). Each message includes event metadata
|
and other compatible services). Each message includes event metadata
|
||||||
@@ -867,17 +891,9 @@ Applied to all routes in this order:
|
|||||||
8. **Sentry** — Error reporting to Sentry (if `SENTRY_DSN` is set;
|
8. **Sentry** — Error reporting to Sentry (if `SENTRY_DSN` is set;
|
||||||
configured with `Repanic: true` so panics still reach Recoverer)
|
configured with `Repanic: true` so panics still reach Recoverer)
|
||||||
|
|
||||||
Additionally, form endpoints (`/pages`, `/user/*`, `/sources`,
|
Additionally, form endpoints (`/pages`, `/sources`, `/source/*`) apply a
|
||||||
`/source/*`) apply a **MaxBodySize** middleware that limits
|
**MaxBodySize** middleware that limits POST/PUT/PATCH request bodies to
|
||||||
POST/PUT/PATCH request bodies to 1 MB. It is registered ahead of the
|
1 MB using `http.MaxBytesReader`, preventing oversized form submissions.
|
||||||
CSRF middleware in every one of those route groups, because
|
|
||||||
gorilla/csrf parses the form; if the cap were installed after it, form
|
|
||||||
parsing would run under net/http's 10 MB default and the 1 MB limit
|
|
||||||
would never apply. A request that declares a `Content-Length` over the
|
|
||||||
limit is answered with `413 Request Entity Too Large` before any other
|
|
||||||
middleware or handler runs; a chunked request, or one that lies about
|
|
||||||
its length, is hard-capped by `http.MaxBytesReader` and fails
|
|
||||||
downstream at form-parse time.
|
|
||||||
|
|
||||||
### Authentication
|
### Authentication
|
||||||
|
|
||||||
@@ -899,8 +915,7 @@ downstream at form-parse time.
|
|||||||
- Production security headers on all responses: HSTS, X-Content-Type-Options
|
- Production security headers on all responses: HSTS, X-Content-Type-Options
|
||||||
(`nosniff`), X-Frame-Options (`DENY`), Content-Security-Policy, Referrer-Policy,
|
(`nosniff`), X-Frame-Options (`DENY`), Content-Security-Policy, Referrer-Policy,
|
||||||
and Permissions-Policy
|
and Permissions-Policy
|
||||||
- Request body size limits (1 MB) on all form POST endpoints, enforced
|
- Request body size limits (1 MB) on all form POST endpoints
|
||||||
by middleware that runs before CSRF parses the form
|
|
||||||
- **CSRF protection** via [gorilla/csrf](https://github.com/gorilla/csrf)
|
- **CSRF protection** via [gorilla/csrf](https://github.com/gorilla/csrf)
|
||||||
on all state-changing forms (cookie-based double-submit tokens with
|
on all state-changing forms (cookie-based double-submit tokens with
|
||||||
HMAC authentication). Applied to `/pages`, `/sources`, `/source`, and
|
HMAC authentication). Applied to `/pages`, `/sources`, `/source`, and
|
||||||
|
|||||||
12
TODO.md
12
TODO.md
@@ -28,13 +28,11 @@ databases currently grow without bound.
|
|||||||
|
|
||||||
# Completed Steps
|
# Completed Steps
|
||||||
|
|
||||||
- 2026-08-09 Enforce the request body size limit before the CSRF
|
- 2026-08-09 Archive writer lifecycle (#89): deleting a webhook (or its
|
||||||
middleware parses the form (#90): `MaxBodySize` is now registered
|
last `database` target) evicts the cached archive writer and closes
|
||||||
ahead of `CSRF()` in every form route group, the `/user/{username}`
|
its handle while deliberately leaving `archive-{webhookID}.db` on
|
||||||
group gained the cap it never had (which is where `POST /password`
|
disk, and a new `ArchiveSweeper` prunes idle archives on the existing
|
||||||
lives), the middleware rejects a declared-oversize body with a real
|
`RETENTION_SWEEP_INTERVAL` without ever creating an archive file
|
||||||
413 up front, and the redundant handler-local
|
|
||||||
`http.MaxBytesReader` calls were removed
|
|
||||||
- 2026-08-07 Update golangci-lint to v2.12.2 (Docker image digest in
|
- 2026-08-07 Update golangci-lint to v2.12.2 (Docker image digest in
|
||||||
`Dockerfile`, release-archive sha256 pins in `script/bootstrap`),
|
`Dockerfile`, release-archive sha256 pins in `script/bootstrap`),
|
||||||
adopt the canonical `.golangci.yml` (v2 `linters.settings` layout so
|
adopt the canonical `.golangci.yml` (v2 `linters.settings` layout so
|
||||||
|
|||||||
@@ -40,9 +40,15 @@ func main() {
|
|||||||
handlers.New,
|
handlers.New,
|
||||||
middleware.New,
|
middleware.New,
|
||||||
delivery.New,
|
delivery.New,
|
||||||
|
delivery.NewArchiveSweeper,
|
||||||
// Wire *delivery.Engine as delivery.Notifier so the
|
// Wire *delivery.Engine as delivery.Notifier so the
|
||||||
// webhook handler can notify the engine of new deliveries.
|
// webhook handler can notify the engine of new deliveries.
|
||||||
func(e *delivery.Engine) delivery.Notifier { return e },
|
func(e *delivery.Engine) delivery.Notifier { return e },
|
||||||
|
// Wire *delivery.Engine as delivery.WebhookEvictor so
|
||||||
|
// deleting a webhook releases its archive writer.
|
||||||
|
func(e *delivery.Engine) delivery.WebhookEvictor {
|
||||||
|
return e
|
||||||
|
},
|
||||||
server.New,
|
server.New,
|
||||||
),
|
),
|
||||||
fx.Invoke(
|
fx.Invoke(
|
||||||
@@ -50,6 +56,7 @@ func main() {
|
|||||||
*server.Server,
|
*server.Server,
|
||||||
*delivery.Engine,
|
*delivery.Engine,
|
||||||
*database.RetentionReaper,
|
*database.RetentionReaper,
|
||||||
|
*delivery.ArchiveSweeper,
|
||||||
) {
|
) {
|
||||||
},
|
},
|
||||||
),
|
),
|
||||||
|
|||||||
189
internal/delivery/archive_sweeper.go
Normal file
189
internal/delivery/archive_sweeper.go
Normal file
@@ -0,0 +1,189 @@
|
|||||||
|
package delivery
|
||||||
|
|
||||||
|
import (
|
||||||
|
"context"
|
||||||
|
"log/slog"
|
||||||
|
"sync"
|
||||||
|
"time"
|
||||||
|
|
||||||
|
"go.uber.org/fx"
|
||||||
|
"sneak.berlin/go/webhooker/internal/config"
|
||||||
|
"sneak.berlin/go/webhooker/internal/database"
|
||||||
|
"sneak.berlin/go/webhooker/internal/logger"
|
||||||
|
)
|
||||||
|
|
||||||
|
// ArchiveSweeperParams holds the fx dependencies for the
|
||||||
|
// ArchiveSweeper.
|
||||||
|
type ArchiveSweeperParams struct {
|
||||||
|
fx.In
|
||||||
|
|
||||||
|
Config *config.Config
|
||||||
|
Database *database.Database
|
||||||
|
Engine *Engine
|
||||||
|
Logger *logger.Logger
|
||||||
|
}
|
||||||
|
|
||||||
|
// ArchiveSweeper periodically prunes expired rows from
|
||||||
|
// per-webhook archive databases whose database target carries a
|
||||||
|
// positive expiry.
|
||||||
|
//
|
||||||
|
// Without it, pruning happens only when an archive is
|
||||||
|
// (re)opened, and archives are only ever reopened by writes: an
|
||||||
|
// archive belonging to a webhook that has stopped receiving
|
||||||
|
// events would keep its expired rows forever. The sweep closes
|
||||||
|
// that gap without changing anything for archives whose expiry
|
||||||
|
// is unset or "never".
|
||||||
|
//
|
||||||
|
// It reuses Config.RetentionSweepInterval rather than
|
||||||
|
// introducing a second interval: this is a retention sweep with
|
||||||
|
// the same semantics as the event retention reaper.
|
||||||
|
type ArchiveSweeper struct {
|
||||||
|
db *database.Database
|
||||||
|
eng *Engine
|
||||||
|
log *slog.Logger
|
||||||
|
interval time.Duration
|
||||||
|
cancel context.CancelFunc
|
||||||
|
wg sync.WaitGroup
|
||||||
|
}
|
||||||
|
|
||||||
|
// NewArchiveSweeper creates the archive sweeper and registers
|
||||||
|
// its fx lifecycle hooks. The background sweep loop starts on
|
||||||
|
// OnStart and stops cleanly on OnStop via context cancellation.
|
||||||
|
func NewArchiveSweeper(
|
||||||
|
lc fx.Lifecycle,
|
||||||
|
params ArchiveSweeperParams,
|
||||||
|
) *ArchiveSweeper {
|
||||||
|
s := &ArchiveSweeper{
|
||||||
|
db: params.Database,
|
||||||
|
eng: params.Engine,
|
||||||
|
log: params.Logger.Get(),
|
||||||
|
interval: params.Config.RetentionSweepInterval,
|
||||||
|
}
|
||||||
|
|
||||||
|
lc.Append(fx.Hook{
|
||||||
|
OnStart: func(ctx context.Context) error {
|
||||||
|
s.start(ctx)
|
||||||
|
|
||||||
|
return nil
|
||||||
|
},
|
||||||
|
OnStop: func(_ context.Context) error {
|
||||||
|
s.stop()
|
||||||
|
|
||||||
|
return nil
|
||||||
|
},
|
||||||
|
})
|
||||||
|
|
||||||
|
return s
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *ArchiveSweeper) start(ctx context.Context) {
|
||||||
|
ctx, cancel := context.WithCancel(ctx)
|
||||||
|
s.cancel = cancel
|
||||||
|
|
||||||
|
s.wg.Add(1)
|
||||||
|
|
||||||
|
go s.run(ctx)
|
||||||
|
|
||||||
|
s.log.Info(
|
||||||
|
"archive sweeper started",
|
||||||
|
"interval", s.interval.String(),
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *ArchiveSweeper) stop() {
|
||||||
|
s.log.Info("archive sweeper stopping")
|
||||||
|
|
||||||
|
if s.cancel != nil {
|
||||||
|
s.cancel()
|
||||||
|
}
|
||||||
|
|
||||||
|
s.wg.Wait()
|
||||||
|
s.log.Info("archive sweeper stopped")
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *ArchiveSweeper) run(ctx context.Context) {
|
||||||
|
defer s.wg.Done()
|
||||||
|
|
||||||
|
ticker := time.NewTicker(s.interval)
|
||||||
|
defer ticker.Stop()
|
||||||
|
|
||||||
|
for {
|
||||||
|
select {
|
||||||
|
case <-ctx.Done():
|
||||||
|
return
|
||||||
|
case <-ticker.C:
|
||||||
|
s.sweep(ctx)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// sweep prunes every archive whose database target declares a
|
||||||
|
// positive expiry. Targets belonging to a deleted webhook are
|
||||||
|
// soft-deleted along with it, so GORM's default scope already
|
||||||
|
// excludes them.
|
||||||
|
//
|
||||||
|
// A failure for one webhook is logged and the sweep continues,
|
||||||
|
// matching how the write path already treats a prune error as
|
||||||
|
// non-fatal.
|
||||||
|
func (s *ArchiveSweeper) sweep(ctx context.Context) {
|
||||||
|
var targets []database.Target
|
||||||
|
|
||||||
|
err := s.db.DB().
|
||||||
|
Model(&database.Target{}).
|
||||||
|
Where("type = ?", database.TargetTypeDatabase).
|
||||||
|
Find(&targets).Error
|
||||||
|
if err != nil {
|
||||||
|
s.log.Error(
|
||||||
|
"archive sweep: failed to list database targets",
|
||||||
|
"error", err,
|
||||||
|
)
|
||||||
|
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
for i := range targets {
|
||||||
|
select {
|
||||||
|
case <-ctx.Done():
|
||||||
|
return
|
||||||
|
default:
|
||||||
|
}
|
||||||
|
|
||||||
|
s.sweepTarget(&targets[i])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// sweepTarget prunes the archive of a single database target.
|
||||||
|
// A missing, empty, or "never" expiry parses as a zero duration
|
||||||
|
// and is skipped entirely, so those archives keep exactly the
|
||||||
|
// behaviour they had before the sweep existed.
|
||||||
|
func (s *ArchiveSweeper) sweepTarget(target *database.Target) {
|
||||||
|
expiry, err := parseArchiveExpiry(target.Config)
|
||||||
|
if err != nil {
|
||||||
|
s.log.Error(
|
||||||
|
"archive sweep: invalid database target config",
|
||||||
|
"webhook_id", target.WebhookID,
|
||||||
|
"target_id", target.ID,
|
||||||
|
"error", err,
|
||||||
|
)
|
||||||
|
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
if expiry <= 0 {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
if s.eng == nil || s.eng.dbTarget == nil {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
err = s.eng.dbTarget.sweepWebhook(target.WebhookID, expiry)
|
||||||
|
if err != nil {
|
||||||
|
s.log.Error(
|
||||||
|
"archive sweep: failed to prune archive",
|
||||||
|
"webhook_id", target.WebhookID,
|
||||||
|
"target_id", target.ID,
|
||||||
|
"error", err,
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
425
internal/delivery/archive_sweeper_test.go
Normal file
425
internal/delivery/archive_sweeper_test.go
Normal file
@@ -0,0 +1,425 @@
|
|||||||
|
package delivery_test
|
||||||
|
|
||||||
|
import (
|
||||||
|
"context"
|
||||||
|
"database/sql"
|
||||||
|
"fmt"
|
||||||
|
"net/http"
|
||||||
|
"path/filepath"
|
||||||
|
"sync"
|
||||||
|
"testing"
|
||||||
|
"time"
|
||||||
|
|
||||||
|
"github.com/google/uuid"
|
||||||
|
"github.com/stretchr/testify/assert"
|
||||||
|
"github.com/stretchr/testify/require"
|
||||||
|
"gorm.io/driver/sqlite"
|
||||||
|
"gorm.io/gorm"
|
||||||
|
"gorm.io/gorm/clause"
|
||||||
|
_ "modernc.org/sqlite" // Pure Go SQLite driver.
|
||||||
|
"sneak.berlin/go/webhooker/internal/database"
|
||||||
|
"sneak.berlin/go/webhooker/internal/delivery"
|
||||||
|
)
|
||||||
|
|
||||||
|
const (
|
||||||
|
// sweepRowOld and sweepRowNew are the event ids
|
||||||
|
// seedArchiveRows assigns to the first and second seeded
|
||||||
|
// rows.
|
||||||
|
sweepRowOld = "ev-0"
|
||||||
|
sweepRowNew = "ev-1"
|
||||||
|
|
||||||
|
// sweepConcurrentWrites is how many deliveries the
|
||||||
|
// concurrent write-plus-sweep test races against the sweep.
|
||||||
|
sweepConcurrentWrites = 20
|
||||||
|
)
|
||||||
|
|
||||||
|
// sweeperEnv bundles the pieces an archive sweep test drives:
|
||||||
|
// a main configuration database holding webhooks and targets, a
|
||||||
|
// delivery engine owning the archive writer registry, and the
|
||||||
|
// data directory the archive files live in.
|
||||||
|
type sweeperEnv struct {
|
||||||
|
sweeper *delivery.ArchiveSweeper
|
||||||
|
eng *delivery.Engine
|
||||||
|
mainDB *database.Database
|
||||||
|
dataDir string
|
||||||
|
}
|
||||||
|
|
||||||
|
func setupSweeperTest(t *testing.T) *sweeperEnv {
|
||||||
|
t.Helper()
|
||||||
|
|
||||||
|
dataDir := t.TempDir()
|
||||||
|
log := archiveTestLogger()
|
||||||
|
|
||||||
|
sqlDB, err := sql.Open(
|
||||||
|
"sqlite",
|
||||||
|
fmt.Sprintf(
|
||||||
|
"file:%s?mode=rwc",
|
||||||
|
filepath.Join(dataDir, "main.db"),
|
||||||
|
),
|
||||||
|
)
|
||||||
|
require.NoError(t, err)
|
||||||
|
|
||||||
|
t.Cleanup(func() { _ = sqlDB.Close() })
|
||||||
|
|
||||||
|
gdb, err := gorm.Open(
|
||||||
|
sqlite.Dialector{Conn: sqlDB}, &gorm.Config{},
|
||||||
|
)
|
||||||
|
require.NoError(t, err)
|
||||||
|
|
||||||
|
mainDB := database.NewTestDatabase(gdb)
|
||||||
|
require.NoError(t, mainDB.Migrate())
|
||||||
|
|
||||||
|
eng := delivery.NewTestEngineWithDB(
|
||||||
|
mainDB,
|
||||||
|
database.NewTestWebhookDBManager(dataDir),
|
||||||
|
log,
|
||||||
|
&http.Client{Timeout: 5 * time.Second},
|
||||||
|
1,
|
||||||
|
)
|
||||||
|
|
||||||
|
return &sweeperEnv{
|
||||||
|
sweeper: delivery.NewTestArchiveSweeper(
|
||||||
|
mainDB, eng, log,
|
||||||
|
),
|
||||||
|
eng: eng,
|
||||||
|
mainDB: mainDB,
|
||||||
|
dataDir: dataDir,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// archivePath returns where the engine keeps a webhook's
|
||||||
|
// archive file.
|
||||||
|
func (env *sweeperEnv) archivePath(webhookID string) string {
|
||||||
|
return filepath.Join(
|
||||||
|
env.dataDir, fmt.Sprintf("archive-%s.db", webhookID),
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// seedDatabaseTarget creates a webhook with one database target
|
||||||
|
// carrying the given target config JSON, and returns the
|
||||||
|
// webhook id.
|
||||||
|
func (env *sweeperEnv) seedDatabaseTarget(
|
||||||
|
t *testing.T, configJSON string,
|
||||||
|
) string {
|
||||||
|
t.Helper()
|
||||||
|
|
||||||
|
wh := &database.Webhook{
|
||||||
|
UserID: uuid.New().String(),
|
||||||
|
Name: "sweep-test",
|
||||||
|
}
|
||||||
|
require.NoError(
|
||||||
|
t,
|
||||||
|
env.mainDB.DB().
|
||||||
|
Omit(clause.Associations).
|
||||||
|
Create(wh).Error,
|
||||||
|
)
|
||||||
|
|
||||||
|
tgt := &database.Target{
|
||||||
|
WebhookID: wh.ID,
|
||||||
|
Name: "archive",
|
||||||
|
Type: database.TargetTypeDatabase,
|
||||||
|
Active: true,
|
||||||
|
Config: configJSON,
|
||||||
|
}
|
||||||
|
require.NoError(
|
||||||
|
t,
|
||||||
|
env.mainDB.DB().
|
||||||
|
Omit(clause.Associations).
|
||||||
|
Create(tgt).Error,
|
||||||
|
)
|
||||||
|
|
||||||
|
return wh.ID
|
||||||
|
}
|
||||||
|
|
||||||
|
// seedArchiveRows creates the archive file for a webhook and
|
||||||
|
// inserts one row per supplied archived-at timestamp, returning
|
||||||
|
// the archive path. The handle is closed before returning, so
|
||||||
|
// the archive is idle exactly as it would be with no traffic.
|
||||||
|
func (env *sweeperEnv) seedArchiveRows(
|
||||||
|
t *testing.T, webhookID string, archivedAt ...time.Time,
|
||||||
|
) string {
|
||||||
|
t.Helper()
|
||||||
|
|
||||||
|
path := env.archivePath(webhookID)
|
||||||
|
|
||||||
|
sqlDB, err := sql.Open(
|
||||||
|
"sqlite", fmt.Sprintf("file:%s?mode=rwc", path),
|
||||||
|
)
|
||||||
|
require.NoError(t, err)
|
||||||
|
|
||||||
|
gdb, err := gorm.Open(
|
||||||
|
sqlite.Dialector{Conn: sqlDB}, &gorm.Config{},
|
||||||
|
)
|
||||||
|
require.NoError(t, err)
|
||||||
|
|
||||||
|
require.NoError(
|
||||||
|
t, gdb.AutoMigrate(&delivery.ExportArchivedEvent{}),
|
||||||
|
)
|
||||||
|
|
||||||
|
for i, at := range archivedAt {
|
||||||
|
row := delivery.ExportArchivedEvent{
|
||||||
|
EventID: fmt.Sprintf("ev-%d", i),
|
||||||
|
WebhookID: webhookID,
|
||||||
|
Method: http.MethodPost,
|
||||||
|
Body: `{"seeded":true}`,
|
||||||
|
ArchivedAt: at,
|
||||||
|
}
|
||||||
|
require.NoError(t, gdb.Create(&row).Error)
|
||||||
|
}
|
||||||
|
|
||||||
|
require.NoError(t, sqlDB.Close())
|
||||||
|
|
||||||
|
return path
|
||||||
|
}
|
||||||
|
|
||||||
|
// archivedEventIDs returns the event ids currently stored in an
|
||||||
|
// archive file, read through a separate read-only handle.
|
||||||
|
func archivedEventIDs(
|
||||||
|
t *testing.T, path string,
|
||||||
|
) []string {
|
||||||
|
t.Helper()
|
||||||
|
|
||||||
|
var rows []delivery.ExportArchivedEvent
|
||||||
|
|
||||||
|
rdb := openArchiveDBForRead(t, path)
|
||||||
|
require.NoError(t, rdb.Order("event_id").Find(&rows).Error)
|
||||||
|
|
||||||
|
ids := make([]string, 0, len(rows))
|
||||||
|
for i := range rows {
|
||||||
|
ids = append(ids, rows[i].EventID)
|
||||||
|
}
|
||||||
|
|
||||||
|
return ids
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestArchiveSweep_PrunesIdleArchive is the core regression
|
||||||
|
// test for this issue: an archive that receives no further
|
||||||
|
// writes must still lose its expired rows. Before the sweeper
|
||||||
|
// existed, pruning only ever ran on a write-triggered reopen,
|
||||||
|
// so an idle archive kept expired rows forever.
|
||||||
|
func TestArchiveSweep_PrunesIdleArchive(t *testing.T) {
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
env := setupSweeperTest(t)
|
||||||
|
|
||||||
|
webhookID := env.seedDatabaseTarget(t, `{"expiry":"1h"}`)
|
||||||
|
|
||||||
|
now := time.Now()
|
||||||
|
path := env.seedArchiveRows(
|
||||||
|
t, webhookID,
|
||||||
|
now.Add(-48*time.Hour),
|
||||||
|
now.Add(-time.Minute),
|
||||||
|
)
|
||||||
|
|
||||||
|
require.Equal(
|
||||||
|
t, []string{sweepRowOld, sweepRowNew},
|
||||||
|
archivedEventIDs(t, path),
|
||||||
|
)
|
||||||
|
|
||||||
|
env.sweeper.ExportSweep(context.Background())
|
||||||
|
|
||||||
|
assert.Equal(
|
||||||
|
t, []string{sweepRowNew}, archivedEventIDs(t, path),
|
||||||
|
"the sweep should prune rows older than the expiry "+
|
||||||
|
"from an idle archive and keep the rest",
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestArchiveSweep_LeavesArchiveClosed proves the sweep does
|
||||||
|
// not hold the archive open afterwards, so an operator can
|
||||||
|
// still move the file away for offline retention.
|
||||||
|
func TestArchiveSweep_LeavesArchiveClosed(t *testing.T) {
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
env := setupSweeperTest(t)
|
||||||
|
|
||||||
|
webhookID := env.seedDatabaseTarget(t, `{"expiry":"1h"}`)
|
||||||
|
env.seedArchiveRows(
|
||||||
|
t, webhookID, time.Now().Add(-48*time.Hour),
|
||||||
|
)
|
||||||
|
|
||||||
|
env.sweeper.ExportSweep(context.Background())
|
||||||
|
|
||||||
|
assert.False(
|
||||||
|
t, env.eng.ExportArchiveHandleOpen(webhookID),
|
||||||
|
"an idle archive must end the sweep closed",
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestArchiveSweep_NeverExpiryUntouched proves the sweep is a
|
||||||
|
// no-op for the default retention policy, so archives with no
|
||||||
|
// expiry (or the literal "never") behave exactly as before.
|
||||||
|
func TestArchiveSweep_NeverExpiryUntouched(t *testing.T) {
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
for _, configJSON := range []string{
|
||||||
|
`{"expiry":"never"}`,
|
||||||
|
`{"expiry":""}`,
|
||||||
|
"",
|
||||||
|
} {
|
||||||
|
env := setupSweeperTest(t)
|
||||||
|
|
||||||
|
webhookID := env.seedDatabaseTarget(t, configJSON)
|
||||||
|
path := env.seedArchiveRows(
|
||||||
|
t, webhookID,
|
||||||
|
time.Now().Add(-10000*time.Hour),
|
||||||
|
)
|
||||||
|
|
||||||
|
env.sweeper.ExportSweep(context.Background())
|
||||||
|
|
||||||
|
assert.Equal(
|
||||||
|
t, []string{sweepRowOld}, archivedEventIDs(t, path),
|
||||||
|
"config %q must keep rows forever", configJSON,
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestArchiveSweep_DoesNotCreateArchiveFile proves the sweep
|
||||||
|
// never conjures an archive: a webhook with a database target
|
||||||
|
// that has never received an event must still have no archive
|
||||||
|
// file (nor SQLite sidecar) after a sweep.
|
||||||
|
func TestArchiveSweep_DoesNotCreateArchiveFile(t *testing.T) {
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
env := setupSweeperTest(t)
|
||||||
|
|
||||||
|
webhookID := env.seedDatabaseTarget(t, `{"expiry":"1h"}`)
|
||||||
|
path := env.archivePath(webhookID)
|
||||||
|
|
||||||
|
require.NoFileExists(t, path)
|
||||||
|
|
||||||
|
env.sweeper.ExportSweep(context.Background())
|
||||||
|
|
||||||
|
for _, suffix := range []string{"", "-wal", "-shm"} {
|
||||||
|
assert.NoFileExists(
|
||||||
|
t, path+suffix,
|
||||||
|
"the sweep must not create an archive file",
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestArchiveSweep_DoesNotCreateAfterWriterExists covers the
|
||||||
|
// same guarantee once a writer is cached in the registry but
|
||||||
|
// the file itself is still absent (for instance because the
|
||||||
|
// operator moved the archive away).
|
||||||
|
func TestArchiveSweep_DoesNotCreateAfterWriterExists(
|
||||||
|
t *testing.T,
|
||||||
|
) {
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
env := setupSweeperTest(t)
|
||||||
|
|
||||||
|
webhookID := env.seedDatabaseTarget(t, `{"expiry":"1h"}`)
|
||||||
|
|
||||||
|
path, err := env.eng.ExportEnsureArchiveWriter(webhookID)
|
||||||
|
require.NoError(t, err)
|
||||||
|
require.NoFileExists(t, path)
|
||||||
|
|
||||||
|
env.sweeper.ExportSweep(context.Background())
|
||||||
|
|
||||||
|
assert.NoFileExists(t, path)
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestArchiveSweep_SkipsDeletedWebhookTargets proves that the
|
||||||
|
// sweep ignores targets soft-deleted along with their webhook,
|
||||||
|
// so a deleted webhook's archive is never reopened.
|
||||||
|
func TestArchiveSweep_SkipsDeletedWebhookTargets(t *testing.T) {
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
env := setupSweeperTest(t)
|
||||||
|
|
||||||
|
webhookID := env.seedDatabaseTarget(t, `{"expiry":"1h"}`)
|
||||||
|
path := env.seedArchiveRows(
|
||||||
|
t, webhookID, time.Now().Add(-48*time.Hour),
|
||||||
|
)
|
||||||
|
|
||||||
|
require.NoError(
|
||||||
|
t,
|
||||||
|
env.mainDB.DB().
|
||||||
|
Where("webhook_id = ?", webhookID).
|
||||||
|
Delete(&database.Target{}).Error,
|
||||||
|
)
|
||||||
|
|
||||||
|
env.sweeper.ExportSweep(context.Background())
|
||||||
|
|
||||||
|
assert.Equal(
|
||||||
|
t, []string{sweepRowOld}, archivedEventIDs(t, path),
|
||||||
|
"a deleted target's archive must be left alone",
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestArchiveSweep_ConcurrentWrites proves the sweep serialises
|
||||||
|
// against writes through the per-webhook writer mutex. Run
|
||||||
|
// under -race, an unsynchronised sweep would be caught here.
|
||||||
|
func TestArchiveSweep_ConcurrentWrites(t *testing.T) {
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
env := setupSweeperTest(t)
|
||||||
|
|
||||||
|
webhookID := env.seedDatabaseTarget(t, `{"expiry":"1h"}`)
|
||||||
|
|
||||||
|
webhookDB := testWebhookDB(t)
|
||||||
|
|
||||||
|
// The deliveries are seeded up front, on the test's own
|
||||||
|
// goroutine: the seed helpers assert, and testify assertions
|
||||||
|
// must not run off the test goroutine.
|
||||||
|
deliveries := make(
|
||||||
|
[]*database.Delivery, 0, sweepConcurrentWrites,
|
||||||
|
)
|
||||||
|
|
||||||
|
for range sweepConcurrentWrites {
|
||||||
|
event := seedEvent(t, webhookDB, `{"n":1}`)
|
||||||
|
event.WebhookID = webhookID
|
||||||
|
|
||||||
|
deliveries = append(
|
||||||
|
deliveries,
|
||||||
|
seedDatabaseTargetDelivery(
|
||||||
|
t, webhookDB, event, `{"expiry":"1h"}`,
|
||||||
|
),
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
var wg sync.WaitGroup
|
||||||
|
|
||||||
|
wg.Add(2)
|
||||||
|
|
||||||
|
go func() {
|
||||||
|
defer wg.Done()
|
||||||
|
|
||||||
|
for _, d := range deliveries {
|
||||||
|
env.eng.ExportDeliverDatabase(webhookDB, d)
|
||||||
|
}
|
||||||
|
}()
|
||||||
|
|
||||||
|
go func() {
|
||||||
|
defer wg.Done()
|
||||||
|
|
||||||
|
for range sweepConcurrentWrites {
|
||||||
|
env.sweeper.ExportSweep(context.Background())
|
||||||
|
}
|
||||||
|
}()
|
||||||
|
|
||||||
|
wg.Wait()
|
||||||
|
|
||||||
|
assert.FileExists(t, env.archivePath(webhookID))
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestArchiveSweeper_StopsCleanly proves the background loop
|
||||||
|
// exits on OnStop rather than leaking a goroutine.
|
||||||
|
func TestArchiveSweeper_StopsCleanly(t *testing.T) {
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
env := setupSweeperTest(t)
|
||||||
|
|
||||||
|
webhookID := env.seedDatabaseTarget(t, `{"expiry":"1h"}`)
|
||||||
|
env.seedArchiveRows(
|
||||||
|
t, webhookID, time.Now().Add(-48*time.Hour),
|
||||||
|
)
|
||||||
|
|
||||||
|
env.sweeper.ExportSetInterval(time.Millisecond)
|
||||||
|
env.sweeper.ExportStart(context.Background())
|
||||||
|
|
||||||
|
// stop blocks on the loop's WaitGroup, so returning at all
|
||||||
|
// proves the loop observed the cancellation and exited.
|
||||||
|
env.sweeper.ExportStop()
|
||||||
|
}
|
||||||
@@ -94,6 +94,23 @@ type Notifier interface {
|
|||||||
Notify(tasks []Task)
|
Notify(tasks []Task)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// WebhookEvictor releases the delivery engine's per-webhook
|
||||||
|
// state for a webhook that no longer needs it — currently the
|
||||||
|
// cached archive writer of the database target, whose open
|
||||||
|
// file handle would otherwise outlive the webhook.
|
||||||
|
//
|
||||||
|
// It is deliberately separate from Notifier and deliberately
|
||||||
|
// one method wide: archiving lifecycle is not notification, and
|
||||||
|
// a single-method interface keeps the handlers package free of
|
||||||
|
// any dependency on the engine's internals while staying
|
||||||
|
// trivially fakeable in tests.
|
||||||
|
//
|
||||||
|
// EvictWebhook never deletes an archive file. It is idempotent
|
||||||
|
// and is a no-op for a webhook with no engine state.
|
||||||
|
type WebhookEvictor interface {
|
||||||
|
EvictWebhook(webhookID string)
|
||||||
|
}
|
||||||
|
|
||||||
// EngineParams are the fx dependencies for the delivery
|
// EngineParams are the fx dependencies for the delivery
|
||||||
// engine.
|
// engine.
|
||||||
type EngineParams struct {
|
type EngineParams struct {
|
||||||
@@ -127,6 +144,10 @@ type Engine struct {
|
|||||||
// httpTarget is retained so tests can reach the HTTP
|
// httpTarget is retained so tests can reach the HTTP
|
||||||
// target's shared client and circuit breakers.
|
// target's shared client and circuit breakers.
|
||||||
httpTarget *httpTarget
|
httpTarget *httpTarget
|
||||||
|
|
||||||
|
// dbTarget is retained so the engine can reach the archive
|
||||||
|
// writer registry for webhook eviction and the idle sweep.
|
||||||
|
dbTarget *databaseTarget
|
||||||
}
|
}
|
||||||
|
|
||||||
// New creates and registers the delivery engine with the
|
// New creates and registers the delivery engine with the
|
||||||
@@ -182,6 +203,19 @@ func (e *Engine) Notify(tasks []Task) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// EvictWebhook implements WebhookEvictor. It releases the
|
||||||
|
// engine's per-webhook archiving state: the database target's
|
||||||
|
// cached archive writer is dropped from the registry and its
|
||||||
|
// file handle closed. The archive file itself is left on disk
|
||||||
|
// — it is long-term storage the operator owns.
|
||||||
|
func (e *Engine) EvictWebhook(webhookID string) {
|
||||||
|
if e.dbTarget == nil {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
e.dbTarget.evict(webhookID)
|
||||||
|
}
|
||||||
|
|
||||||
// ScheduleRetry schedules a task to be re-enqueued onto the
|
// ScheduleRetry schedules a task to be re-enqueued onto the
|
||||||
// retry channel after delay. It implements the Scheduler
|
// retry channel after delay. It implements the Scheduler
|
||||||
// interface the targets use to own their durable retries.
|
// interface the targets use to own their durable retries.
|
||||||
|
|||||||
@@ -328,6 +328,90 @@ func (e *ExportArchiveWriter) DB() *gorm.DB {
|
|||||||
return e.w.db
|
return e.w.db
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// ExportHasArchiveWriter reports whether the database target
|
||||||
|
// currently caches an archive writer for a webhook.
|
||||||
|
func (e *Engine) ExportHasArchiveWriter(
|
||||||
|
webhookID string,
|
||||||
|
) bool {
|
||||||
|
e.dbTarget.mu.Lock()
|
||||||
|
defer e.dbTarget.mu.Unlock()
|
||||||
|
|
||||||
|
_, ok := e.dbTarget.writers[webhookID]
|
||||||
|
|
||||||
|
return ok
|
||||||
|
}
|
||||||
|
|
||||||
|
// ExportArchiveHandleOpen reports whether the cached archive
|
||||||
|
// writer for a webhook holds an open database handle. It
|
||||||
|
// returns false when no writer is cached.
|
||||||
|
func (e *Engine) ExportArchiveHandleOpen(
|
||||||
|
webhookID string,
|
||||||
|
) bool {
|
||||||
|
e.dbTarget.mu.Lock()
|
||||||
|
w, ok := e.dbTarget.writers[webhookID]
|
||||||
|
e.dbTarget.mu.Unlock()
|
||||||
|
|
||||||
|
if !ok {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
w.mu.Lock()
|
||||||
|
defer w.mu.Unlock()
|
||||||
|
|
||||||
|
return w.db != nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// ExportEnsureArchiveWriter creates (if needed) and returns the
|
||||||
|
// archive file path of the cached writer for a webhook, so a
|
||||||
|
// test can prime the registry the way a delivery would.
|
||||||
|
func (e *Engine) ExportEnsureArchiveWriter(
|
||||||
|
webhookID string,
|
||||||
|
) (string, error) {
|
||||||
|
w, err := e.dbTarget.writerFor(webhookID)
|
||||||
|
if err != nil {
|
||||||
|
return "", err
|
||||||
|
}
|
||||||
|
|
||||||
|
return w.path, nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// NewTestArchiveSweeper builds an ArchiveSweeper backed by the
|
||||||
|
// given main database and engine, without the fx lifecycle.
|
||||||
|
// Intended for tests.
|
||||||
|
func NewTestArchiveSweeper(
|
||||||
|
db *database.Database,
|
||||||
|
eng *Engine,
|
||||||
|
log *slog.Logger,
|
||||||
|
) *ArchiveSweeper {
|
||||||
|
return &ArchiveSweeper{
|
||||||
|
db: db,
|
||||||
|
eng: eng,
|
||||||
|
log: log,
|
||||||
|
interval: time.Hour,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// ExportSweep runs a single archive sweep synchronously for
|
||||||
|
// tests.
|
||||||
|
func (s *ArchiveSweeper) ExportSweep(ctx context.Context) {
|
||||||
|
s.sweep(ctx)
|
||||||
|
}
|
||||||
|
|
||||||
|
// ExportStart starts the sweeper's background loop for tests.
|
||||||
|
func (s *ArchiveSweeper) ExportStart(ctx context.Context) {
|
||||||
|
s.start(ctx)
|
||||||
|
}
|
||||||
|
|
||||||
|
// ExportStop stops the sweeper's background loop for tests.
|
||||||
|
func (s *ArchiveSweeper) ExportStop() {
|
||||||
|
s.stop()
|
||||||
|
}
|
||||||
|
|
||||||
|
// ExportSetInterval overrides the sweep interval for tests.
|
||||||
|
func (s *ArchiveSweeper) ExportSetInterval(d time.Duration) {
|
||||||
|
s.interval = d
|
||||||
|
}
|
||||||
|
|
||||||
// ExportParseArchiveExpiry exposes parseArchiveExpiry.
|
// ExportParseArchiveExpiry exposes parseArchiveExpiry.
|
||||||
func ExportParseArchiveExpiry(
|
func ExportParseArchiveExpiry(
|
||||||
configJSON string,
|
configJSON string,
|
||||||
|
|||||||
@@ -90,12 +90,15 @@ func (e *Engine) initTargets(client *http.Client) {
|
|||||||
client: client,
|
client: client,
|
||||||
}
|
}
|
||||||
|
|
||||||
|
dbT := &databaseTarget{eng: e}
|
||||||
|
|
||||||
e.httpTarget = httpT
|
e.httpTarget = httpT
|
||||||
|
e.dbTarget = dbT
|
||||||
|
|
||||||
e.targets = map[database.TargetType]Target{
|
e.targets = map[database.TargetType]Target{
|
||||||
database.TargetTypeHTTP: httpT,
|
database.TargetTypeHTTP: httpT,
|
||||||
database.TargetTypeSlack: slackT,
|
database.TargetTypeSlack: slackT,
|
||||||
database.TargetTypeDatabase: &databaseTarget{eng: e},
|
database.TargetTypeDatabase: dbT,
|
||||||
database.TargetTypeLog: &logTarget{eng: e},
|
database.TargetTypeLog: &logTarget{eng: e},
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -5,6 +5,7 @@ import (
|
|||||||
"fmt"
|
"fmt"
|
||||||
"path/filepath"
|
"path/filepath"
|
||||||
"sync"
|
"sync"
|
||||||
|
"time"
|
||||||
|
|
||||||
"gorm.io/gorm"
|
"gorm.io/gorm"
|
||||||
"sneak.berlin/go/webhooker/internal/database"
|
"sneak.berlin/go/webhooker/internal/database"
|
||||||
@@ -111,15 +112,11 @@ func (t *databaseTarget) archive(d *database.Delivery) error {
|
|||||||
func (t *databaseTarget) writerFor(
|
func (t *databaseTarget) writerFor(
|
||||||
webhookID string,
|
webhookID string,
|
||||||
) (*archiveWriter, error) {
|
) (*archiveWriter, error) {
|
||||||
if t.eng.dbManager == nil {
|
path, err := t.archivePath(webhookID)
|
||||||
return nil, errArchiveNoDataDir
|
if err != nil {
|
||||||
|
return nil, err
|
||||||
}
|
}
|
||||||
|
|
||||||
dir := filepath.Dir(t.eng.dbManager.DBPath(webhookID))
|
|
||||||
path := filepath.Join(
|
|
||||||
dir, fmt.Sprintf("archive-%s.db", webhookID),
|
|
||||||
)
|
|
||||||
|
|
||||||
t.mu.Lock()
|
t.mu.Lock()
|
||||||
defer t.mu.Unlock()
|
defer t.mu.Unlock()
|
||||||
|
|
||||||
@@ -135,3 +132,86 @@ func (t *databaseTarget) writerFor(
|
|||||||
|
|
||||||
return w, nil
|
return w, nil
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// archivePath returns the archive file path for a webhook: it
|
||||||
|
// lives beside the per-webhook event database in the data
|
||||||
|
// directory. It does not touch the filesystem.
|
||||||
|
func (t *databaseTarget) archivePath(
|
||||||
|
webhookID string,
|
||||||
|
) (string, error) {
|
||||||
|
if t.eng.dbManager == nil {
|
||||||
|
return "", errArchiveNoDataDir
|
||||||
|
}
|
||||||
|
|
||||||
|
dir := filepath.Dir(t.eng.dbManager.DBPath(webhookID))
|
||||||
|
|
||||||
|
return filepath.Join(
|
||||||
|
dir, fmt.Sprintf("archive-%s.db", webhookID),
|
||||||
|
), nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// evict drops a webhook's archive writer from the registry and
|
||||||
|
// closes its handle, so a deleted webhook does not leave a
|
||||||
|
// writer (and an open archive handle within its debounce
|
||||||
|
// window) alive for the process lifetime.
|
||||||
|
//
|
||||||
|
// The map entry is removed under the registry lock, which is
|
||||||
|
// then released before the handle is closed under the writer's
|
||||||
|
// own lock: that ordering keeps the registry available to other
|
||||||
|
// webhooks while an in-flight write on this one drains, and
|
||||||
|
// closing under the writer's lock means eviction can never race
|
||||||
|
// a write.
|
||||||
|
//
|
||||||
|
// Eviction is idempotent and silent for a webhook with no
|
||||||
|
// writer, which is the common case: a webhook with no database
|
||||||
|
// target never creates one. It never deletes the archive file.
|
||||||
|
func (t *databaseTarget) evict(webhookID string) {
|
||||||
|
t.mu.Lock()
|
||||||
|
|
||||||
|
w, ok := t.writers[webhookID]
|
||||||
|
if ok {
|
||||||
|
delete(t.writers, webhookID)
|
||||||
|
}
|
||||||
|
|
||||||
|
t.mu.Unlock()
|
||||||
|
|
||||||
|
if !ok {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
w.evict()
|
||||||
|
|
||||||
|
t.eng.log.Info(
|
||||||
|
"evicted archive writer",
|
||||||
|
"webhook_id", webhookID,
|
||||||
|
"path", w.path,
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// sweepWebhook prunes one webhook's archive of rows older than
|
||||||
|
// expiry, without requiring a write. It returns nil (nothing to
|
||||||
|
// do) when the archive file does not exist, so a sweep never
|
||||||
|
// creates an archive for a webhook that has a database target
|
||||||
|
// but has never received an event.
|
||||||
|
func (t *databaseTarget) sweepWebhook(
|
||||||
|
webhookID string, expiry time.Duration,
|
||||||
|
) error {
|
||||||
|
path, err := t.archivePath(webhookID)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
|
||||||
|
// Check before taking a writer at all: a webhook whose
|
||||||
|
// archive has never been created gets no writer, no handle,
|
||||||
|
// and no file.
|
||||||
|
if !fileExists(path) {
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
|
w, err := t.writerFor(webhookID)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
|
||||||
|
return w.sweepExpired(expiry)
|
||||||
|
}
|
||||||
|
|||||||
@@ -24,6 +24,20 @@ const archiveExpiryNever = "never"
|
|||||||
// offline archiving, but never more than once per this window.
|
// offline archiving, but never more than once per this window.
|
||||||
const archiveReopenDebounce = time.Second
|
const archiveReopenDebounce = time.Second
|
||||||
|
|
||||||
|
const (
|
||||||
|
// archiveModeCreate is the SQLite URI mode used by the write
|
||||||
|
// path: open the archive file, creating it if missing, so a
|
||||||
|
// first write (or a write after the operator moved the file
|
||||||
|
// away) recreates it.
|
||||||
|
archiveModeCreate = "rwc"
|
||||||
|
|
||||||
|
// archiveModeExisting is the SQLite URI mode used by the idle
|
||||||
|
// sweep: open read-write but never create. A sweep must never
|
||||||
|
// conjure an empty archive file for a webhook that has a
|
||||||
|
// database target but has never received an event.
|
||||||
|
archiveModeExisting = "rw"
|
||||||
|
)
|
||||||
|
|
||||||
var (
|
var (
|
||||||
// errArchiveMissingWebhookID is returned when an event to
|
// errArchiveMissingWebhookID is returned when an event to
|
||||||
// archive has no webhook id to key its archive file on.
|
// archive has no webhook id to key its archive file on.
|
||||||
@@ -44,6 +58,15 @@ var (
|
|||||||
errArchiveExpiryNotPositive = errors.New(
|
errArchiveExpiryNotPositive = errors.New(
|
||||||
"expiry must be a positive duration or \"never\"",
|
"expiry must be a positive duration or \"never\"",
|
||||||
)
|
)
|
||||||
|
|
||||||
|
// errArchiveWriterEvicted is returned when a writer that has
|
||||||
|
// been evicted (its webhook was deleted, or its last database
|
||||||
|
// target was removed) is used again. An evicted writer is no
|
||||||
|
// longer in the registry, so reopening its file would leak a
|
||||||
|
// handle nothing owns.
|
||||||
|
errArchiveWriterEvicted = errors.New(
|
||||||
|
"archive writer has been evicted",
|
||||||
|
)
|
||||||
)
|
)
|
||||||
|
|
||||||
// databaseTargetConfig is the optional per-target JSON config
|
// databaseTargetConfig is the optional per-target JSON config
|
||||||
@@ -161,6 +184,12 @@ type archiveWriter struct {
|
|||||||
db *gorm.DB
|
db *gorm.DB
|
||||||
lastReopen time.Time
|
lastReopen time.Time
|
||||||
reopens int
|
reopens int
|
||||||
|
|
||||||
|
// evicted marks a writer that has been removed from the
|
||||||
|
// per-webhook registry. Its handle is closed and it must
|
||||||
|
// never open the file again: nothing holds it any more, so a
|
||||||
|
// reopen would leak the handle for the process lifetime.
|
||||||
|
evicted bool
|
||||||
}
|
}
|
||||||
|
|
||||||
// newArchiveWriter builds an archiveWriter for a file path with
|
// newArchiveWriter builds an archiveWriter for a file path with
|
||||||
@@ -185,6 +214,12 @@ func (w *archiveWriter) write(
|
|||||||
w.mu.Lock()
|
w.mu.Lock()
|
||||||
defer w.mu.Unlock()
|
defer w.mu.Unlock()
|
||||||
|
|
||||||
|
if w.evicted {
|
||||||
|
return fmt.Errorf(
|
||||||
|
"%w: %s", errArchiveWriterEvicted, w.path,
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
if w.db == nil || !fileExists(w.path) {
|
if w.db == nil || !fileExists(w.path) {
|
||||||
err := w.reopen(expiry)
|
err := w.reopen(expiry)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
@@ -212,7 +247,19 @@ func (w *archiveWriter) write(
|
|||||||
// its schema, records the reopen time, and prunes expired rows
|
// its schema, records the reopen time, and prunes expired rows
|
||||||
// when expiry is positive.
|
// when expiry is positive.
|
||||||
func (w *archiveWriter) open(expiry time.Duration) error {
|
func (w *archiveWriter) open(expiry time.Duration) error {
|
||||||
dbURL := fmt.Sprintf("file:%s?mode=rwc", w.path)
|
return w.openMode(archiveModeCreate, expiry)
|
||||||
|
}
|
||||||
|
|
||||||
|
// openMode opens the archive file with the given SQLite URI
|
||||||
|
// mode, migrates its schema, records the reopen time, and
|
||||||
|
// prunes expired rows when expiry is positive. The write path
|
||||||
|
// passes archiveModeCreate so a missing file is recreated; the
|
||||||
|
// idle sweep passes archiveModeExisting so a missing file is an
|
||||||
|
// error rather than a newly conjured empty archive.
|
||||||
|
func (w *archiveWriter) openMode(
|
||||||
|
mode string, expiry time.Duration,
|
||||||
|
) error {
|
||||||
|
dbURL := fmt.Sprintf("file:%s?mode=%s", w.path, mode)
|
||||||
|
|
||||||
sqlDB, err := sql.Open("sqlite", dbURL)
|
sqlDB, err := sql.Open("sqlite", dbURL)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
@@ -275,6 +322,63 @@ func (w *archiveWriter) close() {
|
|||||||
w.db = nil
|
w.db = nil
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// sweepExpired prunes an archive that may have gone idle, with
|
||||||
|
// no write to trigger the usual on-reopen prune. It takes the
|
||||||
|
// writer's own mutex for the whole operation, so a sweep is
|
||||||
|
// ordered against concurrent writes rather than reaching around
|
||||||
|
// them to the file.
|
||||||
|
//
|
||||||
|
// It never creates the archive file: a missing file is skipped,
|
||||||
|
// and the reopen uses archiveModeExisting so SQLite itself
|
||||||
|
// refuses to create one if the file disappears between the
|
||||||
|
// check and the open.
|
||||||
|
//
|
||||||
|
// The archive is left CLOSED afterwards. An idle archive holding
|
||||||
|
// no handle is what keeps the operator's move-the-file-away
|
||||||
|
// workflow working; the next write reopens (and recreates) the
|
||||||
|
// file as it always has.
|
||||||
|
func (w *archiveWriter) sweepExpired(expiry time.Duration) error {
|
||||||
|
w.mu.Lock()
|
||||||
|
defer w.mu.Unlock()
|
||||||
|
|
||||||
|
if w.evicted {
|
||||||
|
return fmt.Errorf(
|
||||||
|
"%w: %s", errArchiveWriterEvicted, w.path,
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
if !fileExists(w.path) {
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// Drop any live handle first so the prune runs against a
|
||||||
|
// freshly opened file, matching the write path's semantics.
|
||||||
|
w.close()
|
||||||
|
|
||||||
|
err := w.openMode(archiveModeExisting, expiry)
|
||||||
|
if err != nil {
|
||||||
|
return err
|
||||||
|
}
|
||||||
|
|
||||||
|
w.close()
|
||||||
|
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
|
// evict closes the writer's handle and marks it unusable. It is
|
||||||
|
// called when the writer leaves the registry, either because the
|
||||||
|
// webhook was deleted or because its last database target was
|
||||||
|
// removed. The archive FILE is deliberately left on disk: it is
|
||||||
|
// long-term storage an operator may still want.
|
||||||
|
func (w *archiveWriter) evict() {
|
||||||
|
w.mu.Lock()
|
||||||
|
defer w.mu.Unlock()
|
||||||
|
|
||||||
|
w.evicted = true
|
||||||
|
|
||||||
|
w.close()
|
||||||
|
}
|
||||||
|
|
||||||
// prune deletes archived rows older than expiry, measured from
|
// prune deletes archived rows older than expiry, measured from
|
||||||
// each row's archived time. It runs on every (re)open, and
|
// each row's archived time. It runs on every (re)open, and
|
||||||
// because the file is reopened after writes this keeps the
|
// because the file is reopened after writes this keeps the
|
||||||
|
|||||||
130
internal/delivery/target_database_evict_test.go
Normal file
130
internal/delivery/target_database_evict_test.go
Normal file
@@ -0,0 +1,130 @@
|
|||||||
|
package delivery_test
|
||||||
|
|
||||||
|
import (
|
||||||
|
"fmt"
|
||||||
|
"net/http"
|
||||||
|
"path/filepath"
|
||||||
|
"testing"
|
||||||
|
"time"
|
||||||
|
|
||||||
|
"github.com/stretchr/testify/assert"
|
||||||
|
"github.com/stretchr/testify/require"
|
||||||
|
"sneak.berlin/go/webhooker/internal/database"
|
||||||
|
"sneak.berlin/go/webhooker/internal/delivery"
|
||||||
|
)
|
||||||
|
|
||||||
|
// evictTestEngine builds an engine backed by a temporary data
|
||||||
|
// directory and returns it along with that directory.
|
||||||
|
func evictTestEngine(t *testing.T) (*delivery.Engine, string) {
|
||||||
|
t.Helper()
|
||||||
|
|
||||||
|
dataDir := t.TempDir()
|
||||||
|
|
||||||
|
eng := delivery.NewTestEngineWithDB(
|
||||||
|
nil,
|
||||||
|
database.NewTestWebhookDBManager(dataDir),
|
||||||
|
archiveTestLogger(),
|
||||||
|
&http.Client{Timeout: 5 * time.Second},
|
||||||
|
1,
|
||||||
|
)
|
||||||
|
|
||||||
|
return eng, dataDir
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestEvictWebhook_ClosesAndRemovesWriter proves that evicting
|
||||||
|
// a webhook drops its archive writer from the registry and
|
||||||
|
// closes the open archive handle, rather than leaving both
|
||||||
|
// alive for the process lifetime.
|
||||||
|
func TestEvictWebhook_ClosesAndRemovesWriter(t *testing.T) {
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
eng, dataDir := evictTestEngine(t)
|
||||||
|
|
||||||
|
webhookDB := testWebhookDB(t)
|
||||||
|
event := seedEvent(t, webhookDB, `{"archived":true}`)
|
||||||
|
d := seedDatabaseTargetDelivery(t, webhookDB, event, "")
|
||||||
|
|
||||||
|
eng.ExportDeliverDatabase(webhookDB, d)
|
||||||
|
|
||||||
|
webhookID := event.WebhookID
|
||||||
|
|
||||||
|
require.True(
|
||||||
|
t, eng.ExportHasArchiveWriter(webhookID),
|
||||||
|
"a delivery should have cached an archive writer",
|
||||||
|
)
|
||||||
|
require.True(
|
||||||
|
t, eng.ExportArchiveHandleOpen(webhookID),
|
||||||
|
"the writer should hold an open handle after a write",
|
||||||
|
)
|
||||||
|
|
||||||
|
eng.EvictWebhook(webhookID)
|
||||||
|
|
||||||
|
assert.False(
|
||||||
|
t, eng.ExportHasArchiveWriter(webhookID),
|
||||||
|
"eviction should remove the registry entry",
|
||||||
|
)
|
||||||
|
assert.False(
|
||||||
|
t, eng.ExportArchiveHandleOpen(webhookID),
|
||||||
|
"eviction should close the archive handle",
|
||||||
|
)
|
||||||
|
|
||||||
|
archivePath := filepath.Join(
|
||||||
|
dataDir, fmt.Sprintf("archive-%s.db", webhookID),
|
||||||
|
)
|
||||||
|
assert.FileExists(
|
||||||
|
t, archivePath,
|
||||||
|
"eviction must not delete the archive file",
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestEvictWebhook_UnknownWebhookIsNoOp proves eviction is safe
|
||||||
|
// for the common case of a webhook that never had a database
|
||||||
|
// target, and that repeating it does not panic.
|
||||||
|
func TestEvictWebhook_UnknownWebhookIsNoOp(t *testing.T) {
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
eng, _ := evictTestEngine(t)
|
||||||
|
|
||||||
|
assert.NotPanics(t, func() {
|
||||||
|
eng.EvictWebhook("no-such-webhook")
|
||||||
|
eng.EvictWebhook("no-such-webhook")
|
||||||
|
})
|
||||||
|
|
||||||
|
assert.False(
|
||||||
|
t, eng.ExportHasArchiveWriter("no-such-webhook"),
|
||||||
|
"eviction must not create a writer",
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestEvictWebhook_EvictedWriterDoesNotReopen proves an evicted
|
||||||
|
// writer refuses further writes instead of silently reopening
|
||||||
|
// the archive file: nothing holds it any more, so a reopened
|
||||||
|
// handle would leak.
|
||||||
|
func TestEvictWebhook_EvictedWriterDoesNotReopen(t *testing.T) {
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
eng, _ := evictTestEngine(t)
|
||||||
|
|
||||||
|
webhookDB := testWebhookDB(t)
|
||||||
|
event := seedEvent(t, webhookDB, `{"archived":true}`)
|
||||||
|
d := seedDatabaseTargetDelivery(t, webhookDB, event, "")
|
||||||
|
|
||||||
|
eng.ExportDeliverDatabase(webhookDB, d)
|
||||||
|
require.True(
|
||||||
|
t, eng.ExportHasArchiveWriter(event.WebhookID),
|
||||||
|
)
|
||||||
|
|
||||||
|
eng.EvictWebhook(event.WebhookID)
|
||||||
|
|
||||||
|
// A fresh delivery for the same webhook gets a brand new
|
||||||
|
// writer from the registry, so archiving keeps working.
|
||||||
|
second := seedDatabaseTargetDelivery(
|
||||||
|
t, webhookDB, event, "",
|
||||||
|
)
|
||||||
|
eng.ExportDeliverDatabase(webhookDB, second)
|
||||||
|
|
||||||
|
assert.True(
|
||||||
|
t, eng.ExportHasArchiveWriter(event.WebhookID),
|
||||||
|
"a later delivery should recreate the writer",
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -29,8 +29,10 @@ func (h *Handlers) HandleLoginPage() http.HandlerFunc {
|
|||||||
// HandleLoginSubmit handles the login form submission (POST)
|
// HandleLoginSubmit handles the login form submission (POST)
|
||||||
func (h *Handlers) HandleLoginSubmit() http.HandlerFunc {
|
func (h *Handlers) HandleLoginSubmit() http.HandlerFunc {
|
||||||
return func(w http.ResponseWriter, r *http.Request) {
|
return func(w http.ResponseWriter, r *http.Request) {
|
||||||
// The body size cap is enforced by the MaxBodySize
|
// Limit request body to prevent memory exhaustion
|
||||||
// middleware, which runs before CSRF parses the form.
|
r.Body = http.MaxBytesReader(w, r.Body, 1<<maxBodyShift)
|
||||||
|
|
||||||
|
// Parse form data
|
||||||
err := r.ParseForm()
|
err := r.ParseForm()
|
||||||
if err != nil {
|
if err != nil {
|
||||||
h.log.Error("failed to parse form", "error", err)
|
h.log.Error("failed to parse form", "error", err)
|
||||||
|
|||||||
@@ -51,6 +51,7 @@ type HandlersParams struct {
|
|||||||
Healthcheck *healthcheck.Healthcheck
|
Healthcheck *healthcheck.Healthcheck
|
||||||
Session *session.Session
|
Session *session.Session
|
||||||
Notifier delivery.Notifier
|
Notifier delivery.Notifier
|
||||||
|
Evictor delivery.WebhookEvictor
|
||||||
}
|
}
|
||||||
|
|
||||||
// Handlers provides HTTP handler methods for all application
|
// Handlers provides HTTP handler methods for all application
|
||||||
@@ -63,6 +64,7 @@ type Handlers struct {
|
|||||||
dbMgr *database.WebhookDBManager
|
dbMgr *database.WebhookDBManager
|
||||||
session *session.Session
|
session *session.Session
|
||||||
notifier delivery.Notifier
|
notifier delivery.Notifier
|
||||||
|
evictor delivery.WebhookEvictor
|
||||||
templates map[string]*template.Template
|
templates map[string]*template.Template
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -97,6 +99,7 @@ func New(
|
|||||||
s.dbMgr = params.WebhookDBMgr
|
s.dbMgr = params.WebhookDBMgr
|
||||||
s.session = params.Session
|
s.session = params.Session
|
||||||
s.notifier = params.Notifier
|
s.notifier = params.Notifier
|
||||||
|
s.evictor = params.Evictor
|
||||||
|
|
||||||
// Parse all page templates once at startup
|
// Parse all page templates once at startup
|
||||||
s.templates = map[string]*template.Template{
|
s.templates = map[string]*template.Template{
|
||||||
|
|||||||
@@ -4,6 +4,7 @@ import (
|
|||||||
"context"
|
"context"
|
||||||
"net/http"
|
"net/http"
|
||||||
"net/http/httptest"
|
"net/http/httptest"
|
||||||
|
"sync"
|
||||||
"testing"
|
"testing"
|
||||||
|
|
||||||
"github.com/stretchr/testify/assert"
|
"github.com/stretchr/testify/assert"
|
||||||
@@ -24,6 +25,32 @@ type noopNotifier struct{}
|
|||||||
|
|
||||||
func (n *noopNotifier) Notify([]delivery.Task) {}
|
func (n *noopNotifier) Notify([]delivery.Task) {}
|
||||||
|
|
||||||
|
// recordingEvictor is a delivery.WebhookEvictor that records
|
||||||
|
// the webhook ids it was asked to evict, so a test can prove
|
||||||
|
// that a deletion path reached the delivery engine.
|
||||||
|
type recordingEvictor struct {
|
||||||
|
mu sync.Mutex
|
||||||
|
evicted []string
|
||||||
|
}
|
||||||
|
|
||||||
|
func (r *recordingEvictor) EvictWebhook(webhookID string) {
|
||||||
|
r.mu.Lock()
|
||||||
|
defer r.mu.Unlock()
|
||||||
|
|
||||||
|
r.evicted = append(r.evicted, webhookID)
|
||||||
|
}
|
||||||
|
|
||||||
|
// Evicted returns a copy of the recorded webhook ids.
|
||||||
|
func (r *recordingEvictor) Evicted() []string {
|
||||||
|
r.mu.Lock()
|
||||||
|
defer r.mu.Unlock()
|
||||||
|
|
||||||
|
out := make([]string, len(r.evicted))
|
||||||
|
copy(out, r.evicted)
|
||||||
|
|
||||||
|
return out
|
||||||
|
}
|
||||||
|
|
||||||
func newTestApp(
|
func newTestApp(
|
||||||
t *testing.T,
|
t *testing.T,
|
||||||
targets ...any,
|
targets ...any,
|
||||||
@@ -47,6 +74,12 @@ func newTestApp(
|
|||||||
func() delivery.Notifier {
|
func() delivery.Notifier {
|
||||||
return &noopNotifier{}
|
return &noopNotifier{}
|
||||||
},
|
},
|
||||||
|
func() *recordingEvictor {
|
||||||
|
return &recordingEvictor{}
|
||||||
|
},
|
||||||
|
func(r *recordingEvictor) delivery.WebhookEvictor {
|
||||||
|
return r
|
||||||
|
},
|
||||||
handlers.New,
|
handlers.New,
|
||||||
),
|
),
|
||||||
fx.Populate(targets...),
|
fx.Populate(targets...),
|
||||||
|
|||||||
@@ -31,8 +31,9 @@ func (h *Handlers) HandlePasswordChange() http.HandlerFunc {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
// The body size cap is enforced by the MaxBodySize
|
// Limit request body to prevent memory exhaustion.
|
||||||
// middleware, which runs before CSRF parses the form.
|
r.Body = http.MaxBytesReader(w, r.Body, 1<<maxBodyShift)
|
||||||
|
|
||||||
err := r.ParseForm()
|
err := r.ParseForm()
|
||||||
if err != nil {
|
if err != nil {
|
||||||
h.log.Error("failed to parse form", "error", err)
|
h.log.Error("failed to parse form", "error", err)
|
||||||
|
|||||||
305
internal/handlers/source_delete_test.go
Normal file
305
internal/handlers/source_delete_test.go
Normal file
@@ -0,0 +1,305 @@
|
|||||||
|
package handlers_test
|
||||||
|
|
||||||
|
import (
|
||||||
|
"context"
|
||||||
|
"net/http"
|
||||||
|
"net/http/httptest"
|
||||||
|
"os"
|
||||||
|
"path/filepath"
|
||||||
|
"testing"
|
||||||
|
|
||||||
|
"github.com/go-chi/chi"
|
||||||
|
"github.com/stretchr/testify/assert"
|
||||||
|
"github.com/stretchr/testify/require"
|
||||||
|
"gorm.io/gorm/clause"
|
||||||
|
"sneak.berlin/go/webhooker/internal/database"
|
||||||
|
"sneak.berlin/go/webhooker/internal/handlers"
|
||||||
|
"sneak.berlin/go/webhooker/internal/session"
|
||||||
|
)
|
||||||
|
|
||||||
|
const (
|
||||||
|
deleteTestUserID = "test-user-id"
|
||||||
|
deleteTestUsername = "testuser"
|
||||||
|
|
||||||
|
// paramSourceID and paramTargetID are the chi URL parameter
|
||||||
|
// names the deletion handlers read.
|
||||||
|
paramSourceID = "sourceID"
|
||||||
|
paramTargetID = "targetID"
|
||||||
|
)
|
||||||
|
|
||||||
|
// seedWebhook inserts a webhook owned by the test user and
|
||||||
|
// returns it.
|
||||||
|
func seedWebhook(
|
||||||
|
t *testing.T,
|
||||||
|
db *database.Database,
|
||||||
|
) *database.Webhook {
|
||||||
|
t.Helper()
|
||||||
|
|
||||||
|
wh := &database.Webhook{
|
||||||
|
UserID: deleteTestUserID,
|
||||||
|
Name: "delete-me",
|
||||||
|
}
|
||||||
|
|
||||||
|
require.NoError(
|
||||||
|
t,
|
||||||
|
db.DB().Omit(clause.Associations).Create(wh).Error,
|
||||||
|
)
|
||||||
|
|
||||||
|
return wh
|
||||||
|
}
|
||||||
|
|
||||||
|
// seedTarget inserts a target of the given type for a webhook
|
||||||
|
// and returns it.
|
||||||
|
func seedTarget(
|
||||||
|
t *testing.T,
|
||||||
|
db *database.Database,
|
||||||
|
webhookID string,
|
||||||
|
targetType database.TargetType,
|
||||||
|
) *database.Target {
|
||||||
|
t.Helper()
|
||||||
|
|
||||||
|
tgt := &database.Target{
|
||||||
|
WebhookID: webhookID,
|
||||||
|
Name: "t-" + string(targetType),
|
||||||
|
Type: targetType,
|
||||||
|
Active: true,
|
||||||
|
}
|
||||||
|
|
||||||
|
require.NoError(
|
||||||
|
t,
|
||||||
|
db.DB().Omit(clause.Associations).Create(tgt).Error,
|
||||||
|
)
|
||||||
|
|
||||||
|
return tgt
|
||||||
|
}
|
||||||
|
|
||||||
|
// archivePathFor returns the archive database path the
|
||||||
|
// delivery engine would use for a webhook: beside the webhook's
|
||||||
|
// event database in the data directory.
|
||||||
|
func archivePathFor(
|
||||||
|
t *testing.T,
|
||||||
|
mgr *database.WebhookDBManager,
|
||||||
|
webhookID string,
|
||||||
|
) string {
|
||||||
|
t.Helper()
|
||||||
|
|
||||||
|
return filepath.Join(
|
||||||
|
filepath.Dir(mgr.DBPath(webhookID)),
|
||||||
|
"archive-"+webhookID+".db",
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// writeArchivePlaceholder creates a stand-in archive file so a
|
||||||
|
// test can assert the file survives webhook deletion.
|
||||||
|
func writeArchivePlaceholder(path string) error {
|
||||||
|
return os.WriteFile(path, []byte("archive"), 0o600)
|
||||||
|
}
|
||||||
|
|
||||||
|
// postRequest builds an authenticated POST request carrying the
|
||||||
|
// given chi URL parameters.
|
||||||
|
func postRequest(
|
||||||
|
path string,
|
||||||
|
cookies []*http.Cookie,
|
||||||
|
params map[string]string,
|
||||||
|
) *http.Request {
|
||||||
|
req := httptest.NewRequestWithContext(
|
||||||
|
context.Background(), http.MethodPost, path, nil,
|
||||||
|
)
|
||||||
|
|
||||||
|
for _, c := range cookies {
|
||||||
|
req.AddCookie(c)
|
||||||
|
}
|
||||||
|
|
||||||
|
rctx := chi.NewRouteContext()
|
||||||
|
for k, v := range params {
|
||||||
|
rctx.URLParams.Add(k, v)
|
||||||
|
}
|
||||||
|
|
||||||
|
return req.WithContext(
|
||||||
|
context.WithValue(req.Context(), chi.RouteCtxKey, rctx),
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestHandleSourceDelete_EvictsArchiveWriter proves that
|
||||||
|
// deleting a webhook reaches the delivery engine and releases
|
||||||
|
// the webhook's archive writer, exercised through the real
|
||||||
|
// deletion handler rather than by calling the evictor directly.
|
||||||
|
func TestHandleSourceDelete_EvictsArchiveWriter(t *testing.T) {
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
var (
|
||||||
|
h *handlers.Handlers
|
||||||
|
sess *session.Session
|
||||||
|
db *database.Database
|
||||||
|
ev *recordingEvictor
|
||||||
|
)
|
||||||
|
|
||||||
|
app := newTestApp(t, &h, &sess, &db, &ev)
|
||||||
|
app.RequireStart()
|
||||||
|
|
||||||
|
t.Cleanup(app.RequireStop)
|
||||||
|
|
||||||
|
wh := seedWebhook(t, db)
|
||||||
|
seedTarget(t, db, wh.ID, database.TargetTypeDatabase)
|
||||||
|
|
||||||
|
cookies := authenticatedCookies(
|
||||||
|
t, sess, deleteTestUserID, deleteTestUsername,
|
||||||
|
)
|
||||||
|
|
||||||
|
req := postRequest(
|
||||||
|
"/source/"+wh.ID+"/delete",
|
||||||
|
cookies,
|
||||||
|
map[string]string{paramSourceID: wh.ID},
|
||||||
|
)
|
||||||
|
w := httptest.NewRecorder()
|
||||||
|
|
||||||
|
h.HandleSourceDelete().ServeHTTP(w, req)
|
||||||
|
|
||||||
|
require.Equal(t, http.StatusSeeOther, w.Code)
|
||||||
|
assert.Equal(
|
||||||
|
t, []string{wh.ID}, ev.Evicted(),
|
||||||
|
"deleting a webhook should evict its archive writer",
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestHandleSourceDelete_KeepsArchiveFile proves that deleting
|
||||||
|
// a webhook does not remove its archive database file: the
|
||||||
|
// archive is long-term storage the operator owns.
|
||||||
|
func TestHandleSourceDelete_KeepsArchiveFile(t *testing.T) {
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
var (
|
||||||
|
h *handlers.Handlers
|
||||||
|
sess *session.Session
|
||||||
|
db *database.Database
|
||||||
|
mgr *database.WebhookDBManager
|
||||||
|
)
|
||||||
|
|
||||||
|
app := newTestApp(t, &h, &sess, &db, &mgr)
|
||||||
|
app.RequireStart()
|
||||||
|
|
||||||
|
t.Cleanup(app.RequireStop)
|
||||||
|
|
||||||
|
wh := seedWebhook(t, db)
|
||||||
|
|
||||||
|
// Place an archive file where the delivery engine would.
|
||||||
|
archivePath := archivePathFor(t, mgr, wh.ID)
|
||||||
|
require.NoError(
|
||||||
|
t,
|
||||||
|
writeArchivePlaceholder(archivePath),
|
||||||
|
)
|
||||||
|
|
||||||
|
cookies := authenticatedCookies(
|
||||||
|
t, sess, deleteTestUserID, deleteTestUsername,
|
||||||
|
)
|
||||||
|
|
||||||
|
req := postRequest(
|
||||||
|
"/source/"+wh.ID+"/delete",
|
||||||
|
cookies,
|
||||||
|
map[string]string{paramSourceID: wh.ID},
|
||||||
|
)
|
||||||
|
w := httptest.NewRecorder()
|
||||||
|
|
||||||
|
h.HandleSourceDelete().ServeHTTP(w, req)
|
||||||
|
|
||||||
|
require.Equal(t, http.StatusSeeOther, w.Code)
|
||||||
|
assert.FileExists(
|
||||||
|
t, archivePath,
|
||||||
|
"webhook deletion must not destroy the archive file",
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestHandleTargetDelete_EvictsWhenLastDatabaseTargetGone
|
||||||
|
// proves that removing the last database target releases the
|
||||||
|
// archive writer.
|
||||||
|
func TestHandleTargetDelete_EvictsWhenLastDatabaseTargetGone(
|
||||||
|
t *testing.T,
|
||||||
|
) {
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
var (
|
||||||
|
h *handlers.Handlers
|
||||||
|
sess *session.Session
|
||||||
|
db *database.Database
|
||||||
|
ev *recordingEvictor
|
||||||
|
)
|
||||||
|
|
||||||
|
app := newTestApp(t, &h, &sess, &db, &ev)
|
||||||
|
app.RequireStart()
|
||||||
|
|
||||||
|
t.Cleanup(app.RequireStop)
|
||||||
|
|
||||||
|
wh := seedWebhook(t, db)
|
||||||
|
tgt := seedTarget(
|
||||||
|
t, db, wh.ID, database.TargetTypeDatabase,
|
||||||
|
)
|
||||||
|
|
||||||
|
cookies := authenticatedCookies(
|
||||||
|
t, sess, deleteTestUserID, deleteTestUsername,
|
||||||
|
)
|
||||||
|
|
||||||
|
req := postRequest(
|
||||||
|
"/source/"+wh.ID+"/targets/"+tgt.ID+"/delete",
|
||||||
|
cookies,
|
||||||
|
map[string]string{
|
||||||
|
paramSourceID: wh.ID,
|
||||||
|
paramTargetID: tgt.ID,
|
||||||
|
},
|
||||||
|
)
|
||||||
|
w := httptest.NewRecorder()
|
||||||
|
|
||||||
|
h.HandleTargetDelete().ServeHTTP(w, req)
|
||||||
|
|
||||||
|
require.Equal(t, http.StatusSeeOther, w.Code)
|
||||||
|
assert.Equal(
|
||||||
|
t, []string{wh.ID}, ev.Evicted(),
|
||||||
|
"removing the last database target should evict",
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// TestHandleTargetDelete_KeepsWriterWhileDatabaseTargetRemains
|
||||||
|
// proves that deleting an unrelated target, or one of several
|
||||||
|
// database targets, leaves a still-needed archive writer alone.
|
||||||
|
func TestHandleTargetDelete_KeepsWriterWhileDatabaseTargetRemains(
|
||||||
|
t *testing.T,
|
||||||
|
) {
|
||||||
|
t.Parallel()
|
||||||
|
|
||||||
|
var (
|
||||||
|
h *handlers.Handlers
|
||||||
|
sess *session.Session
|
||||||
|
db *database.Database
|
||||||
|
ev *recordingEvictor
|
||||||
|
)
|
||||||
|
|
||||||
|
app := newTestApp(t, &h, &sess, &db, &ev)
|
||||||
|
app.RequireStart()
|
||||||
|
|
||||||
|
t.Cleanup(app.RequireStop)
|
||||||
|
|
||||||
|
wh := seedWebhook(t, db)
|
||||||
|
seedTarget(t, db, wh.ID, database.TargetTypeDatabase)
|
||||||
|
other := seedTarget(t, db, wh.ID, database.TargetTypeLog)
|
||||||
|
|
||||||
|
cookies := authenticatedCookies(
|
||||||
|
t, sess, deleteTestUserID, deleteTestUsername,
|
||||||
|
)
|
||||||
|
|
||||||
|
req := postRequest(
|
||||||
|
"/source/"+wh.ID+"/targets/"+other.ID+"/delete",
|
||||||
|
cookies,
|
||||||
|
map[string]string{
|
||||||
|
paramSourceID: wh.ID,
|
||||||
|
paramTargetID: other.ID,
|
||||||
|
},
|
||||||
|
)
|
||||||
|
w := httptest.NewRecorder()
|
||||||
|
|
||||||
|
h.HandleTargetDelete().ServeHTTP(w, req)
|
||||||
|
|
||||||
|
require.Equal(t, http.StatusSeeOther, w.Code)
|
||||||
|
assert.Empty(
|
||||||
|
t, ev.Evicted(),
|
||||||
|
"a surviving database target must keep its writer",
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -127,8 +127,10 @@ func (h *Handlers) HandleSourceCreateSubmit() http.HandlerFunc {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
// The body size cap is enforced by the MaxBodySize
|
r.Body = http.MaxBytesReader(
|
||||||
// middleware, which runs before CSRF parses the form.
|
w, r.Body, 1<<maxBodyShift,
|
||||||
|
)
|
||||||
|
|
||||||
err := r.ParseForm()
|
err := r.ParseForm()
|
||||||
if err != nil {
|
if err != nil {
|
||||||
http.Error(
|
http.Error(
|
||||||
@@ -384,8 +386,10 @@ func (h *Handlers) HandleSourceEditSubmit() http.HandlerFunc {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
// The body size cap is enforced by the MaxBodySize
|
r.Body = http.MaxBytesReader(
|
||||||
// middleware, which runs before CSRF parses the form.
|
w, r.Body, 1<<maxBodyShift,
|
||||||
|
)
|
||||||
|
|
||||||
err = r.ParseForm()
|
err = r.ParseForm()
|
||||||
if err != nil {
|
if err != nil {
|
||||||
http.Error(
|
http.Error(
|
||||||
@@ -405,8 +409,10 @@ func (h *Handlers) applyWebhookEdit(
|
|||||||
r *http.Request,
|
r *http.Request,
|
||||||
webhook *database.Webhook,
|
webhook *database.Webhook,
|
||||||
) {
|
) {
|
||||||
// The body size cap is enforced by the MaxBodySize middleware,
|
r.Body = http.MaxBytesReader(
|
||||||
// which runs before CSRF parses the form.
|
w, r.Body, 1<<maxBodyShift,
|
||||||
|
)
|
||||||
|
|
||||||
name := r.FormValue("name")
|
name := r.FormValue("name")
|
||||||
if name == "" {
|
if name == "" {
|
||||||
data := map[string]any{
|
data := map[string]any{
|
||||||
@@ -527,6 +533,13 @@ func (h *Handlers) deleteWebhookResources(
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Release the delivery engine's per-webhook archiving state
|
||||||
|
// so a deleted webhook's archive writer (and any handle open
|
||||||
|
// within its debounce window) does not linger for the
|
||||||
|
// process lifetime. The archive file itself is deliberately
|
||||||
|
// left on disk; see evictArchiveWriter.
|
||||||
|
h.evictArchiveWriter(webhook.ID)
|
||||||
|
|
||||||
err = h.dbMgr.DeleteDB(webhook.ID)
|
err = h.dbMgr.DeleteDB(webhook.ID)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
h.log.Error(
|
h.log.Error(
|
||||||
@@ -545,6 +558,64 @@ func (h *Handlers) deleteWebhookResources(
|
|||||||
http.Redirect(w, r, "/sources", http.StatusSeeOther)
|
http.Redirect(w, r, "/sources", http.StatusSeeOther)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// evictArchiveWriter asks the delivery engine to drop its
|
||||||
|
// cached archive writer for a webhook, closing the archive file
|
||||||
|
// handle.
|
||||||
|
//
|
||||||
|
// The archive database file is NOT deleted. Unlike the event
|
||||||
|
// database — which is per-webhook working storage and is
|
||||||
|
// hard-deleted with the webhook — an archive is explicitly
|
||||||
|
// long-term storage that an operator may want to keep or move
|
||||||
|
// away for offline retention. Destroying it as a side effect of
|
||||||
|
// deleting a webhook would be a surprising and unrecoverable
|
||||||
|
// data loss, so the file is left for the operator to handle.
|
||||||
|
func (h *Handlers) evictArchiveWriter(webhookID string) {
|
||||||
|
if h.evictor == nil {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
h.evictor.EvictWebhook(webhookID)
|
||||||
|
}
|
||||||
|
|
||||||
|
// evictArchiveWriterIfUnused releases a webhook's archive
|
||||||
|
// writer once the webhook has no database target left to feed
|
||||||
|
// it.
|
||||||
|
//
|
||||||
|
// It is called after any child resource of a webhook is
|
||||||
|
// deleted, and is correct without knowing which kind was: it
|
||||||
|
// evicts only when no database target remains, so deleting one
|
||||||
|
// of several database targets — or deleting an unrelated
|
||||||
|
// target type — leaves a still-needed writer alone. When no
|
||||||
|
// database target ever existed there is no writer and eviction
|
||||||
|
// is a no-op. Soft-deleted targets are excluded by GORM's
|
||||||
|
// default scope, so the row just deleted is not counted.
|
||||||
|
func (h *Handlers) evictArchiveWriterIfUnused(webhookID string) {
|
||||||
|
var remaining int64
|
||||||
|
|
||||||
|
err := h.db.DB().
|
||||||
|
Model(&database.Target{}).
|
||||||
|
Where(
|
||||||
|
"webhook_id = ? AND type = ?",
|
||||||
|
webhookID, database.TargetTypeDatabase,
|
||||||
|
).
|
||||||
|
Count(&remaining).Error
|
||||||
|
if err != nil {
|
||||||
|
h.log.Error(
|
||||||
|
"failed to count remaining database targets",
|
||||||
|
"webhook_id", webhookID,
|
||||||
|
"error", err,
|
||||||
|
)
|
||||||
|
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
if remaining > 0 {
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
h.evictArchiveWriter(webhookID)
|
||||||
|
}
|
||||||
|
|
||||||
// HandleSourceLogs shows the request/response logs for a
|
// HandleSourceLogs shows the request/response logs for a
|
||||||
// webhook.
|
// webhook.
|
||||||
func (h *Handlers) HandleSourceLogs() http.HandlerFunc {
|
func (h *Handlers) HandleSourceLogs() http.HandlerFunc {
|
||||||
@@ -719,8 +790,10 @@ func (h *Handlers) HandleEntrypointCreate() http.HandlerFunc {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
// The body size cap is enforced by the MaxBodySize
|
r.Body = http.MaxBytesReader(
|
||||||
// middleware, which runs before CSRF parses the form.
|
w, r.Body, 1<<maxBodyShift,
|
||||||
|
)
|
||||||
|
|
||||||
err = r.ParseForm()
|
err = r.ParseForm()
|
||||||
if err != nil {
|
if err != nil {
|
||||||
http.Error(
|
http.Error(
|
||||||
@@ -777,8 +850,10 @@ func (h *Handlers) HandleTargetCreate() http.HandlerFunc {
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
// The body size cap is enforced by the MaxBodySize
|
r.Body = http.MaxBytesReader(
|
||||||
// middleware, which runs before CSRF parses the form.
|
w, r.Body, 1<<maxBodyShift,
|
||||||
|
)
|
||||||
|
|
||||||
err = r.ParseForm()
|
err = r.ParseForm()
|
||||||
if err != nil {
|
if err != nil {
|
||||||
http.Error(
|
http.Error(
|
||||||
@@ -798,8 +873,10 @@ func (h *Handlers) processTargetCreate(
|
|||||||
r *http.Request,
|
r *http.Request,
|
||||||
webhook database.Webhook,
|
webhook database.Webhook,
|
||||||
) {
|
) {
|
||||||
// The body size cap is enforced by the MaxBodySize middleware,
|
r.Body = http.MaxBytesReader(
|
||||||
// which runs before CSRF parses the form.
|
w, r.Body, 1<<maxBodyShift,
|
||||||
|
)
|
||||||
|
|
||||||
name := r.FormValue("name")
|
name := r.FormValue("name")
|
||||||
targetType := database.TargetType(r.FormValue("type"))
|
targetType := database.TargetType(r.FormValue("type"))
|
||||||
targetURL := r.FormValue("url")
|
targetURL := r.FormValue("url")
|
||||||
@@ -1012,23 +1089,31 @@ func (h *Handlers) HandleEntrypointDelete() http.HandlerFunc {
|
|||||||
return h.deleteChildResource(
|
return h.deleteChildResource(
|
||||||
"entrypointID", &database.Entrypoint{},
|
"entrypointID", &database.Entrypoint{},
|
||||||
"failed to delete entrypoint",
|
"failed to delete entrypoint",
|
||||||
|
nil,
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
// HandleTargetDelete handles deleting a target.
|
// HandleTargetDelete handles deleting a target. Deleting the
|
||||||
|
// last database target of a webhook leaves its archive writer
|
||||||
|
// with nothing to write, so the writer is evicted and its
|
||||||
|
// handle closed; the archive file is left on disk.
|
||||||
func (h *Handlers) HandleTargetDelete() http.HandlerFunc {
|
func (h *Handlers) HandleTargetDelete() http.HandlerFunc {
|
||||||
return h.deleteChildResource(
|
return h.deleteChildResource(
|
||||||
"targetID", &database.Target{},
|
"targetID", &database.Target{},
|
||||||
"failed to delete target",
|
"failed to delete target",
|
||||||
|
h.evictArchiveWriterIfUnused,
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
// deleteChildResource returns a handler that deletes a child
|
// deleteChildResource returns a handler that deletes a child
|
||||||
// resource (entrypoint or target) belonging to a webhook.
|
// resource (entrypoint or target) belonging to a webhook. The
|
||||||
|
// optional afterDelete hook runs with the webhook's id once the
|
||||||
|
// delete has succeeded, before the redirect.
|
||||||
func (h *Handlers) deleteChildResource(
|
func (h *Handlers) deleteChildResource(
|
||||||
idParam string,
|
idParam string,
|
||||||
model any,
|
model any,
|
||||||
errMsg string,
|
errMsg string,
|
||||||
|
afterDelete func(webhookID string),
|
||||||
) http.HandlerFunc {
|
) http.HandlerFunc {
|
||||||
return func(w http.ResponseWriter, r *http.Request) {
|
return func(w http.ResponseWriter, r *http.Request) {
|
||||||
userID, ok := h.getUserID(r)
|
userID, ok := h.getUserID(r)
|
||||||
@@ -1068,6 +1153,10 @@ func (h *Handlers) deleteChildResource(
|
|||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if afterDelete != nil {
|
||||||
|
afterDelete(webhook.ID)
|
||||||
|
}
|
||||||
|
|
||||||
http.Redirect(
|
http.Redirect(
|
||||||
w, r,
|
w, r,
|
||||||
"/source/"+webhook.ID,
|
"/source/"+webhook.ID,
|
||||||
|
|||||||
@@ -285,36 +285,10 @@ func (s *Middleware) NoCache() func(http.Handler) http.Handler {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// bodyLimitedMethod reports whether the request method carries a
|
// MaxBodySize returns middleware that limits the request body size
|
||||||
// body that the MaxBodySize middleware should cap.
|
// for POST requests. If the body exceeds the given limit in
|
||||||
func bodyLimitedMethod(method string) bool {
|
// bytes, the server returns 413 Request Entity Too Large. This
|
||||||
return method == http.MethodPost ||
|
// prevents clients from sending arbitrarily large form bodies.
|
||||||
method == http.MethodPut ||
|
|
||||||
method == http.MethodPatch
|
|
||||||
}
|
|
||||||
|
|
||||||
// MaxBodySize returns middleware that limits the size of
|
|
||||||
// POST/PUT/PATCH request bodies to maxBytes. It must be registered
|
|
||||||
// before any middleware that parses the body — notably CSRF, which
|
|
||||||
// calls r.PostFormValue — so that form parsing happens under this
|
|
||||||
// cap rather than net/http's 10 MB default.
|
|
||||||
//
|
|
||||||
// Two enforcement paths exist, because http.MaxBytesReader alone
|
|
||||||
// cannot produce a 413: it reports the overflow as an error from
|
|
||||||
// Read, by which point the body parser downstream has already
|
|
||||||
// converted that error into its own response.
|
|
||||||
//
|
|
||||||
// - Declared oversize: the request announces a Content-Length
|
|
||||||
// greater than maxBytes. The middleware answers 413 Request
|
|
||||||
// Entity Too Large immediately and does not call the next
|
|
||||||
// handler, so neither CSRF nor the endpoint handler runs.
|
|
||||||
// - Undeclared oversize: the request is chunked (Content-Length
|
|
||||||
// of -1) or lies about its Content-Length. There is nothing to
|
|
||||||
// check up front, so http.MaxBytesReader hard-caps the body at
|
|
||||||
// maxBytes and the request fails downstream — the form parse
|
|
||||||
// errors out and CSRF rejects it with 403. The response is less
|
|
||||||
// precise than a 413, but the body is still never buffered
|
|
||||||
// beyond the cap, which is the property that matters.
|
|
||||||
func (s *Middleware) MaxBodySize(
|
func (s *Middleware) MaxBodySize(
|
||||||
maxBytes int64,
|
maxBytes int64,
|
||||||
) func(http.Handler) http.Handler {
|
) func(http.Handler) http.Handler {
|
||||||
@@ -323,31 +297,14 @@ func (s *Middleware) MaxBodySize(
|
|||||||
w http.ResponseWriter,
|
w http.ResponseWriter,
|
||||||
r *http.Request,
|
r *http.Request,
|
||||||
) {
|
) {
|
||||||
if !bodyLimitedMethod(r.Method) {
|
if r.Method == http.MethodPost ||
|
||||||
next.ServeHTTP(w, r)
|
r.Method == http.MethodPut ||
|
||||||
|
r.Method == http.MethodPatch {
|
||||||
return
|
r.Body = http.MaxBytesReader(
|
||||||
}
|
w, r.Body, maxBytes,
|
||||||
|
|
||||||
if r.ContentLength > maxBytes {
|
|
||||||
s.log.Warn(
|
|
||||||
"request body exceeds limit",
|
|
||||||
"method", r.Method,
|
|
||||||
"path", r.URL.Path,
|
|
||||||
"content_length", r.ContentLength,
|
|
||||||
"limit", maxBytes,
|
|
||||||
)
|
)
|
||||||
http.Error(
|
|
||||||
w,
|
|
||||||
"Request Entity Too Large",
|
|
||||||
http.StatusRequestEntityTooLarge,
|
|
||||||
)
|
|
||||||
|
|
||||||
return
|
|
||||||
}
|
}
|
||||||
|
|
||||||
r.Body = http.MaxBytesReader(w, r.Body, maxBytes)
|
|
||||||
|
|
||||||
next.ServeHTTP(w, r)
|
next.ServeHTTP(w, r)
|
||||||
})
|
})
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -3,12 +3,10 @@ package middleware_test
|
|||||||
import (
|
import (
|
||||||
"context"
|
"context"
|
||||||
"encoding/base64"
|
"encoding/base64"
|
||||||
"io"
|
|
||||||
"log/slog"
|
"log/slog"
|
||||||
"net/http"
|
"net/http"
|
||||||
"net/http/httptest"
|
"net/http/httptest"
|
||||||
"os"
|
"os"
|
||||||
"strings"
|
|
||||||
"testing"
|
"testing"
|
||||||
|
|
||||||
"github.com/gorilla/sessions"
|
"github.com/gorilla/sessions"
|
||||||
@@ -428,153 +426,6 @@ func TestNoCache_SetsHeaders(t *testing.T) {
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
// --- MaxBodySize Middleware Tests ---
|
|
||||||
|
|
||||||
const testBodyLimit int64 = 64
|
|
||||||
|
|
||||||
// maxBodySizeHandler wraps a sentinel handler in MaxBodySize with
|
|
||||||
// testBodyLimit. The sentinel records whether it ran and how much of
|
|
||||||
// the body it managed to read, so tests can distinguish "never
|
|
||||||
// reached" from "reached but truncated".
|
|
||||||
type maxBodySizeResult struct {
|
|
||||||
called bool
|
|
||||||
read int
|
|
||||||
readErr error
|
|
||||||
response *httptest.ResponseRecorder
|
|
||||||
}
|
|
||||||
|
|
||||||
func runMaxBodySize(
|
|
||||||
t *testing.T,
|
|
||||||
req *http.Request,
|
|
||||||
) *maxBodySizeResult {
|
|
||||||
t.Helper()
|
|
||||||
|
|
||||||
m, _ := testMiddleware(t, config.EnvironmentDev)
|
|
||||||
res := &maxBodySizeResult{response: httptest.NewRecorder()}
|
|
||||||
|
|
||||||
handler := m.MaxBodySize(testBodyLimit)(http.HandlerFunc(
|
|
||||||
func(w http.ResponseWriter, r *http.Request) {
|
|
||||||
res.called = true
|
|
||||||
|
|
||||||
body, err := io.ReadAll(r.Body)
|
|
||||||
res.read = len(body)
|
|
||||||
res.readErr = err
|
|
||||||
|
|
||||||
w.WriteHeader(http.StatusOK)
|
|
||||||
},
|
|
||||||
))
|
|
||||||
|
|
||||||
handler.ServeHTTP(res.response, req)
|
|
||||||
|
|
||||||
return res
|
|
||||||
}
|
|
||||||
|
|
||||||
// postWithBody builds a POST request whose Content-Length is
|
|
||||||
// accurate for the given payload size.
|
|
||||||
func postWithBody(size int) *http.Request {
|
|
||||||
req := httptest.NewRequestWithContext(
|
|
||||||
context.Background(),
|
|
||||||
http.MethodPost, "/pages/login",
|
|
||||||
strings.NewReader(strings.Repeat("a", size)),
|
|
||||||
)
|
|
||||||
req.Header.Set(
|
|
||||||
"Content-Type", "application/x-www-form-urlencoded",
|
|
||||||
)
|
|
||||||
|
|
||||||
return req
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestMaxBodySize_DeclaredOversize_413AndHandlerNotReached(
|
|
||||||
t *testing.T,
|
|
||||||
) {
|
|
||||||
t.Parallel()
|
|
||||||
|
|
||||||
res := runMaxBodySize(t, postWithBody(int(testBodyLimit)+1))
|
|
||||||
|
|
||||||
assert.False(
|
|
||||||
t, res.called,
|
|
||||||
"handler must not be reached for an oversized body",
|
|
||||||
)
|
|
||||||
assert.Equal(
|
|
||||||
t, http.StatusRequestEntityTooLarge, res.response.Code,
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestMaxBodySize_AtLimit_PassesThrough(t *testing.T) {
|
|
||||||
t.Parallel()
|
|
||||||
|
|
||||||
res := runMaxBodySize(t, postWithBody(int(testBodyLimit)))
|
|
||||||
|
|
||||||
assert.True(
|
|
||||||
t, res.called,
|
|
||||||
"handler should be reached for a body at the limit",
|
|
||||||
)
|
|
||||||
require.NoError(t, res.readErr)
|
|
||||||
assert.Equal(t, int(testBodyLimit), res.read)
|
|
||||||
assert.Equal(t, http.StatusOK, res.response.Code)
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestMaxBodySize_UnderLimit_PassesThrough(t *testing.T) {
|
|
||||||
t.Parallel()
|
|
||||||
|
|
||||||
res := runMaxBodySize(t, postWithBody(1))
|
|
||||||
|
|
||||||
assert.True(t, res.called)
|
|
||||||
require.NoError(t, res.readErr)
|
|
||||||
assert.Equal(t, 1, res.read)
|
|
||||||
assert.Equal(t, http.StatusOK, res.response.Code)
|
|
||||||
}
|
|
||||||
|
|
||||||
func TestMaxBodySize_GetWithOversizeBody_NotCapped(t *testing.T) {
|
|
||||||
t.Parallel()
|
|
||||||
|
|
||||||
req := httptest.NewRequestWithContext(
|
|
||||||
context.Background(),
|
|
||||||
http.MethodGet, "/pages/login",
|
|
||||||
strings.NewReader(
|
|
||||||
strings.Repeat("a", int(testBodyLimit)+1),
|
|
||||||
),
|
|
||||||
)
|
|
||||||
|
|
||||||
res := runMaxBodySize(t, req)
|
|
||||||
|
|
||||||
assert.True(
|
|
||||||
t, res.called,
|
|
||||||
"GET requests are not subject to the POST body cap",
|
|
||||||
)
|
|
||||||
require.NoError(t, res.readErr)
|
|
||||||
assert.Equal(t, int(testBodyLimit)+1, res.read)
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestMaxBodySize_UndeclaredOversize_TruncatedAtCap covers the
|
|
||||||
// chunked / lying-Content-Length case: there is nothing to check up
|
|
||||||
// front, so the request reaches the handler but MaxBytesReader
|
|
||||||
// hard-caps the body and the read fails at the limit.
|
|
||||||
func TestMaxBodySize_UndeclaredOversize_TruncatedAtCap(
|
|
||||||
t *testing.T,
|
|
||||||
) {
|
|
||||||
t.Parallel()
|
|
||||||
|
|
||||||
req := postWithBody(int(testBodyLimit) + 1)
|
|
||||||
// Simulate a chunked request: no declared length.
|
|
||||||
req.ContentLength = -1
|
|
||||||
|
|
||||||
res := runMaxBodySize(t, req)
|
|
||||||
|
|
||||||
assert.True(
|
|
||||||
t, res.called,
|
|
||||||
"an undeclared oversize body cannot be rejected up front",
|
|
||||||
)
|
|
||||||
require.Error(
|
|
||||||
t, res.readErr,
|
|
||||||
"reading past the cap must fail",
|
|
||||||
)
|
|
||||||
assert.Equal(
|
|
||||||
t, int(testBodyLimit), res.read,
|
|
||||||
"the handler must not see more than the cap",
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
// --- Helper Tests ---
|
// --- Helper Tests ---
|
||||||
|
|
||||||
func TestIpFromHostPort(t *testing.T) {
|
func TestIpFromHostPort(t *testing.T) {
|
||||||
|
|||||||
@@ -1,36 +0,0 @@
|
|||||||
package server
|
|
||||||
|
|
||||||
import (
|
|
||||||
"log/slog"
|
|
||||||
"net/http"
|
|
||||||
|
|
||||||
"sneak.berlin/go/webhooker/internal/config"
|
|
||||||
"sneak.berlin/go/webhooker/internal/handlers"
|
|
||||||
"sneak.berlin/go/webhooker/internal/middleware"
|
|
||||||
)
|
|
||||||
|
|
||||||
// MaxFormBodySizeForTest exposes the form body cap so tests can
|
|
||||||
// build requests that sit exactly at, below, and above it.
|
|
||||||
const MaxFormBodySizeForTest = maxFormBodySize
|
|
||||||
|
|
||||||
// NewRouterForTest builds the real route tree via SetupRoutes with
|
|
||||||
// the supplied middleware and handlers, bypassing the fx lifecycle
|
|
||||||
// and the HTTP listener. Tests use it so that route-group middleware
|
|
||||||
// registration order is exercised exactly as it ships, rather than
|
|
||||||
// against a hand-rebuilt chain that could drift from routes.go.
|
|
||||||
func NewRouterForTest(
|
|
||||||
log *slog.Logger,
|
|
||||||
cfg *config.Config,
|
|
||||||
mw *middleware.Middleware,
|
|
||||||
h *handlers.Handlers,
|
|
||||||
) http.Handler {
|
|
||||||
s := &Server{
|
|
||||||
log: log,
|
|
||||||
mw: mw,
|
|
||||||
h: h,
|
|
||||||
params: ServerParams{Config: cfg},
|
|
||||||
}
|
|
||||||
s.SetupRoutes()
|
|
||||||
|
|
||||||
return s.router
|
|
||||||
}
|
|
||||||
@@ -90,11 +90,9 @@ func (s *Server) setupRoutes() {
|
|||||||
|
|
||||||
func (s *Server) setupPageRoutes() {
|
func (s *Server) setupPageRoutes() {
|
||||||
s.router.Route("/pages", func(r chi.Router) {
|
s.router.Route("/pages", func(r chi.Router) {
|
||||||
// MaxBodySize must precede CSRF: gorilla/csrf parses the
|
|
||||||
// form, so the cap has to be installed before it runs.
|
|
||||||
r.Use(s.mw.MaxBodySize(maxFormBodySize))
|
|
||||||
r.Use(s.mw.CSRF())
|
r.Use(s.mw.CSRF())
|
||||||
r.Use(s.mw.NoCache())
|
r.Use(s.mw.NoCache())
|
||||||
|
r.Use(s.mw.MaxBodySize(maxFormBodySize))
|
||||||
|
|
||||||
r.Group(func(r chi.Router) {
|
r.Group(func(r chi.Router) {
|
||||||
r.Use(s.mw.LoginRateLimit())
|
r.Use(s.mw.LoginRateLimit())
|
||||||
@@ -108,9 +106,6 @@ func (s *Server) setupPageRoutes() {
|
|||||||
|
|
||||||
func (s *Server) setupUserRoutes() {
|
func (s *Server) setupUserRoutes() {
|
||||||
s.router.Route("/user/{username}", func(r chi.Router) {
|
s.router.Route("/user/{username}", func(r chi.Router) {
|
||||||
// MaxBodySize must precede CSRF: gorilla/csrf parses the
|
|
||||||
// form, so the cap has to be installed before it runs.
|
|
||||||
r.Use(s.mw.MaxBodySize(maxFormBodySize))
|
|
||||||
r.Use(s.mw.CSRF())
|
r.Use(s.mw.CSRF())
|
||||||
r.Use(s.mw.NoCache())
|
r.Use(s.mw.NoCache())
|
||||||
r.Use(s.mw.RequireAuth())
|
r.Use(s.mw.RequireAuth())
|
||||||
@@ -123,24 +118,20 @@ func (s *Server) setupUserRoutes() {
|
|||||||
|
|
||||||
func (s *Server) setupSourceRoutes() {
|
func (s *Server) setupSourceRoutes() {
|
||||||
s.router.Route("/sources", func(r chi.Router) {
|
s.router.Route("/sources", func(r chi.Router) {
|
||||||
// MaxBodySize must precede CSRF: gorilla/csrf parses the
|
|
||||||
// form, so the cap has to be installed before it runs.
|
|
||||||
r.Use(s.mw.MaxBodySize(maxFormBodySize))
|
|
||||||
r.Use(s.mw.CSRF())
|
r.Use(s.mw.CSRF())
|
||||||
r.Use(s.mw.NoCache())
|
r.Use(s.mw.NoCache())
|
||||||
r.Use(s.mw.RequireAuth())
|
r.Use(s.mw.RequireAuth())
|
||||||
|
r.Use(s.mw.MaxBodySize(maxFormBodySize))
|
||||||
r.Get("/", s.h.HandleSourceList())
|
r.Get("/", s.h.HandleSourceList())
|
||||||
r.Get("/new", s.h.HandleSourceCreate())
|
r.Get("/new", s.h.HandleSourceCreate())
|
||||||
r.Post("/new", s.h.HandleSourceCreateSubmit())
|
r.Post("/new", s.h.HandleSourceCreateSubmit())
|
||||||
})
|
})
|
||||||
|
|
||||||
s.router.Route("/source/{sourceID}", func(r chi.Router) {
|
s.router.Route("/source/{sourceID}", func(r chi.Router) {
|
||||||
// MaxBodySize must precede CSRF: gorilla/csrf parses the
|
|
||||||
// form, so the cap has to be installed before it runs.
|
|
||||||
r.Use(s.mw.MaxBodySize(maxFormBodySize))
|
|
||||||
r.Use(s.mw.CSRF())
|
r.Use(s.mw.CSRF())
|
||||||
r.Use(s.mw.NoCache())
|
r.Use(s.mw.NoCache())
|
||||||
r.Use(s.mw.RequireAuth())
|
r.Use(s.mw.RequireAuth())
|
||||||
|
r.Use(s.mw.MaxBodySize(maxFormBodySize))
|
||||||
r.Get("/", s.h.HandleSourceDetail())
|
r.Get("/", s.h.HandleSourceDetail())
|
||||||
r.Get("/edit", s.h.HandleSourceEdit())
|
r.Get("/edit", s.h.HandleSourceEdit())
|
||||||
r.Post("/edit", s.h.HandleSourceEditSubmit())
|
r.Post("/edit", s.h.HandleSourceEditSubmit())
|
||||||
|
|||||||
@@ -1,375 +0,0 @@
|
|||||||
package server_test
|
|
||||||
|
|
||||||
import (
|
|
||||||
"context"
|
|
||||||
"html"
|
|
||||||
"net/http"
|
|
||||||
"net/http/httptest"
|
|
||||||
"net/url"
|
|
||||||
"regexp"
|
|
||||||
"strings"
|
|
||||||
"testing"
|
|
||||||
|
|
||||||
"github.com/stretchr/testify/assert"
|
|
||||||
"github.com/stretchr/testify/require"
|
|
||||||
"go.uber.org/fx"
|
|
||||||
"go.uber.org/fx/fxtest"
|
|
||||||
"sneak.berlin/go/webhooker/internal/config"
|
|
||||||
"sneak.berlin/go/webhooker/internal/database"
|
|
||||||
"sneak.berlin/go/webhooker/internal/delivery"
|
|
||||||
"sneak.berlin/go/webhooker/internal/globals"
|
|
||||||
"sneak.berlin/go/webhooker/internal/handlers"
|
|
||||||
"sneak.berlin/go/webhooker/internal/healthcheck"
|
|
||||||
"sneak.berlin/go/webhooker/internal/logger"
|
|
||||||
"sneak.berlin/go/webhooker/internal/middleware"
|
|
||||||
"sneak.berlin/go/webhooker/internal/server"
|
|
||||||
"sneak.berlin/go/webhooker/internal/session"
|
|
||||||
)
|
|
||||||
|
|
||||||
// csrfCookieName is the cookie gorilla/csrf issues when it runs. Its
|
|
||||||
// presence or absence on a response is how these tests tell whether
|
|
||||||
// the CSRF middleware executed.
|
|
||||||
const csrfCookieName = "_gorilla_csrf"
|
|
||||||
|
|
||||||
type noopNotifier struct{}
|
|
||||||
|
|
||||||
func (n *noopNotifier) Notify([]delivery.Task) {}
|
|
||||||
|
|
||||||
// testEnv is the real router from routes.go plus the collaborators
|
|
||||||
// tests need to seed users and forge sessions.
|
|
||||||
type testEnv struct {
|
|
||||||
router http.Handler
|
|
||||||
sess *session.Session
|
|
||||||
db *database.Database
|
|
||||||
}
|
|
||||||
|
|
||||||
// newTestEnv wires the dependency graph with fx and builds the
|
|
||||||
// production route tree, so middleware registration order is
|
|
||||||
// exercised exactly as it ships.
|
|
||||||
func newTestEnv(t *testing.T) *testEnv {
|
|
||||||
t.Helper()
|
|
||||||
|
|
||||||
var (
|
|
||||||
log *logger.Logger
|
|
||||||
cfg *config.Config
|
|
||||||
mw *middleware.Middleware
|
|
||||||
hnd *handlers.Handlers
|
|
||||||
sess *session.Session
|
|
||||||
db *database.Database
|
|
||||||
)
|
|
||||||
|
|
||||||
app := fxtest.New(
|
|
||||||
t,
|
|
||||||
fx.Provide(
|
|
||||||
globals.New,
|
|
||||||
logger.New,
|
|
||||||
func() *config.Config {
|
|
||||||
return &config.Config{
|
|
||||||
DataDir: t.TempDir(),
|
|
||||||
Environment: config.EnvironmentDev,
|
|
||||||
}
|
|
||||||
},
|
|
||||||
database.New,
|
|
||||||
database.NewWebhookDBManager,
|
|
||||||
healthcheck.New,
|
|
||||||
session.New,
|
|
||||||
func() delivery.Notifier { return &noopNotifier{} },
|
|
||||||
middleware.New,
|
|
||||||
handlers.New,
|
|
||||||
),
|
|
||||||
fx.Populate(&log, &cfg, &mw, &hnd, &sess, &db),
|
|
||||||
)
|
|
||||||
app.RequireStart()
|
|
||||||
t.Cleanup(app.RequireStop)
|
|
||||||
|
|
||||||
return &testEnv{
|
|
||||||
router: server.NewRouterForTest(log.Get(), cfg, mw, hnd),
|
|
||||||
sess: sess,
|
|
||||||
db: db,
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// oversizeValue returns a form value one byte past the route-group
|
|
||||||
// body cap, so an encoded form containing it is guaranteed oversize.
|
|
||||||
func oversizeValue() string {
|
|
||||||
return strings.Repeat("a", int(server.MaxFormBodySizeForTest)+1)
|
|
||||||
}
|
|
||||||
|
|
||||||
// csrfCookieSet reports whether the response issued a gorilla/csrf
|
|
||||||
// cookie, which only happens if the CSRF middleware ran.
|
|
||||||
func csrfCookieSet(w *httptest.ResponseRecorder) bool {
|
|
||||||
for _, c := range w.Result().Cookies() {
|
|
||||||
if c.Name == csrfCookieName {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
// get issues a GET through the router with the supplied cookies.
|
|
||||||
func (e *testEnv) get(
|
|
||||||
path string,
|
|
||||||
cookies []*http.Cookie,
|
|
||||||
) *httptest.ResponseRecorder {
|
|
||||||
req := httptest.NewRequestWithContext(
|
|
||||||
context.Background(), http.MethodGet, path, nil,
|
|
||||||
)
|
|
||||||
|
|
||||||
for _, c := range cookies {
|
|
||||||
req.AddCookie(c)
|
|
||||||
}
|
|
||||||
|
|
||||||
w := httptest.NewRecorder()
|
|
||||||
e.router.ServeHTTP(w, req)
|
|
||||||
|
|
||||||
return w
|
|
||||||
}
|
|
||||||
|
|
||||||
// post issues a urlencoded form POST through the router. The body is
|
|
||||||
// a strings.Reader, so the request carries an accurate
|
|
||||||
// Content-Length — the signal MaxBodySize checks up front.
|
|
||||||
func (e *testEnv) post(
|
|
||||||
path string,
|
|
||||||
form url.Values,
|
|
||||||
cookies []*http.Cookie,
|
|
||||||
) *httptest.ResponseRecorder {
|
|
||||||
req := httptest.NewRequestWithContext(
|
|
||||||
context.Background(), http.MethodPost, path,
|
|
||||||
strings.NewReader(form.Encode()),
|
|
||||||
)
|
|
||||||
req.Header.Set(
|
|
||||||
"Content-Type", "application/x-www-form-urlencoded",
|
|
||||||
)
|
|
||||||
|
|
||||||
for _, c := range cookies {
|
|
||||||
req.AddCookie(c)
|
|
||||||
}
|
|
||||||
|
|
||||||
w := httptest.NewRecorder()
|
|
||||||
e.router.ServeHTTP(w, req)
|
|
||||||
|
|
||||||
return w
|
|
||||||
}
|
|
||||||
|
|
||||||
// csrfFrom renders the page at path and returns the CSRF token from
|
|
||||||
// its form together with every cookie needed for the follow-up POST.
|
|
||||||
func (e *testEnv) csrfFrom(
|
|
||||||
t *testing.T,
|
|
||||||
path string,
|
|
||||||
cookies []*http.Cookie,
|
|
||||||
) (string, []*http.Cookie) {
|
|
||||||
t.Helper()
|
|
||||||
|
|
||||||
w := e.get(path, cookies)
|
|
||||||
require.Equal(t, http.StatusOK, w.Code)
|
|
||||||
|
|
||||||
pattern := regexp.MustCompile(
|
|
||||||
`name="csrf_token" value="([^"]+)"`,
|
|
||||||
)
|
|
||||||
|
|
||||||
match := pattern.FindStringSubmatch(w.Body.String())
|
|
||||||
require.Len(t, match, 2, "form must embed a CSRF token")
|
|
||||||
|
|
||||||
// html/template escapes "+" and "=" in attribute values, and
|
|
||||||
// gorilla/csrf tokens are standard base64, so the value read
|
|
||||||
// out of the markup has to be unescaped before it is submitted.
|
|
||||||
token := html.UnescapeString(match[1])
|
|
||||||
|
|
||||||
combined := make([]*http.Cookie, 0, len(cookies))
|
|
||||||
combined = append(combined, cookies...)
|
|
||||||
combined = append(combined, w.Result().Cookies()...)
|
|
||||||
|
|
||||||
return token, combined
|
|
||||||
}
|
|
||||||
|
|
||||||
// authCookies forges an authenticated session for the given user.
|
|
||||||
func (e *testEnv) authCookies(
|
|
||||||
t *testing.T,
|
|
||||||
userID, username string,
|
|
||||||
) []*http.Cookie {
|
|
||||||
t.Helper()
|
|
||||||
|
|
||||||
req := httptest.NewRequestWithContext(
|
|
||||||
context.Background(), http.MethodGet, "/setup", nil,
|
|
||||||
)
|
|
||||||
w := httptest.NewRecorder()
|
|
||||||
|
|
||||||
s, err := e.sess.Get(req)
|
|
||||||
require.NoError(t, err)
|
|
||||||
|
|
||||||
e.sess.SetUser(s, userID, username)
|
|
||||||
require.NoError(t, e.sess.Save(req, w, s))
|
|
||||||
|
|
||||||
cookies := w.Result().Cookies()
|
|
||||||
require.NotEmpty(t, cookies, "session cookie should be set")
|
|
||||||
|
|
||||||
return cookies
|
|
||||||
}
|
|
||||||
|
|
||||||
// seedUser creates a user with the given password and returns the
|
|
||||||
// stored hash so tests can assert whether it later changed.
|
|
||||||
func (e *testEnv) seedUser(
|
|
||||||
t *testing.T,
|
|
||||||
username, password string,
|
|
||||||
) (string, string) {
|
|
||||||
t.Helper()
|
|
||||||
|
|
||||||
hash, err := database.HashPassword(password)
|
|
||||||
require.NoError(t, err)
|
|
||||||
|
|
||||||
user := &database.User{Username: username, Password: hash}
|
|
||||||
require.NoError(t, e.db.DB().Create(user).Error)
|
|
||||||
|
|
||||||
return user.ID, hash
|
|
||||||
}
|
|
||||||
|
|
||||||
// storedHash reads the current password hash for a username.
|
|
||||||
func (e *testEnv) storedHash(t *testing.T, username string) string {
|
|
||||||
t.Helper()
|
|
||||||
|
|
||||||
var user database.User
|
|
||||||
|
|
||||||
require.NoError(t,
|
|
||||||
e.db.DB().Where("username = ?", username).
|
|
||||||
First(&user).Error,
|
|
||||||
)
|
|
||||||
|
|
||||||
return user.Password
|
|
||||||
}
|
|
||||||
|
|
||||||
// --- /pages group ---
|
|
||||||
|
|
||||||
// TestPagesLogin_OversizeBody_RejectedBeforeCSRF proves the cap runs
|
|
||||||
// ahead of gorilla/csrf: the response is a clean 413 and no CSRF
|
|
||||||
// cookie was issued, so neither the CSRF middleware nor the login
|
|
||||||
// handler ran.
|
|
||||||
func TestPagesLogin_OversizeBody_RejectedBeforeCSRF(t *testing.T) {
|
|
||||||
t.Parallel()
|
|
||||||
|
|
||||||
env := newTestEnv(t)
|
|
||||||
|
|
||||||
form := url.Values{}
|
|
||||||
form.Set("username", oversizeValue())
|
|
||||||
form.Set("password", "irrelevant")
|
|
||||||
|
|
||||||
w := env.post("/pages/login", form, nil)
|
|
||||||
|
|
||||||
assert.Equal(
|
|
||||||
t, http.StatusRequestEntityTooLarge, w.Code,
|
|
||||||
)
|
|
||||||
assert.False(
|
|
||||||
t, csrfCookieSet(w),
|
|
||||||
"CSRF middleware must not run for an oversized body",
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestPagesLogin_UnderLimit_NoToken_CSRFRejects is the control for
|
|
||||||
// the test above: an identically shaped but under-limit POST does
|
|
||||||
// reach gorilla/csrf, which rejects it and issues its cookie. Without
|
|
||||||
// this, the missing-cookie assertion above would prove nothing.
|
|
||||||
func TestPagesLogin_UnderLimit_NoToken_CSRFRejects(t *testing.T) {
|
|
||||||
t.Parallel()
|
|
||||||
|
|
||||||
env := newTestEnv(t)
|
|
||||||
|
|
||||||
form := url.Values{}
|
|
||||||
form.Set("username", "someone")
|
|
||||||
form.Set("password", "irrelevant")
|
|
||||||
|
|
||||||
w := env.post("/pages/login", form, nil)
|
|
||||||
|
|
||||||
assert.Equal(t, http.StatusForbidden, w.Code)
|
|
||||||
assert.True(
|
|
||||||
t, csrfCookieSet(w),
|
|
||||||
"CSRF middleware should run for an under-limit body",
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestPagesLogin_UnderLimit_ValidToken_ReachesHandler proves the
|
|
||||||
// reorder did not break CSRF token handling: a token harvested from
|
|
||||||
// the rendered login form is still accepted and the request lands in
|
|
||||||
// the handler.
|
|
||||||
func TestPagesLogin_UnderLimit_ValidToken_ReachesHandler(
|
|
||||||
t *testing.T,
|
|
||||||
) {
|
|
||||||
t.Parallel()
|
|
||||||
|
|
||||||
env := newTestEnv(t)
|
|
||||||
|
|
||||||
token, cookies := env.csrfFrom(t, "/pages/login", nil)
|
|
||||||
|
|
||||||
form := url.Values{}
|
|
||||||
form.Set("csrf_token", token)
|
|
||||||
form.Set("username", "nosuchuser")
|
|
||||||
form.Set("password", "wrongpassword")
|
|
||||||
|
|
||||||
w := env.post("/pages/login", form, cookies)
|
|
||||||
|
|
||||||
assert.Equal(t, http.StatusUnauthorized, w.Code)
|
|
||||||
assert.Contains(
|
|
||||||
t, w.Body.String(), "Invalid username or password",
|
|
||||||
"request should reach the login handler",
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
// --- /user/{username} group ---
|
|
||||||
|
|
||||||
// TestPasswordChange_OversizeBody_RejectedAndPasswordUnchanged
|
|
||||||
// covers the route that previously had no middleware body cap at
|
|
||||||
// all. The request carries a valid session and a valid CSRF token,
|
|
||||||
// so the only thing that can stop it is the size cap; the unchanged
|
|
||||||
// password hash is the observable proof the handler never ran.
|
|
||||||
func TestPasswordChange_OversizeBody_RejectedAndPasswordUnchanged(
|
|
||||||
t *testing.T,
|
|
||||||
) {
|
|
||||||
t.Parallel()
|
|
||||||
|
|
||||||
env := newTestEnv(t)
|
|
||||||
|
|
||||||
userID, originalHash := env.seedUser(t, "pwuser", "oldpassword")
|
|
||||||
cookies := env.authCookies(t, userID, "pwuser")
|
|
||||||
token, cookies := env.csrfFrom(t, "/user/pwuser/", cookies)
|
|
||||||
|
|
||||||
form := url.Values{}
|
|
||||||
form.Set("csrf_token", token)
|
|
||||||
form.Set("current_password", "oldpassword")
|
|
||||||
form.Set("new_password", oversizeValue())
|
|
||||||
form.Set("confirm_password", oversizeValue())
|
|
||||||
|
|
||||||
w := env.post("/user/pwuser/password", form, cookies)
|
|
||||||
|
|
||||||
assert.Equal(
|
|
||||||
t, http.StatusRequestEntityTooLarge, w.Code,
|
|
||||||
)
|
|
||||||
assert.Equal(
|
|
||||||
t, originalHash, env.storedHash(t, "pwuser"),
|
|
||||||
"handler must not run, so the password must be unchanged",
|
|
||||||
)
|
|
||||||
}
|
|
||||||
|
|
||||||
// TestPasswordChange_UnderLimit_Succeeds proves that adding the cap
|
|
||||||
// to the /user/{username} group did not break the route it guards.
|
|
||||||
func TestPasswordChange_UnderLimit_Succeeds(t *testing.T) {
|
|
||||||
t.Parallel()
|
|
||||||
|
|
||||||
env := newTestEnv(t)
|
|
||||||
|
|
||||||
userID, originalHash := env.seedUser(t, "okuser", "oldpassword")
|
|
||||||
cookies := env.authCookies(t, userID, "okuser")
|
|
||||||
token, cookies := env.csrfFrom(t, "/user/okuser/", cookies)
|
|
||||||
|
|
||||||
form := url.Values{}
|
|
||||||
form.Set("csrf_token", token)
|
|
||||||
form.Set("current_password", "oldpassword")
|
|
||||||
form.Set("new_password", "brandnewpassword")
|
|
||||||
form.Set("confirm_password", "brandnewpassword")
|
|
||||||
|
|
||||||
w := env.post("/user/okuser/password", form, cookies)
|
|
||||||
|
|
||||||
assert.Equal(t, http.StatusOK, w.Code)
|
|
||||||
assert.NotEqual(
|
|
||||||
t, originalHash, env.storedHash(t, "okuser"),
|
|
||||||
"an under-limit password change should still apply",
|
|
||||||
)
|
|
||||||
}
|
|
||||||
Reference in New Issue
Block a user