@langchain/langgraph-checkpoint-redis
Affected
- introduced
0, fixed1.0.2(semver)
Fixed versions
1.0.2
Fix
- Fixed version
1.0.2npm install @langchain/[email protected]
Advisory
Also known as: CVE-2026-27022
RediSearch Query Injection in @langchain/langgraph-checkpoint-redis
Summary
A query injection vulnerability exists in the @langchain/langgraph-checkpoint-redis package's filter handling. The RedisSaver and ShallowRedisSaver classes construct RediSearch queries by directly interpolating user-provided filter keys and values without proper escaping. RediSearch has special syntax characters that can modify query behavior, and when user-controlled data contains these characters, the query logic can be manipulated to bypass intended access controls.
Attack surface
The core vulnerability was in the list() methods of both RedisSaver and ShallowRedisSaver: these methods failed to escape RediSearch special characters in filter keys and values when constructing queries. When unescaped data containing RediSearch syntax was used, the injected operators were interpreted by RediSearch rather than treated as literal search values.
This escaping bug enabled the following attack vector:
| as an OR operator with specific precedence rules. A query like A B | C is interpreted as (A AND B) OR C. By injecting }) | (@thread_id:{* into a filter value, an attacker can append an OR clause that matches all threads, effectively bypassing the thread isolation constraint.The injected query (@thread_id:{legitimate-thread}) (@source:{x}) | (@thread_id:{*}) matches:
thread_id:legitimate-thread AND source:x, ORthread_idThe second clause matches all threads, bypassing thread isolation entirely.
Who is affected?
Applications are vulnerable if they:
getStateHistory() or checkpointer.list() with filter values derived from user input, HTTP parameters, or other untrusted sources.The most common attack vector is through API endpoints that expose filtering capabilities to end users, allowing them to search or filter their conversation history.
Impact
Attackers who control filter input can bypass thread isolation by injecting RediSearch OR operators to construct queries that match all threads regardless of the intended thread constraint. This enables access to checkpoint data from threads the attacker is not authorized to view.
Key severity factors:
Exploit example
import { RedisSaver } from "@langchain/langgraph-checkpoint-redis";
const saver = new RedisSaver({ /* redis config */ });
// Normal usage - should only see thread "user-123-thread"
const legitHistory = saver.list({
configurable: { thread_id: "user-123-thread" }
}, {
filter: { source: "loop" }
});
// Attacker crafts malicious filter value
const attackerFilter = {
source: "x}) | (@thread_id:{*" // Injects OR clause matching ALL threads
};
// This produces a query like:
// (@thread_id:{user-123-thread}) (@source:{x}) | (@thread_id:{*})
// Due to precedence, this matches ALL threads!
const stolenHistory = saver.list({
configurable: { thread_id: "user-123-thread" }
}, {
filter: attackerFilter
});
// stolenHistory now contains checkpoints from ALL threads - DATA LEAKED!
Security hardening changes
The 1.0.2 patch introduces the following changes:
escapeRediSearchTagValue() function properly escapes all RediSearch special characters (- . < > { } [ ] " ' : ; ! @ # $ % ^ & * ( ) + = ~ | \ ? /) by prefixing them with backslashes.Migration guide
No changes needed for most users
The fix is backward compatible. Existing code will work without modifications—filter values that previously worked will continue to work, with the added protection against injection:
import { RedisSaver } from "@langchain/langgraph-checkpoint-redis";
// Works exactly as before, now with injection protection
const history = saver.list(config, {
filter: { source: "loop" }
});
If you were relying on special characters
If your application intentionally used RediSearch syntax in filter values (unlikely but possible), be aware that these characters will now be escaped and treated as literals.
For applications with user-facing filters
No code changes required, but this is a good time to review your API design:
// Before: Vulnerable to injection
app.get("/history", async (req, res) => {
const history = await saver.list(config, {
filter: req.query.filter // User-controlled - was vulnerable
});
});
// After: Now safe, but consider validating allowed filter keys
app.get("/history", async (req, res) => {
const allowedKeys = ["source", "step"];
const sanitizedFilter = Object.fromEntries(
Object.entries(req.query.filter || {})
.filter(([key]) => allowedKeys.includes(key))
);
const history = await saver.list(config, {
filter: sanitizedFilter
});
});
> Recommendation: Even with the fix in place, consider validating that filter keys are from an allowed list as a defense-in-depth measure.
References
Medium Basis: The source's own band: MODERATE
0, fixed 1.0.2 (semver)1.0.2
1.0.2npm install @langchain/[email protected]Fix commands are the export's own generic commands. Ojuju never runs them. Check them against your setup first.
Check your own computer: guard packages check
Source: GitHub Advisory Database (reviewed advisories) · CC BY 4.0