Skip to content

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 đŸ‘‡

fix(canary-phase0): address audit findings before phase rollup

CarterPerez-dev98c006897d00
diff --git a/PROJECTS/beginner/canary-token-generator/.env.example b/PROJECTS/beginner/canary-token-generator/.env.example
index 003d2f07..4f97ac3f 100644
--- a/PROJECTS/beginner/canary-token-generator/.env.example
+++ b/PROJECTS/beginner/canary-token-generator/.env.example
@@ -10,6 +10,9 @@
# Public-facing
# ---------------------------------------------------------------------------
APP_NAME=canary-token-generator
+
+# Production nginx host port (compose.yml). Dev compose has its own default
+# of 58495 in dev.compose.yml; do not override NGINX_HOST_PORT in shared .env.
NGINX_HOST_PORT=22784
# Used to construct trigger URLs embedded in artifacts (e.g. canary docs).
diff --git a/PROJECTS/beginner/canary-token-generator/backend/.env.example b/PROJECTS/beginner/canary-token-generator/backend/.env.example
deleted file mode 100644
index f0cd29e1..00000000
--- a/PROJECTS/beginner/canary-token-generator/backend/.env.example
+++ /dev/null
@@ -1,27 +0,0 @@
-# AngelaMos | 2026
-# .env.example
-
-# Environment: development, staging, production
-ENVIRONMENT=development
-
-# Server
-HOST=0.0.0.0
-PORT=8080
-
-# Database
-DATABASE_URL=postgres://postgres:postgres@localhost:5432/app?sslmode=disable
-
-# Redis
-REDIS_URL=redis://localhost:6379/0
-
-# Rate Limiting
-RATE_LIMIT_REQUESTS=100
-RATE_LIMIT_WINDOW=1m
-
-# OpenTelemetry
-OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
-OTEL_SERVICE_NAME=canary-token-generator
-
-# Logging
-LOG_LEVEL=debug
-LOG_FORMAT=text
diff --git a/PROJECTS/beginner/canary-token-generator/backend/.gitignore b/PROJECTS/beginner/canary-token-generator/backend/.gitignore
index 3688c87b..ba808b80 100644
--- a/PROJECTS/beginner/canary-token-generator/backend/.gitignore
+++ b/PROJECTS/beginner/canary-token-generator/backend/.gitignore
@@ -1,4 +1,4 @@
-# AngelaMos | 2026
+# ©AngelaMos | 2026
# .gitignore
# Binaries
@@ -33,10 +33,6 @@ Thumbs.db
.env.local
.env.*.local
-# Keys (sensitive)
-keys/*.pem
-keys/*.key
-
# Vendor (if using)
vendor/
diff --git a/PROJECTS/beginner/canary-token-generator/backend/Dockerfile b/PROJECTS/beginner/canary-token-generator/backend/Dockerfile
deleted file mode 100644
index d6f02050..00000000
--- a/PROJECTS/beginner/canary-token-generator/backend/Dockerfile
+++ /dev/null
@@ -1,36 +0,0 @@
-# AngelaMos | 2026
-# Dockerfile - Multi-stage distroless build
-
-# Build stage
-FROM golang:1.25-bookworm AS builder
-
-WORKDIR /build
-
-# Copy dependency files first for layer caching
-COPY go.mod go.sum ./
-RUN go mod download
-
-# Copy source code
-COPY . .
-
-# Build binary
-RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o /app ./cmd/api
-
-# Production stage - Distroless
-FROM gcr.io/distroless/static-debian12
-
-# Copy binary from builder
-COPY --from=builder /app /app
-
-# Copy migrations (embedded, but useful for debugging)
-COPY --from=builder /build/migrations /migrations
-
-# Copy keys if they exist (for JWT)
-COPY --from=builder /build/keys /keys
-
-# Run as non-root user
-USER nonroot:nonroot
-
-EXPOSE 8080
-
-ENTRYPOINT ["/app"]
diff --git a/PROJECTS/beginner/canary-token-generator/backend/Justfile b/PROJECTS/beginner/canary-token-generator/backend/Justfile
deleted file mode 100644
index 118968ee..00000000
--- a/PROJECTS/beginner/canary-token-generator/backend/Justfile
+++ /dev/null
@@ -1,97 +0,0 @@
-# AngelaMos | 2026
-# Justfile
-
-set dotenv-load := true
-
-# Default recipe
-default:
- @just --list
-
-# Development
-# -----------
-
-# Run the API server with hot reload (requires air)
-dev:
- air -c .air.toml
-
-# Run the canary server without hot reload
-run:
- go run ./cmd/canary
-
-# Build the binary
-build:
- CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o bin/canary ./cmd/canary
-
-# Run tests
-test:
- go test -v -race -coverprofile=coverage.out ./...
-
-# Run tests with coverage report
-test-coverage: test
- go tool cover -html=coverage.out -o coverage.html
-
-# Run linter
-lint:
- golangci-lint run --timeout=5m
-
-# Format code
-fmt:
- gofumpt -w .
- goimports -w .
-
-# Tidy dependencies
-tidy:
- go mod tidy
-
-# Database
-# --------
-
-# Run database migrations
-migrate-up:
- goose -dir migrations postgres "${DATABASE_URL}" up
-
-# Rollback last migration
-migrate-down:
- goose -dir migrations postgres "${DATABASE_URL}" down
-
-# Check migration status
-migrate-status:
- goose -dir migrations postgres "${DATABASE_URL}" status
-
-# Create new migration
-migrate-create name:
- goose -dir migrations create {{name}} sql
-
-# Docker
-# ------
-
-# Start development containers
-up:
- docker compose -f dev.compose.yml up -d
-
-# Stop development containers
-down:
- docker compose -f dev.compose.yml down
-
-# View container logs
-logs:
- docker compose -f dev.compose.yml logs -f
-
-# Rebuild and restart containers
-rebuild:
- docker compose -f dev.compose.yml up -d --build
-
-# Build production image
-docker-build:
- docker build -t canary-token-generator:latest .
-
-# Clean
-# -----
-
-# Remove build artifacts
-clean:
- rm -rf bin/ coverage.out coverage.html tmp/
-
-# Full clean including containers
-clean-all: clean
- docker compose -f dev.compose.yml down -v
diff --git a/PROJECTS/beginner/canary-token-generator/backend/internal/admin/handler.go b/PROJECTS/beginner/canary-token-generator/backend/internal/admin/handler.go
index 61fa4f23..7f5b67ff 100644
--- a/PROJECTS/beginner/canary-token-generator/backend/internal/admin/handler.go
+++ b/PROJECTS/beginner/canary-token-generator/backend/internal/admin/handler.go
@@ -1,4 +1,4 @@
-// AngelaMos | 2026
+// ©AngelaMos | 2026
// handler.go
package admin
@@ -15,16 +15,11 @@ import (
"github.com/CarterPerez-dev/cybersecurity-projects/canary-token-generator/backend/internal/core"
)
-type AuthService interface {
- InvalidateAllSessions(ctx context.Context) error
-}
-
type Handler struct {
dbStats func() sql.DBStats
redisStats func() *redis.PoolStats
redisPing func(ctx context.Context) error
dbPing func(ctx context.Context) error
- authSvc AuthService
}
type HandlerConfig struct {
@@ -32,7 +27,6 @@ type HandlerConfig struct {
RedisStats func() *redis.PoolStats
RedisPing func(ctx context.Context) error
DBPing func(ctx context.Context) error
- AuthSvc AuthService
}
func NewHandler(cfg HandlerConfig) *Handler {
@@ -41,18 +35,11 @@ func NewHandler(cfg HandlerConfig) *Handler {
redisStats: cfg.RedisStats,
redisPing: cfg.RedisPing,
dbPing: cfg.DBPing,
- authSvc: cfg.AuthSvc,
}
}
-func (h *Handler) RegisterRoutes(
- r chi.Router,
- authenticator, adminOnly func(http.Handler) http.Handler,
-) {
+func (h *Handler) RegisterRoutes(r chi.Router) {
r.Route("/admin", func(r chi.Router) {
- r.Use(authenticator)
- r.Use(adminOnly)
-
r.Get("/stats", h.GetSystemStats)
r.Get("/stats/db", h.GetDatabaseStats)
r.Get("/stats/redis", h.GetRedisStats)
diff --git a/PROJECTS/beginner/canary-token-generator/cloudflared.compose.yml b/PROJECTS/beginner/canary-token-generator/cloudflared.compose.yml
index 58df3753..15da674d 100644
--- a/PROJECTS/beginner/canary-token-generator/cloudflared.compose.yml
+++ b/PROJECTS/beginner/canary-token-generator/cloudflared.compose.yml
@@ -1,5 +1,5 @@
# =============================================================================
-# AngelaMos | 2026
+# ©AngelaMos | 2026
# cloudflared.compose.yml
# =============================================================================
# Cloudflare Tunnel for production remote access
diff --git a/PROJECTS/beginner/canary-token-generator/infra/docker/vite.dev b/PROJECTS/beginner/canary-token-generator/infra/docker/vite.dev
index 2fafe7fd..fb86df4e 100644
--- a/PROJECTS/beginner/canary-token-generator/infra/docker/vite.dev
+++ b/PROJECTS/beginner/canary-token-generator/infra/docker/vite.dev
@@ -1,5 +1,5 @@
# =============================================================================
-# AngelaMos | 2026
+# ©AngelaMos | 2026
# vite.dev
# =============================================================================
# Development Dockerfile for Vite/React frontend
diff --git a/PROJECTS/beginner/canary-token-generator/infra/docker/vite.prod b/PROJECTS/beginner/canary-token-generator/infra/docker/vite.prod
index 48bbf366..e1543bb7 100644
--- a/PROJECTS/beginner/canary-token-generator/infra/docker/vite.prod
+++ b/PROJECTS/beginner/canary-token-generator/infra/docker/vite.prod
@@ -1,5 +1,5 @@
# =============================================================================
-# AngelaMos | 2026
+# ©AngelaMos | 2026
# vite.prod
# =============================================================================
# Production Dockerfile: builds Vite app, serves via Nginx
@@ -15,12 +15,12 @@ RUN corepack enable && corepack prepare pnpm@latest --activate
WORKDIR /app
-COPY react-scss/package.json react-scss/pnpm-lock.yaml* ./
+COPY frontend/package.json frontend/pnpm-lock.yaml* ./
RUN --mount=type=cache,target=/root/.local/share/pnpm/store \
pnpm install --frozen-lockfile
-COPY react-scss/ .
+COPY frontend/ .
ARG VITE_API_URL=/api
ARG VITE_APP_TITLE="My App"
diff --git a/PROJECTS/beginner/canary-token-generator/scripts/init.sh b/PROJECTS/beginner/canary-token-generator/scripts/init.sh
index 2f240ae7..6c4c152e 100755
--- a/PROJECTS/beginner/canary-token-generator/scripts/init.sh
+++ b/PROJECTS/beginner/canary-token-generator/scripts/init.sh
@@ -60,14 +60,14 @@ if [[ -n "$ACCT" && -n "$KEY" ]]; then
if [[ ! -f "$MMDB_PATH" ]]; then
mkdir -p "$DATA_DIR"
echo " downloading GeoLite2-City.mmdb from MaxMind..."
- local_tmp="$(mktemp -d)"
- trap 'rm -rf "$local_tmp"' EXIT
+ tmp_dir="$(mktemp -d)"
+ trap 'rm -rf "$tmp_dir"' EXIT
if curl -sSf -u "$ACCT:$KEY" \
"https://download.maxmind.com/geoip/databases/GeoLite2-City/download?suffix=tar.gz" \
- -o "$local_tmp/geolite.tar.gz"; then
- tar -xzf "$local_tmp/geolite.tar.gz" -C "$local_tmp" --strip-components=1 \
+ -o "$tmp_dir/geolite.tar.gz"; then
+ tar -xzf "$tmp_dir/geolite.tar.gz" -C "$tmp_dir" --strip-components=1 \
"*/GeoLite2-City.mmdb"
- mv "$local_tmp/GeoLite2-City.mmdb" "$MMDB_PATH"
+ mv "$tmp_dir/GeoLite2-City.mmdb" "$MMDB_PATH"
echo " GeoLite2-City.mmdb downloaded to $MMDB_PATH"
else
echo " Warning: GeoLite2 download failed (check MAXMIND_ACCOUNT_ID and MAXMIND_LICENSE_KEY)" >&2