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.
- checksums.yaml +4 -4
- data/.github/workflows/ci.yml +1 -1
- data/.github/workflows/claude-code-review.yml +1 -1
- data/.github/workflows/claude.yml +1 -1
- data/.github/workflows/code-smells.yml +2 -2
- data/.github/workflows/release-gem.yml +1 -1
- data/.github/workflows/ruby-lint.yml +1 -1
- data/.github/workflows/yardoc.yml +1 -1
- data/.rubocop_todo.yml +2 -2
- data/AGENTS.md +4 -2
- data/CHANGELOG.rst +792 -0
- data/Gemfile +3 -2
- data/Gemfile.lock +13 -8
- data/README.md +6 -0
- data/docs/README.md +4 -0
- data/docs/audits/2026-09-28-v2.12.0-code-audit.md +732 -0
- data/docs/audits/README.md +63 -0
- data/docs/guides/authentication.md +329 -0
- data/docs/guides/forwarded-authority.md +85 -5
- data/docs/guides/mcp.md +40 -4
- data/docs/guides/privacy.md +28 -2
- data/docs/guides/routing.md +76 -9
- data/docs/guides/testing-guide.md +146 -5
- data/docs/migrating/v2.3.0.md +13 -7
- data/docs/reference/authentication.md +70 -22
- data/examples/lambda_handlers/README.md +4 -4
- data/examples/lambda_handlers/handlers.rb +4 -5
- data/examples/lambda_handlers/routes +2 -2
- data/examples/mcp_demo/README.md +65 -27
- data/examples/mcp_demo/app.rb +8 -5
- data/examples/mcp_demo/config.ru +50 -3
- data/examples/mcp_demo/routes +10 -6
- data/examples/security_features/README.md +2 -2
- data/lib/otto/caddy_tls/localhost_guard.rb +6 -6
- data/lib/otto/caddy_tls/server.rb +8 -4
- data/lib/otto/core/configuration.rb +5 -3
- data/lib/otto/core/option_hash.rb +124 -0
- data/lib/otto/core/redacted_inspect.rb +149 -0
- data/lib/otto/core/router.rb +57 -34
- data/lib/otto/core.rb +2 -0
- data/lib/otto/env_keys.rb +30 -6
- data/lib/otto/logging_helpers.rb +1 -1
- data/lib/otto/mcp/auth/token.rb +12 -1
- data/lib/otto/mcp/protocol.rb +3 -3
- data/lib/otto/mcp/registry.rb +28 -2
- data/lib/otto/mcp/route_parser.rb +20 -8
- data/lib/otto/mcp/server.rb +17 -9
- data/lib/otto/privacy/config.rb +31 -14
- data/lib/otto/privacy/ip_privacy.rb +109 -3
- data/lib/otto/privacy/redacted_fingerprint.rb +8 -10
- data/lib/otto/request.rb +34 -0
- data/lib/otto/response.rb +5 -2
- data/lib/otto/route.rb +1 -1
- data/lib/otto/route_definition.rb +3 -2
- data/lib/otto/route_handlers/base.rb +1 -1
- data/lib/otto/route_handlers/logic_class.rb +86 -34
- data/lib/otto/security/authentication/route_auth_wrapper.rb +10 -3
- data/lib/otto/security/config.rb +703 -345
- data/lib/otto/security/configurator.rb +82 -45
- data/lib/otto/security/core.rb +4 -2
- data/lib/otto/security/csp/report_middleware.rb +17 -1
- data/lib/otto/security/csrf.rb +17 -2
- data/lib/otto/security/csrf_validation.rb +13 -7
- data/lib/otto/security/middleware/csrf_middleware.rb +203 -37
- data/lib/otto/security/middleware/ip_privacy_middleware.rb +129 -42
- data/lib/otto/security/rate_limiter.rb +8 -5
- data/lib/otto/security/trusted_proxy_config.rb +396 -0
- data/lib/otto/static.rb +70 -6
- data/lib/otto/testing.rb +148 -0
- data/lib/otto/utils.rb +166 -40
- data/lib/otto/version.rb +1 -1
- data/lib/otto.rb +44 -11
- 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.
|
|
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.
|
|
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.
|
|
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 (
|
|
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.
|
|
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.
|
|
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.
|
|
173
|
+
rubocop-thread_safety (0.8.0)
|
|
170
174
|
lint_roller (~> 1.1)
|
|
171
|
-
rubocop (~> 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.
|
|
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.
|
|
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
|
|