Building 70 Projects ranging from beginner to advanced so anyone can — learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company 👇
Go aicertificationcloud-engineeringcybercybersecuritycybersecurity-analystcybersecurity-certificationcybersecurity-certificationscybersecurity-educationcybersecurity-jobscybersecurity-portfoliocybersecurity-projectscybersecurity-toolsgrchackinglearningpentestingproject-repositoryprojetcspython
feat(canary): slowredirect fingerprint endpoint
CarterPerez-dev6dd520f966d7
diff --git a/PROJECTS/beginner/canary-token-generator/backend/internal/token/generators/slowredirect/fingerprint_handler.go b/PROJECTS/beginner/canary-token-generator/backend/internal/token/generators/slowredirect/fingerprint_handler.gonew file mode 100644index 00000000..df36075c--- /dev/null+++ b/PROJECTS/beginner/canary-token-generator/backend/internal/token/generators/slowredirect/fingerprint_handler.go@@ -0,0 +1,75 @@+// ©AngelaMos | 2026+// fingerprint_handler.go++package slowredirect++import (+ "context"+ "encoding/json"+ "errors"+ "io"+ "log/slog"+ "net/http"+ "time"++ "github.com/go-chi/chi/v5"++ "github.com/CarterPerez-dev/cybersecurity-projects/canary-token-generator/backend/internal/event"+)++const (+ fingerprintWindow = 30 * time.Second+ fingerprintMaxBytes = 64 * 1024+ urlParamTokenID = "id"+)++type FingerprintAttacher interface {+ AttachFingerprint(+ ctx context.Context,+ tokenID, sourceIP string,+ fingerprint json.RawMessage,+ window time.Duration,+ ) error+}++type FingerprintHandler struct {+ attacher FingerprintAttacher+ window time.Duration+}++func NewFingerprintHandler(a FingerprintAttacher) *FingerprintHandler {+ return &FingerprintHandler{+ attacher: a,+ window: fingerprintWindow,+ }+}++func (h *FingerprintHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {+ ctx := r.Context()++ tokenID := chi.URLParam(r, urlParamTokenID)+ if tokenID == "" {+ w.WriteHeader(http.StatusNoContent)+ return+ }++ body, err := io.ReadAll(http.MaxBytesReader(w, r.Body, fingerprintMaxBytes))+ if err != nil || len(body) == 0 || !json.Valid(body) {+ w.WriteHeader(http.StatusNoContent)+ return+ }++ if err := h.attacher.AttachFingerprint(+ ctx,+ tokenID,+ realIP(r),+ json.RawMessage(body),+ h.window,+ ); err != nil && !errors.Is(err, event.ErrNotFound) {+ slog.WarnContext(ctx, "attach fingerprint failed",+ "token_id", tokenID,+ "error", err,+ )+ }+ w.WriteHeader(http.StatusNoContent)+}diff --git a/PROJECTS/beginner/canary-token-generator/backend/internal/token/generators/slowredirect/fingerprint_handler_test.go b/PROJECTS/beginner/canary-token-generator/backend/internal/token/generators/slowredirect/fingerprint_handler_test.gonew file mode 100644index 00000000..33899173--- /dev/null+++ b/PROJECTS/beginner/canary-token-generator/backend/internal/token/generators/slowredirect/fingerprint_handler_test.go@@ -0,0 +1,180 @@+// ©AngelaMos | 2026+// fingerprint_handler_test.go++//go:build integration++package slowredirect_test++import (+ "bytes"+ "context"+ "encoding/json"+ "net/http"+ "net/http/httptest"+ "testing"++ "github.com/go-chi/chi/v5"+ "github.com/google/uuid"+ "github.com/jmoiron/sqlx"+ "github.com/stretchr/testify/require"++ "github.com/CarterPerez-dev/cybersecurity-projects/canary-token-generator/backend/internal/event"+ "github.com/CarterPerez-dev/cybersecurity-projects/canary-token-generator/backend/internal/testutil"+ "github.com/CarterPerez-dev/cybersecurity-projects/canary-token-generator/backend/internal/token"+ "github.com/CarterPerez-dev/cybersecurity-projects/canary-token-generator/backend/internal/token/generators/slowredirect"+)++const (+ fingerprintRoute = "/c/{id}/fingerprint"+ clientIP = "203.0.113.45"+)++func newSlowredirectRepos(+ t *testing.T,+) (*token.Repository, *event.Repository) {+ t.Helper()+ db := sqlx.NewDb(testutil.NewTestDB(t), "pgx")+ return token.NewRepository(db), event.NewRepository(db)+}++func seedSlowredirectToken(+ t *testing.T,+ repo *token.Repository,+ id, destination string,+) *token.Token {+ t.Helper()+ metaJSON, _ := json.Marshal(map[string]string{+ "destination_url": destination,+ })+ tok := &token.Token{+ ID: id,+ ManageID: uuid.New().String(),+ Type: token.TypeSlowRedirect,+ Memo: "integration-fp",+ AlertChannel: token.ChannelWebhook,+ WebhookURL: testutil.Ptr("https://example.com/hook"),+ CreatedIP: clientIP,+ CreatedFP: "abcdef0123456789",+ Metadata: json.RawMessage(metaJSON),+ Enabled: true,+ }+ require.NoError(t, repo.Insert(context.Background(), tok))+ return tok+}++func mountFingerprintRouter(h http.Handler) http.Handler {+ r := chi.NewRouter()+ r.Post(fingerprintRoute, h.ServeHTTP)+ return r+}++func TestFingerprintHandler_AttachesToRecentEvent(t *testing.T) {+ t.Parallel()+ tokRepo, evtRepo := newSlowredirectRepos(t)+ ctx := context.Background()++ tok := seedSlowredirectToken(t, tokRepo, "fpattach0001", "https://news.example.com")+ evt := &event.Event{+ TokenID: tok.ID,+ SourceIP: clientIP,+ Extra: json.RawMessage(`{"initial":"value"}`),+ }+ require.NoError(t, evtRepo.Insert(ctx, evt))++ handler := slowredirect.NewFingerprintHandler(evtRepo)+ router := mountFingerprintRouter(handler)++ fpBody := []byte(`{"screen":{"w":1920,"h":1080},"timezone":"America/Los_Angeles"}`)+ req := httptest.NewRequest(+ http.MethodPost,+ "/c/"+tok.ID+"/fingerprint",+ bytes.NewReader(fpBody),+ )+ req.Header.Set("CF-Connecting-IP", clientIP)+ req.Header.Set("Content-Type", "application/json")+ rr := httptest.NewRecorder()+ router.ServeHTTP(rr, req)++ require.Equal(t, http.StatusNoContent, rr.Code)++ got, err := evtRepo.GetByID(ctx, evt.ID)+ require.NoError(t, err)++ var merged map[string]any+ require.NoError(t, json.Unmarshal(got.Extra, &merged))+ require.Equal(t, "value", merged["initial"])+ require.Equal(t, "America/Los_Angeles", merged["timezone"])+ screen, ok := merged["screen"].(map[string]any)+ require.True(t, ok, "screen sub-object must round-trip as nested map")+ require.EqualValues(t, 1920, screen["w"])+ require.EqualValues(t, 1080, screen["h"])+}++func TestFingerprintHandler_NoMatchingEvent_Returns204(t *testing.T) {+ t.Parallel()+ tokRepo, evtRepo := newSlowredirectRepos(t)++ tok := seedSlowredirectToken(t, tokRepo, "fpnomatch001", "https://news.example.com")++ handler := slowredirect.NewFingerprintHandler(evtRepo)+ router := mountFingerprintRouter(handler)++ fpBody := []byte(`{"screen":{"w":800,"h":600}}`)+ req := httptest.NewRequest(+ http.MethodPost,+ "/c/"+tok.ID+"/fingerprint",+ bytes.NewReader(fpBody),+ )+ req.Header.Set("CF-Connecting-IP", clientIP)+ rr := httptest.NewRecorder()+ router.ServeHTTP(rr, req)++ require.Equal(+ t,+ http.StatusNoContent,+ rr.Code,+ "no matching event must still return 204 — fingerprint is enrichment, not the trigger",+ )+}++func TestFingerprintHandler_InvalidJSON_Returns204AndDoesNotTouchEvent(t *testing.T) {+ t.Parallel()+ tokRepo, evtRepo := newSlowredirectRepos(t)+ ctx := context.Background()++ tok := seedSlowredirectToken(t, tokRepo, "fpinvjson001", "https://news.example.com")+ evt := &event.Event{+ TokenID: tok.ID,+ SourceIP: clientIP,+ Extra: json.RawMessage(`{"initial":"value"}`),+ }+ require.NoError(t, evtRepo.Insert(ctx, evt))++ handler := slowredirect.NewFingerprintHandler(evtRepo)+ router := mountFingerprintRouter(handler)++ req := httptest.NewRequest(+ http.MethodPost,+ "/c/"+tok.ID+"/fingerprint",+ bytes.NewReader([]byte("not-json-at-all")),+ )+ req.Header.Set("CF-Connecting-IP", clientIP)+ rr := httptest.NewRecorder()+ router.ServeHTTP(rr, req)++ require.Equal(t, http.StatusNoContent, rr.Code)++ got, err := evtRepo.GetByID(ctx, evt.ID)+ require.NoError(t, err)++ var stored map[string]any+ require.NoError(t, json.Unmarshal(got.Extra, &stored))+ require.Equal(+ t,+ "value",+ stored["initial"],+ "invalid JSON must not corrupt the stored Extra JSONB",+ )+ _, hasInvalid := stored["not-json"]+ require.False(t, hasInvalid)+}