otto 2.11.0 → 2.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (73) hide show
  1. checksums.yaml +4 -4
  2. data/.github/workflows/ci.yml +1 -1
  3. data/.github/workflows/claude-code-review.yml +1 -1
  4. data/.github/workflows/claude.yml +1 -1
  5. data/.github/workflows/code-smells.yml +2 -2
  6. data/.github/workflows/release-gem.yml +1 -1
  7. data/.github/workflows/ruby-lint.yml +1 -1
  8. data/.github/workflows/yardoc.yml +1 -1
  9. data/.rubocop_todo.yml +2 -2
  10. data/AGENTS.md +4 -2
  11. data/CHANGELOG.rst +792 -0
  12. data/Gemfile +3 -2
  13. data/Gemfile.lock +13 -8
  14. data/README.md +6 -0
  15. data/docs/README.md +4 -0
  16. data/docs/audits/2026-09-28-v2.12.0-code-audit.md +732 -0
  17. data/docs/audits/README.md +63 -0
  18. data/docs/guides/authentication.md +329 -0
  19. data/docs/guides/forwarded-authority.md +85 -5
  20. data/docs/guides/mcp.md +40 -4
  21. data/docs/guides/privacy.md +28 -2
  22. data/docs/guides/routing.md +76 -9
  23. data/docs/guides/testing-guide.md +146 -5
  24. data/docs/migrating/v2.3.0.md +13 -7
  25. data/docs/reference/authentication.md +70 -22
  26. data/examples/lambda_handlers/README.md +4 -4
  27. data/examples/lambda_handlers/handlers.rb +4 -5
  28. data/examples/lambda_handlers/routes +2 -2
  29. data/examples/mcp_demo/README.md +65 -27
  30. data/examples/mcp_demo/app.rb +8 -5
  31. data/examples/mcp_demo/config.ru +50 -3
  32. data/examples/mcp_demo/routes +10 -6
  33. data/examples/security_features/README.md +2 -2
  34. data/lib/otto/caddy_tls/localhost_guard.rb +6 -6
  35. data/lib/otto/caddy_tls/server.rb +8 -4
  36. data/lib/otto/core/configuration.rb +5 -3
  37. data/lib/otto/core/option_hash.rb +124 -0
  38. data/lib/otto/core/redacted_inspect.rb +149 -0
  39. data/lib/otto/core/router.rb +57 -34
  40. data/lib/otto/core.rb +2 -0
  41. data/lib/otto/env_keys.rb +30 -6
  42. data/lib/otto/logging_helpers.rb +1 -1
  43. data/lib/otto/mcp/auth/token.rb +12 -1
  44. data/lib/otto/mcp/protocol.rb +3 -3
  45. data/lib/otto/mcp/registry.rb +28 -2
  46. data/lib/otto/mcp/route_parser.rb +20 -8
  47. data/lib/otto/mcp/server.rb +17 -9
  48. data/lib/otto/privacy/config.rb +31 -14
  49. data/lib/otto/privacy/ip_privacy.rb +109 -3
  50. data/lib/otto/privacy/redacted_fingerprint.rb +8 -10
  51. data/lib/otto/request.rb +34 -0
  52. data/lib/otto/response.rb +5 -2
  53. data/lib/otto/route.rb +1 -1
  54. data/lib/otto/route_definition.rb +3 -2
  55. data/lib/otto/route_handlers/base.rb +1 -1
  56. data/lib/otto/route_handlers/logic_class.rb +86 -34
  57. data/lib/otto/security/authentication/route_auth_wrapper.rb +10 -3
  58. data/lib/otto/security/config.rb +703 -345
  59. data/lib/otto/security/configurator.rb +82 -45
  60. data/lib/otto/security/core.rb +4 -2
  61. data/lib/otto/security/csp/report_middleware.rb +17 -1
  62. data/lib/otto/security/csrf.rb +17 -2
  63. data/lib/otto/security/csrf_validation.rb +13 -7
  64. data/lib/otto/security/middleware/csrf_middleware.rb +203 -37
  65. data/lib/otto/security/middleware/ip_privacy_middleware.rb +129 -42
  66. data/lib/otto/security/rate_limiter.rb +8 -5
  67. data/lib/otto/security/trusted_proxy_config.rb +396 -0
  68. data/lib/otto/static.rb +70 -6
  69. data/lib/otto/testing.rb +148 -0
  70. data/lib/otto/utils.rb +166 -40
  71. data/lib/otto/version.rb +1 -1
  72. data/lib/otto.rb +44 -11
  73. metadata +8 -2
