Buckets:

AnonymousSpottedToad/securityPatternsRecovery / ground_truth /java /limit_request_rate__pesitwizard_pesitwizard.json
download
raw
9.79 kB
{
"role_mappings": [
{
"patternRole": "Entity",
"entity": "",
"file": "",
"lines": "",
"notes": "The caller of the pesitwizard-server REST API (e.g. /api/v1/transfers) is outside the repo; no in-repo UI/SDK sends requests to the server's REST API (pesitwizard-client is a separate app with its own API and speaks PeSIT to the server). Tests ignored.",
"status": "missing",
"nodeId": null
},
{
"patternRole": "Enforcer",
"entity": "doFilterInternal",
"file": "pesitwizard-server/src/main/java/com/pesitwizard/server/security/RateLimitingFilter.java",
"lines": "61",
"notes": "doFilterInternal in RateLimitingFilter (OncePerRequestFilter, @Component @Order(1)) intercepts every non-whitelisted request, derives the client id (API key at :72 or IP via getClientIp at :86) and calls checkIpRateLimit (:87) / checkApiKeyRateLimit (:77); on block it returns without calling filterChain.doFilter. Caveat: bean is @ConditionalOnProperty pesit.security.rate-limiting.enabled=true with matchIfMissing=false, so it is opt-in (only rate-limit feature in repo).",
"status": "present",
"nodeId": null
},
{
"patternRole": "Limiter",
"entity": "tryConsume",
"file": "pesitwizard-server/src/main/java/com/pesitwizard/server/security/RateLimitingFilter.java",
"lines": "179",
"notes": "Reached from Enforcer via checkIpRateLimit (RateLimitingFilter.java:87 -> :136). tryConsume calls Bucket4j bucket.tryConsumeAndReturnRemaining(1) (:182) and returns true (allow) or writes HTTP 429 with Retry-After and returns false (block). The token-bucket arithmetic itself is Bucket4j library logic.",
"status": "present",
"nodeId": null
},
{
"patternRole": "HistoryProvider",
"entity": "checkIpRateLimit",
"file": "pesitwizard-server/src/main/java/com/pesitwizard/server/security/RateLimitingFilter.java",
"lines": "124",
"notes": "Called by doFilterInternal (RateLimitingFilter.java:87); looks up/creates the per-IP Bucket4j bucket in the in-memory ConcurrentHashMap ipBuckets (field :53) via compute (:128), refreshing lastAccess and evicting stale entries (evictStaleEntries :158). The bucket's remaining tokens are the request history; it is updated by the consume call in tryConsume (:182). API-key branch uses checkApiKeyRateLimit (:139) / apiKeyBuckets (:54); Redis options in RateLimitingProperties are unused.",
"status": "present",
"nodeId": null
},
{
"patternRole": "PolicyProvider",
"entity": "createIpBucket",
"file": "pesitwizard-server/src/main/java/com/pesitwizard/server/security/RateLimitingFilter.java",
"lines": "210",
"notes": "Invoked from checkIpRateLimit (RateLimitingFilter.java:134) when an IP has no bucket; builds the Bandwidth policy (capacity = requestsPerMinute*burstMultiplier, greedy refill per minute) from RateLimitingProperties (RateLimitingProperties.java:18,24; defaults 100/min, x2). For API keys createApiKeyBucket (:223) uses ApiKey.rateLimit per key.",
"status": "present",
"nodeId": null
},
{
"patternRole": "System",
"entity": "listTransfers",
"file": "pesitwizard-server/src/main/java/com/pesitwizard/server/controller/TransferController.java",
"lines": "57",
"notes": "After the Enforcer allows the request it calls filterChain.doFilter (RateLimitingFilter.java:91), reaching Spring MVC controllers; the filter is global (all non-whitelisted paths), so listTransfers (GET /api/v1/transfers) is cited as a representative protected handler.",
"status": "present",
"nodeId": null
}
],
"interaction_order": {
"available": true,
"language": "java",
"repo": "pesitwizard_pesitwizard",
"reason": "",
"entryRole": "Enforcer",
"entryRule": "behaviour",
"interactions": [
{
"rank": 1,
"interaction": "Enforcer \u2192 Limiter",
"from": "Enforcer",
"to": "Limiter",
"file": "pesitwizard-server/src/main/java/com/pesitwizard/server/security/RateLimitingFilter.java",
"line": 152,
"via": [
"com.pesitwizard.server.security.RateLimitingFilter.checkApiKeyRateLimit:boolean(com.pesitwizard.server.entity.ApiKey,jakarta.servlet.http.HttpServletResponse)"
],
"mechanism": "call",
"path": [
{
"caller": "com.pesitwizard.server.security.RateLimitingFilter.doFilterInternal:void(jakarta.servlet.http.HttpServletRequest,jakarta.servlet.http.HttpServletResponse,jakarta.servlet.FilterChain)",
"file": "pesitwizard-server/src/main/java/com/pesitwizard/server/security/RateLimitingFilter.java",
"line": 77,
"code": "checkApiKeyRateLimit(apiKeyEntity.get(), response)",
"callee": "com.pesitwizard.server.security.RateLimitingFilter.checkApiKeyRateLimit:boolean(com.pesitwizard.server.entity.ApiKey,jakarta.servlet.http.HttpServletResponse)",
"mechanism": "call"
},
{
"caller": "com.pesitwizard.server.security.RateLimitingFilter.checkApiKeyRateLimit:boolean(com.pesitwizard.server.entity.ApiKey,jakarta.servlet.http.HttpServletResponse)",
"file": "pesitwizard-server/src/main/java/com/pesitwizard/server/security/RateLimitingFilter.java",
"line": 152,
"code": "tryConsume(entry.bucket(), apiKey.getName(), \"API Key\", response)",
"callee": "com.pesitwizard.server.security.RateLimitingFilter.tryConsume:boolean(io.github.bucket4j.Bucket,java.lang.String,java.lang.String,jakarta.servlet.http.HttpServletResponse)",
"mechanism": "call"
}
],
"parent": ""
},
{
"rank": 2,
"interaction": "Enforcer \u2192 HistoryProvider",
"from": "Enforcer",
"to": "HistoryProvider",
"file": "pesitwizard-server/src/main/java/com/pesitwizard/server/security/RateLimitingFilter.java",
"line": 87,
"via": [],
"mechanism": "call",
"path": [
{
"caller": "com.pesitwizard.server.security.RateLimitingFilter.doFilterInternal:void(jakarta.servlet.http.HttpServletRequest,jakarta.servlet.http.HttpServletResponse,jakarta.servlet.FilterChain)",
"file": "pesitwizard-server/src/main/java/com/pesitwizard/server/security/RateLimitingFilter.java",
"line": 87,
"code": "checkIpRateLimit(clientIp, response)",
"callee": "com.pesitwizard.server.security.RateLimitingFilter.checkIpRateLimit:boolean(java.lang.String,jakarta.servlet.http.HttpServletResponse)",
"mechanism": "call"
}
],
"parent": ""
},
{
"rank": 3,
"interaction": "HistoryProvider \u2192 PolicyProvider",
"from": "HistoryProvider",
"to": "PolicyProvider",
"file": "pesitwizard-server/src/main/java/com/pesitwizard/server/security/RateLimitingFilter.java",
"line": 134,
"via": [
"com.pesitwizard.server.security.RateLimitingFilter.<lambda>1:java.lang.Object(java.lang.Object,java.lang.Object)"
],
"mechanism": "call",
"path": [
{
"caller": "com.pesitwizard.server.security.RateLimitingFilter.checkIpRateLimit:boolean(java.lang.String,jakarta.servlet.http.HttpServletResponse)",
"file": "pesitwizard-server/src/main/java/com/pesitwizard/server/security/RateLimitingFilter.java",
"line": 128,
"code": "",
"callee": "com.pesitwizard.server.security.RateLimitingFilter.<lambda>1:java.lang.Object(java.lang.Object,java.lang.Object)",
"mechanism": "route-registration"
},
{
"caller": "com.pesitwizard.server.security.RateLimitingFilter.<lambda>1:java.lang.Object(java.lang.Object,java.lang.Object)",
"file": "pesitwizard-server/src/main/java/com/pesitwizard/server/security/RateLimitingFilter.java",
"line": 134,
"code": "createIpBucket()",
"callee": "com.pesitwizard.server.security.RateLimitingFilter.createIpBucket:io.github.bucket4j.Bucket()",
"mechanism": "call"
}
],
"parent": "Enforcer \u2192 HistoryProvider"
},
{
"rank": 4,
"interaction": "HistoryProvider \u2192 Limiter",
"from": "HistoryProvider",
"to": "Limiter",
"file": "pesitwizard-server/src/main/java/com/pesitwizard/server/security/RateLimitingFilter.java",
"line": 136,
"via": [],
"mechanism": "call",
"path": [
{
"caller": "com.pesitwizard.server.security.RateLimitingFilter.checkIpRateLimit:boolean(java.lang.String,jakarta.servlet.http.HttpServletResponse)",
"file": "pesitwizard-server/src/main/java/com/pesitwizard/server/security/RateLimitingFilter.java",
"line": 136,
"code": "tryConsume(entry.bucket(), clientIp, \"IP\", response)",
"callee": "com.pesitwizard.server.security.RateLimitingFilter.tryConsume:boolean(io.github.bucket4j.Bucket,java.lang.String,java.lang.String,jakarta.servlet.http.HttpServletResponse)",
"mechanism": "call"
}
],
"parent": "Enforcer \u2192 HistoryProvider"
}
],
"anchoredRoles": [
{
"role": "Enforcer",
"kind": "METHOD"
},
{
"role": "HistoryProvider",
"kind": "METHOD"
},
{
"role": "Limiter",
"kind": "METHOD"
},
{
"role": "PolicyProvider",
"kind": "METHOD"
}
],
"skippedRoles": [
"Entity",
"System"
]
}
}

Xet Storage Details

Size:
9.79 kB
·
Xet hash:
8d7725cecdca5d9d7616621f740bfdfb416673cd4eb41a44153f94e49101efff

Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.