Core Code
Core Code Modern Dev Handbook
APPLICATION-SECURITY Contents
Security Foundations for Production Apps
Threat Modeling (Practical, Repeatable) OWASP Top 10 (Operator Lens) Defense in Depth (Layered Controls That Hold) Security Baselines and Checklists (What “Good” Looks Like) Secrets in Apps (Storage, Injection, Rotation) Logging Sensitive Data (Pitfalls and Redaction) Rate Limiting Patterns (Abuse and Resilience) Abuse Prevention (Bots, Fraud, Enumeration) HTTPS & TLS Realities (HSTS, Termination, Cert Ops) Secure Headers Baseline (Production Defaults)
Identity, Authentication, and Sessions
Sessions vs JWT (Production Tradeoffs) JWT Attack Patterns and Validation Pitfalls Password Hashing Ops (bcrypt/argon2 Parameters) OAuth2 Flows in Practice (Auth Code + PKCE) OIDC Internals (Discovery, JWKS, Claims) Token Revocation Strategies (What Actually Works) Refresh Token Abuse and Rotation Defenses API Key Management (Issuance, Rotation, Scoping) mTLS Basics (Service-to-Service Identity) Identity Boundary Design (Trust Zones)
Web Attacks and Practical Defenses
XSS in Production (Exploit Paths and CSP Hardening) CSRF (SameSite Reality vs Token Defenses) SSRF (Cloud Metadata Abuse and Egress Controls) Clickjacking (Frame Controls and UI Redress) SQL Injection (Production Defense Patterns) CORS Misconfigurations (Real-World Impact) CSP Practical Recipes (Deployable Policies) Secure Cookie Patterns (HttpOnly, Secure, SameSite) Request Validation Patterns (What to Validate Where) File Upload Hardening (Content Sniffing, AV, Storage)
Secure Delivery, Hardening, and Incident Response
Secure SDLC (Gates That Don’t Kill Delivery) Dependency Risks (Vulns, Updates, Policies) App Supply Chain (Lockfiles, Pinning, Review) Configuration Hardening (Safe Defaults Checklist) Security Monitoring Signals (Auth, Data, Network) Security Alert Design (Noise, Triage, Escalation) WAF Realities (What It Stops and What It Doesn’t) Credential Leak Runbook (Keys, Tokens, Passwords) Compromised Token Runbook (JWT/OAuth Sessions) Security Incident Response (Contain, Eradicate, Recover)

OIDC Internals (Discovery, JWKS, Claims)

OIDC runbook: issuer discovery, JWKS rotation, claims mapping, and safe audience/nonce handling for production apps.
On this page

What OIDC Adds

  • An identity layer on top of OAuth2.
  • Standardized id_token with claims about the user.
  • Discovery metadata + JWKS for key distribution.

Hard Requirements

  • Verify issuer (iss) exactly.
  • Verify audience (aud) per client/app.
  • Verify token expiry and clock skew policy.
  • Use nonce in browser-based flows where applicable.

JWKS Rotation (Ops)

Best practice:
- cache JWKS with TTL
- refresh on unknown kid
- keep previous keys available during rotation
- alert on sudden verify failures

Claims Mapping

  • Map stable subject (sub) to your internal user id.
  • Avoid using mutable fields (email) as primary identity key.
  • Handle email change and verification status explicitly.

Failure Modes

  • Issuer drift: accepting multiple issuers accidentally.
  • Key confusion: wrong JWKS for issuer/client.
  • Audience mismatch: token usable across services if not checked.
Token Revocation Strategies (What Actually Works) →