data/Gemfile CHANGED
@@ -10,6 +10,7 @@ source 'https://rubygems.org'
10
10
  gemspec
11
11
 
12
12
  group :test do
13
+ gem 'rack-session', '~> 2.1' # Real session stores for the CSRF binding specs
13
14
  gem 'rack-test'
14
15
  gem 'rspec', '~> 3.13'
15
16
  gem 'user_agent_parser', '~> 2.18' # Validate anonymized UAs preserve semantic info
@@ -19,7 +20,7 @@ end
19
20
  group :development, :test, optional: true do
20
21
  # Keep gems that need to be in both environments
21
22
  gem 'json_schemer', '~> 2.0'
22
- gem 'maxmind-db', '~> 1.2' # Optional geo DB reader; exercised by geo specs
23
+ gem 'maxmind-db', '~> 1.5' # Optional geo DB reader; exercised by geo specs
23
24
  gem 'rack-attack', '~> 6.7'
24
25
  gem 'reek', '~> 6.5'
25
26
  end
@@ -29,7 +30,7 @@ group :development do
29
30
  gem 'debug'
30
31
  gem 'rackup' # Used to boot examples/ apps; not needed by specs
31
32
  gem 'rake', '~> 13.4', require: false # Provides `rake release` for release-gem.yml
32
- gem 'rubocop', '~> 1.90.0', require: false
33
+ gem 'rubocop', '~> 1.91.0', require: false
33
34
  gem 'rubocop-performance', require: false
34
35
  gem 'rubocop-rspec', require: false
35
36
  gem 'rubocop-thread_safety', require: false
data/Gemfile.lock CHANGED
@@ -1,7 +1,7 @@
1
1
  PATH
2
2
  remote: .
3
3
  specs:
4
- otto (2.11.0)
4
+ otto (2.13.0)
5
5
  concurrent-ruby (~> 1.3, < 2.0)
6
6
  logger (~> 1, < 2.0)
7
7
  loofah (~> 2.20)
@@ -11,6 +11,7 @@ GEM
11
11
  remote: https://rubygems.org/
12
12
  specs:
13
13
  ast (2.4.3)
14
+ base64 (0.2.0)
14
15
  benchmark (0.5.0)
15
16
  bigdecimal (4.1.1)
16
17
  concurrent-ruby (1.3.8)
@@ -57,7 +58,7 @@ GEM
57
58
  prism (>= 1.3.0)
58
59
  rdoc (>= 4.0.0)
59
60
  reline (>= 0.4.2)
60
- json (2.21.2)
61
+ json (3.0.2)
61
62
  json_schemer (2.5.0)
62
63
  bigdecimal
63
64
  hana (~> 1.3)
@@ -71,7 +72,7 @@ GEM
71
72
  loofah (2.25.2)
72
73
  crass (~> 1.0.2)
73
74
  nokogiri (>= 1.12.0)
74
- maxmind-db (1.4.0)
75
+ maxmind-db (1.5.0)
75
76
  minitest (5.26.0)
76
77
  nokogiri (1.19.4-aarch64-linux-gnu)
77
78
  racc (~> 1.4)
@@ -107,6 +108,9 @@ GEM
107
108
  rack (3.2.7)
108
109
  rack-attack (6.8.0)
109
110
  rack (>= 1.0, < 4)
