Document ASGI-only requirement for BedrockAgentCoreContext
Les mainteneurs répondent en général sous 1 jour
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 2/5
- Temps estimé
- Une demi-journée
- Accessibilité débutants
- 45/100
- Type d'issue
- Documentation
- Clarté
- Plutôt claire
- Activité
- À l'abandon
- Stack technique
- python
- Domaine
- documentation, security
Piste de recherche
Commencez par src/bedrock_agentcore/runtime/context.py:16-21, puis examinez la configuration du contexte de requête dans src/bedrock_agentcore/runtime/app.py:299-347. Documentez que BedrockAgentCoreContext est destiné à être utilisé avec ASGI et expliquez le risque d’isolation de ContextVar avec WSGI ; mettez à jour le README ou l’emplacement principal de la documentation identifié lors de cet examen. Le travail est terminé lorsque les utilisateurs peuvent voir clairement l’exigence d’utiliser uniquement ASGI et la conséquence en matière de sécurité.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Summary
BedrockAgentCoreContext uses ContextVar for storing request-scoped sensitive data (workload access tokens, OAuth2 callback URLs, authorization headers). While this is safe for ASGI web frameworks, it creates a critical security vulnerability if used with WSGI frameworks.
Problem
ContextVar isolation behavior:
- ✅ ASGI frameworks (Starlette, FastAPI, Quart): Automatically isolated per async task (each HTTP request)
- ❌ WSGI frameworks (Flask, Django WSGI): NOT automatically isolated - threads are reused across requests
Security risk with WSGI:
# WSGI thread pool scenario
# Request A (Thread 1) → BedrockAgentCoreContext.set_workload_access_token("USER_A_TOKEN")
# Request B (Thread 1) → BedrockAgentCoreContext.get_workload_access_token()
# → Returns "USER_A_TOKEN" ❌ (LEAKED!)
This causes:
- Token leakage between requests
- Authorization bypass vulnerabilities
- Data access from one user by another
Current Status
The AgentCore SDK correctly uses Starlette (ASGI), making it safe. However, there's no documentation warning against using BedrockAgentCoreContext in non-ASGI environments.
Recommendation
Add documentation to explicitly state:
-
In
src/bedrock_agentcore/runtime/context.pydocstring:- BedrockAgentCoreContext is designed for ASGI web frameworks only
- Using with WSGI frameworks creates security vulnerabilities
- ContextVars rely on async task isolation, not thread isolation
-
In README or main documentation:
- Note that the SDK requires ASGI (already uses Starlette)
- If users want to integrate with Flask/WSGI, they need alternative approaches (Flask's
gobject, thread-local storage with manual cleanup)
-
Consider adding a runtime check (optional):
- Detect if running in WSGI context
- Emit warning about unsafe usage
References
- BedrockAgentCoreContext implementation:
src/bedrock_agentcore/runtime/context.py:16-21 - Context initialization in request handler:
src/bedrock_agentcore/runtime/app.py:299-347 - Python ContextVar documentation: https://docs.python.org/3/library/contextvars.html
Impact
- Severity: High (security vulnerability if misused)
- Likelihood: Low (SDK uses Starlette, but users might try to reuse context pattern)
- Action: Documentation update to prevent misuse
- Langage dominant
- Python
- Étoiles
- 786
- Forks
- 163
- Merge moyen
- 4 h
- PR mergées (30 j)
- 22
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Aucun modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de aws/bedrock-agentcore-sdk-python
-
bug high-severity
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
aws/bedrock-agentcore-sdk-python#752 ·
Les mainteneurs répondent en général sous 1 jour
-
OpenAIConverseConverter restores an empty history when one blob or text payload fails to parseOuvertebug
Difficulté 2/5 1-3 heures Accessibilité débutants 82/100
aws/bedrock-agentcore-sdk-python#751 · 1 réaction ·
Les mainteneurs répondent en général sous 1 jour
-
delete_all_long_term_memories_in_namespace deletes only the first 10 recordsPeut-être pris @Fire162 l’a pris il y a 18 jours. Ouvertebug high-severity
Difficulté 2/5 1-3 heures Accessibilité débutants 75/100
aws/bedrock-agentcore-sdk-python#727 ·
Les mainteneurs répondent en général sous 1 jour
-
MPP: credential is always sent in Authorization, ignoring header="Payment-Authorization" in the challengePeut-être pris @abhiramshaji-cyber l’a pris il y a 24 jours. Ouvertebug
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
aws/bedrock-agentcore-sdk-python#702 ·
Les mainteneurs répondent en général sous 1 jour
-
[Bug] update_message fails with parameter validation error when SessionMessage.message_id is a Strands positional integer indexPeut-être pris @citizen204 l’a pris il y a 144 jours. Ouverte
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
aws/bedrock-agentcore-sdk-python#556 ·
Les mainteneurs répondent en général sous 1 jour
Toutes les issues de aws/bedrock-agentcore-sdk-python
Issues similaires
-
Difficulté 1/5 Moins d'une heure Accessibilité débutants 88/100
snap-stanford/Biomni#380 ·
-
Difficulté 2/5 1-3 heures Accessibilité débutants 74/100
microsoft/playwright-python#3361 ·
Les mainteneurs répondent en général sous 1 jour
-
documentation priority: low size: S status: needs triage
Difficulté 2/5 1-3 heures Accessibilité débutants 74/100
cubrid-lab/sqlalchemy-cubrid#1397 ·
Les mainteneurs répondent en général sous 1 jour
-
documentation priority: low size: S status: needs triage
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
cubrid-lab/pycubrid#1307 ·
Les mainteneurs répondent en général sous 1 jour
-
[Bug]: Installer hides SSL certificate errors as bare URLError, and the suggested fix can't workOuvertebug
Difficulté 2/5 1-3 heures Accessibilité débutants 80/100
ShaftHQ/chaosengine-harness#143 ·
Les mainteneurs répondent en général sous 1 jour