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): OperatorBearer middleware + operator token config
CarterPerez-dev426ed54594db
diff --git a/PROJECTS/beginner/canary-token-generator/backend/internal/config/config.go b/PROJECTS/beginner/canary-token-generator/backend/internal/config/config.goindex 2e561c35..068deaa1 100644--- a/PROJECTS/beginner/canary-token-generator/backend/internal/config/config.go+++ b/PROJECTS/beginner/canary-token-generator/backend/internal/config/config.go@@ -27,6 +27,11 @@ type Config struct {Turnstile TurnstileConfig `koanf:"turnstile"`MySQL MySQLConfig `koanf:"mysql"`Notify NotifyConfig `koanf:"notify"`+ Operator OperatorConfig `koanf:"operator"`+}++type OperatorConfig struct {+ Token string `koanf:"token"`}type NotifyConfig struct {@@ -255,6 +260,8 @@ func loadDefaults(k *koanf.Koanf) error {"notify.webhook_hmac_secret": "","notify.telegram_api_base": "https://api.telegram.org","notify.fingerprint_window": "5m",++ "operator.token": "",}for key, value := range defaults {@@ -305,6 +312,7 @@ var envKeyMap = map[string]string{"WEBHOOK_HMAC_SECRET": "notify.webhook_hmac_secret","NOTIFY_TELEGRAM_API_BASE": "notify.telegram_api_base","NOTIFY_FINGERPRINT_WINDOW": "notify.fingerprint_window",+ "OPERATOR_TOKEN": "operator.token",}func envKeyReplacer(s string) string {diff --git a/PROJECTS/beginner/canary-token-generator/backend/internal/middleware/operator_bearer.go b/PROJECTS/beginner/canary-token-generator/backend/internal/middleware/operator_bearer.gonew file mode 100644index 00000000..458fd07e--- /dev/null+++ b/PROJECTS/beginner/canary-token-generator/backend/internal/middleware/operator_bearer.go@@ -0,0 +1,35 @@+// ©AngelaMos | 2026+// operator_bearer.go++package middleware++import (+ "crypto/subtle"+ "net/http"+)++const bearerPrefix = "Bearer "++func OperatorBearer(token string) func(http.Handler) http.Handler {+ expected := []byte(token)+ return func(next http.Handler) http.Handler {+ return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {+ if len(expected) == 0 {+ http.NotFound(w, r)+ return+ }+ auth := r.Header.Get("Authorization")+ if len(auth) <= len(bearerPrefix) ||+ auth[:len(bearerPrefix)] != bearerPrefix {+ http.NotFound(w, r)+ return+ }+ supplied := []byte(auth[len(bearerPrefix):])+ if subtle.ConstantTimeCompare(supplied, expected) != 1 {+ http.NotFound(w, r)+ return+ }+ next.ServeHTTP(w, r)+ })+ }+}diff --git a/PROJECTS/beginner/canary-token-generator/backend/internal/middleware/operator_bearer_test.go b/PROJECTS/beginner/canary-token-generator/backend/internal/middleware/operator_bearer_test.gonew file mode 100644index 00000000..e201df23--- /dev/null+++ b/PROJECTS/beginner/canary-token-generator/backend/internal/middleware/operator_bearer_test.go@@ -0,0 +1,185 @@+// ©AngelaMos | 2026+// operator_bearer_test.go++package middleware_test++import (+ "net/http"+ "net/http/httptest"+ "sync/atomic"+ "testing"++ "github.com/stretchr/testify/require"++ "github.com/CarterPerez-dev/cybersecurity-projects/canary-token-generator/backend/internal/middleware"+)++const (+ opTokenCorrect = "s3cr3t-op-token-xyz"+ opTokenWrong = "s3cr3t-op-token-XYZ"+)++func opNextHandler(calls *atomic.Int32) http.Handler {+ return http.HandlerFunc(func(w http.ResponseWriter, _ *http.Request) {+ calls.Add(1)+ w.WriteHeader(http.StatusTeapot)+ if _, err := w.Write([]byte("ok")); err != nil {+ return+ }+ })+}++func TestOperatorBearer_TableDriven(t *testing.T) {+ tests := []struct {+ name string+ configuredTok string+ authHeader string+ setHeader bool+ wantStatus int+ wantBodyPrefix string+ wantNextCalled bool+ }{+ {+ name: "missing Authorization header returns 404",+ configuredTok: opTokenCorrect,+ setHeader: false,+ wantStatus: http.StatusNotFound,+ wantBodyPrefix: "404",+ wantNextCalled: false,+ },+ {+ name: "empty Authorization header returns 404",+ configuredTok: opTokenCorrect,+ authHeader: "",+ setHeader: true,+ wantStatus: http.StatusNotFound,+ wantNextCalled: false,+ },+ {+ name: "wrong scheme Basic returns 404",+ configuredTok: opTokenCorrect,+ authHeader: "Basic " + opTokenCorrect,+ setHeader: true,+ wantStatus: http.StatusNotFound,+ wantNextCalled: false,+ },+ {+ name: "lowercase bearer returns 404 (scheme is case-sensitive)",+ configuredTok: opTokenCorrect,+ authHeader: "bearer " + opTokenCorrect,+ setHeader: true,+ wantStatus: http.StatusNotFound,+ wantNextCalled: false,+ },+ {+ name: "Bearer prefix with no token returns 404",+ configuredTok: opTokenCorrect,+ authHeader: "Bearer ",+ setHeader: true,+ wantStatus: http.StatusNotFound,+ wantNextCalled: false,+ },+ {+ name: "Bearer with no trailing space returns 404",+ configuredTok: opTokenCorrect,+ authHeader: "Bearer" + opTokenCorrect,+ setHeader: true,+ wantStatus: http.StatusNotFound,+ wantNextCalled: false,+ },+ {+ name: "wrong token of equal length returns 404",+ configuredTok: opTokenCorrect,+ authHeader: "Bearer " + opTokenWrong,+ setHeader: true,+ wantStatus: http.StatusNotFound,+ wantNextCalled: false,+ },+ {+ name: "wrong token of different length returns 404",+ configuredTok: opTokenCorrect,+ authHeader: "Bearer nope",+ setHeader: true,+ wantStatus: http.StatusNotFound,+ wantNextCalled: false,+ },+ {+ name: "correct token passes through to next",+ configuredTok: opTokenCorrect,+ authHeader: "Bearer " + opTokenCorrect,+ setHeader: true,+ wantStatus: http.StatusTeapot,+ wantBodyPrefix: "ok",+ wantNextCalled: true,+ },+ {+ name: "empty configured token rejects all requests including matching empty",+ configuredTok: "",+ authHeader: "Bearer ",+ setHeader: true,+ wantStatus: http.StatusNotFound,+ wantNextCalled: false,+ },+ {+ name: "empty configured token rejects even a Bearer-with-payload",+ configuredTok: "",+ authHeader: "Bearer anything",+ setHeader: true,+ wantStatus: http.StatusNotFound,+ wantNextCalled: false,+ },+ {+ name: "extra whitespace inside token is not trimmed",+ configuredTok: opTokenCorrect,+ authHeader: "Bearer " + opTokenCorrect,+ setHeader: true,+ wantStatus: http.StatusNotFound,+ wantNextCalled: false,+ },+ }++ for _, tc := range tests {+ t.Run(tc.name, func(t *testing.T) {+ var calls atomic.Int32+ h := middleware.OperatorBearer(+ tc.configuredTok,+ )(+ opNextHandler(&calls),+ )++ r := httptest.NewRequest(http.MethodGet, "/admin/x", nil)+ if tc.setHeader {+ r.Header.Set("Authorization", tc.authHeader)+ }+ w := httptest.NewRecorder()+ h.ServeHTTP(w, r)++ require.Equal(t, tc.wantStatus, w.Code)+ if tc.wantNextCalled {+ require.Equal(t, int32(1), calls.Load())+ } else {+ require.Equal(t, int32(0), calls.Load(),+ "next handler must not be invoked on auth failure")+ }+ if tc.wantBodyPrefix != "" {+ require.Contains(t, w.Body.String(), tc.wantBodyPrefix)+ }+ })+ }+}++func TestOperatorBearer_NoWWWAuthenticateHeader(t *testing.T) {+ var calls atomic.Int32+ h := middleware.OperatorBearer(opTokenCorrect)(opNextHandler(&calls))++ r := httptest.NewRequest(http.MethodGet, "/admin/x", nil)+ w := httptest.NewRecorder()+ h.ServeHTTP(w, r)++ require.Equal(t, http.StatusNotFound, w.Code)+ require.Empty(+ t,+ w.Header().Get("WWW-Authenticate"),+ "404 hides endpoint existence; WWW-Authenticate would leak the auth scheme",+ )+}