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
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: b8303453d265fcf2d5b0fa0754aafdbdb3e24eb89be9dc5a7b5611b4f2bcc699
4
- data.tar.gz: 2081706f65a3475f95555d96547841691f906b015f8b012739abc7804923fc76
3
+ metadata.gz: f334234ef3328224bcb76dec2e65c643b22f31b817284fdc263aef2b7ba14a52
4
+ data.tar.gz: ce8d4ff3b996533d29d400af7358e7b540db7a052f23a6cfeea4a746611b8668
5
5
  SHA512:
6
- metadata.gz: 75c496ee29c9c4ec0b05a8effda77e4e1dafc02080fb341a2320313011437f2b0bc0511ad6ca7d1b53928d6f75130693c974c72ed053aa35e5c6d16f60af0a5e
7
- data.tar.gz: 9d9615efa73c7ebafafe7f7e1eb3e098f8c07f3200ac62882c52c39954087c73053fc9574beda1b1e11ecc836e0b9bacb70fe267c90fa92600531ef14fca1b63
6
+ metadata.gz: bbaf6ac504ec1a74aa3fbd6b0172083fd93a2c480f5e67c8b97ab0925844dc6516ad4d20a8f91dd9247c6745f0d178996e4894e0256bbee2f15930d12090f8b6
7
+ data.tar.gz: 538d01dca1035d7b3beb2d4503e372a3f1aab9b2a265713323f555c7522f5ea8c321173346b4676ca7deda219e0cf00071d346283804b745958cb893b707c301
@@ -74,7 +74,7 @@ jobs:
74
74
  steps:
75
75
  - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
76
76
  - name: Set up Ruby
77
- uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1.321.0
77
+ uses: ruby/setup-ruby@762794c140bbeda0f1224786aa33b4b46783a6c1 # v1.326.0
78
78
  continue-on-error: ${{ matrix.experimental }}
79
79
  with:
80
80
  ruby-version: ${{ matrix.ruby }}
@@ -61,7 +61,7 @@ jobs:
61
61
 
62
62
  - name: Run Claude Code Review
63
63
  id: claude-review
64
- uses: anthropics/claude-code-action@19dda84776b3518d98b8798e591daee763049ed3 # v1.0.220
64
+ uses: anthropics/claude-code-action@8cf3482550831fb35a4fc3fbf7ca139cf8028b4c # v1.0.233
65
65
  with:
66
66
  claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
67
67
 
@@ -32,7 +32,7 @@ jobs:
32
32
 
33
33
  - name: Run Claude Code
34
34
  id: claude
35
- uses: anthropics/claude-code-action@19dda84776b3518d98b8798e591daee763049ed3 # v1.0.220
35
+ uses: anthropics/claude-code-action@8cf3482550831fb35a4fc3fbf7ca139cf8028b4c # v1.0.233
36
36
  with:
37
37
  claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
38
38
 
@@ -24,7 +24,7 @@ jobs:
24
24
  uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
25
25
 
26
26
  - name: Set up Ruby
27
- uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1.321.0
27
+ uses: ruby/setup-ruby@762794c140bbeda0f1224786aa33b4b46783a6c1 # v1.326.0
28
28
  with:
29
29
  ruby-version: 3.4
30
30
 
@@ -91,7 +91,7 @@ jobs:
91
91
  uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
92
92
 
93
93
  - name: Set up Ruby
94
- uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1.321.0
94
+ uses: ruby/setup-ruby@762794c140bbeda0f1224786aa33b4b46783a6c1 # v1.326.0
95
95
  with:
96
96
  ruby-version: 3.4
97
97
  bundler-cache: true
@@ -139,7 +139,7 @@ jobs:
139
139
  persist-credentials: false
140
140
 
141
141
  - name: Set up Ruby
142
- uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1.321.0
142
+ uses: ruby/setup-ruby@762794c140bbeda0f1224786aa33b4b46783a6c1 # v1.326.0
143
143
  with:
144
144
  bundler-cache: true
145
145
  # Pinned to 3.3 (oldest non-experimental Ruby in the CI matrix).
@@ -46,7 +46,7 @@ jobs:
46
46
  - name: Checkout code
47
47
  uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
48
48
 
49
- - uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1.321.0
49
+ - uses: ruby/setup-ruby@762794c140bbeda0f1224786aa33b4b46783a6c1 # v1.326.0
50
50
  with:
51
51
  ruby-version: ${{ matrix.ruby }}
52
52
  bundler-cache: true
@@ -47,7 +47,7 @@ jobs:
47
47
  fetch-depth: 0
48
48
 
49
49
  - name: Set up Ruby environment
50
- uses: ruby/setup-ruby@95ef2b042f9d7a56d8268cba8559e2842e2ad01b # v1.321.0
50
+ uses: ruby/setup-ruby@762794c140bbeda0f1224786aa33b4b46783a6c1 # v1.326.0
51
51
  with:
52
52
  ruby-version: '3.4'
53
53
  bundler-cache: true
data/.rubocop_todo.yml CHANGED
@@ -412,10 +412,10 @@ Metrics/ModuleLength:
412
412
  Exclude:
413
413
  - 'lib/otto/design_system.rb'
414
414
 
415
- # Offense count: 4
415
+ # Offense count: 6
416
416
  # Configuration parameters: CountKeywordArgs, MaxOptionalParameters.
417
417
  Metrics/ParameterLists:
418
- Max: 11
418
+ Max: 7
419
419
 
420
420
  # Offense count: 46
421
421
  # Configuration parameters: AllowedMethods, AllowedPatterns.
data/AGENTS.md CHANGED
@@ -112,8 +112,10 @@ GET /api/data DataLogic#show auth=session,apikey,oauth
112
112
  ```
113
113
 
114
114
  - Strategies execute left-to-right
115
- - First success wins (remaining strategies skipped)
116
- - Returns 401 only if all strategies fail
115
+ - The first authenticated success (a result with a user) wins; remaining strategies are skipped
116
+ - An anonymous success (no user, e.g. `noauth`) is held as a fallback while the chain continues, and wins only if the chain completes without an authenticated success or a terminal failure
117
+ - A terminal failure (explicit credentials rejected, e.g. a bad API key) halts the chain; the fallback does not rescue it
118
+ - A failed chain returns 403 if any strategy returned an `AuthorizationFailure`, else 401 for JSON (`response=json` or `Accept: application/json`) and a 302 to the login path otherwise
117
119
  - Put fastest/most-common strategies first
118
120
 
119
121
  ### Two-Layer Authorization