111
+ rack-session (2.1.2)
112
+ base64 (>= 0.1.0)
113
+ rack (>= 3.0.0)
110
114
  rack-test (2.2.0)
111
115
  rack (>= 1.3)
112
116
  rackup (2.3.1)
@@ -144,7 +148,7 @@ GEM
144
148
  diff-lcs (>= 1.2.0, < 2.0)
145
149
  rspec-support (~> 3.13.0)
146
150
  rspec-support (3.13.7)
147
- rubocop (1.90.0)
151
+ rubocop (1.91.0)
148
152
  json (>= 2.3)
149
153
  language_server-protocol (~> 3.17.0.2)
150
154
  lint_roller (~> 1.1.0)
@@ -166,9 +170,9 @@ GEM
166
170
  lint_roller (~> 1.1)
167
171
  regexp_parser (>= 2.0)
168
172
  rubocop (~> 1.86, >= 1.86.2)
169
- rubocop-thread_safety (0.7.3)
173
+ rubocop-thread_safety (0.8.0)
170
174
  lint_roller (~> 1.1)
171
- rubocop (~> 1.72, >= 1.72.1)
175
+ rubocop (~> 1.89)
172
176
  rubocop-ast (>= 1.44.0, < 2.0)
173
177
  ruby-lsp (0.26.11)
174
178
  language_server-protocol (~> 3.17.0)
@@ -215,15 +219,16 @@ DEPENDENCIES
215
219
  debug
216
220
  json_schemer (~> 2.0)
217
221
  kramdown
218
- maxmind-db (~> 1.2)
222
+ maxmind-db (~> 1.5)
219
223
  otto!
220
224
  rack-attack (~> 6.7)
225
+ rack-session (~> 2.1)
221
226
  rack-test
222
227
  rackup
223
228
  rake (~> 13.4)
224
229
  reek (~> 6.5)
225
230
  rspec (~> 3.13)
226
- rubocop (~> 1.90.0)
231
+ rubocop (~> 1.91.0)
227
232
  rubocop-performance
228
233
  rubocop-rspec
229
234
  rubocop-thread_safety
data/README.md CHANGED
@@ -278,6 +278,12 @@ middleware, so browsers can POST reports without a CSRF token — regardless of
278
278
  order you enable security features in. A throwing callback can never break the
279
279
  receiver; it still answers `204`.
280
280
 
281
+ The report path is the site-absolute path the browser POSTs to. When Otto is
282
+ mounted under a sub-path (`map '/api' { run otto }`), include the prefix:
283
+ `enable_csp_reporting!("/api/_/csp-report")`. The receiver matches it against
284
+ `SCRIPT_NAME` + `PATH_INFO`, so the same value works in the header and in the
285
+ receiver.
286
+
281
287
  Modern browsers (Chrome) have deprecated `report-uri` in favour of the Reporting
282
288
  API. Pass `endpoint_url:` — an **absolute** URL whose path is the report path —
283
289
  to also emit a `report-to` directive and a `Reporting-Endpoints` response header,
data/docs/README.md CHANGED
@@ -87,6 +87,7 @@ docs/
87
87
  │ └── runtime-and-dependency-security.md
88
88
  ├── migrating/ # release-specific upgrade guides
89
89
  ├── adr/ # accepted architecture decision records
90
+ ├── audits/ # point-in-time code audits; leads, not contracts
90
91
  └── maintainers/
91
92
  └── investigations/ # local working notes; untracked by design
92
93
  ```
@@ -111,6 +112,9 @@ docs/
111
112
  to infer the current contract from a proposal.
112
113
  - **Maintainer investigations** preserve unfinished exploration separately from
113
114
  accepted decisions and application documentation.
115
+ - **Audits** record a review of the code at a named commit, with the follow-up
116
+ pull request for each finding. They are leads for maintainers and do not
117
+ define behavior; see [audits](audits/README.md).
114
118
 
115
119
  ## Migration plan for the current directory
116
120