Document ASGI-only requirement for BedrockAgentCoreContext
Mantenedores costumam responder em até 1 dia
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 2/5
- Tempo estimado
- Meio dia
- Facilidade para iniciantes
- 45/100
- Tipo de issue
- Documentação
- Clareza
- Razoavelmente clara
- Status de atividade
- Estagnada
- Stack de tecnologia
- python
- Domínio
- documentation, security
Direção de pesquisa
Comece por src/bedrock_agentcore/runtime/context.py:16-21 e depois revise a configuração do contexto da requisição em src/bedrock_agentcore/runtime/app.py:299-347. Documente que BedrockAgentCoreContext foi projetado para uso com ASGI e explique o risco de isolamento de ContextVar com WSGI; atualize o README ou o local principal da documentação identificado durante essa revisão. Considera-se concluído quando os usuários puderem ver claramente o requisito de usar somente ASGI e a consequência de segurança.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
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
- Linguagem predominante
- Python
- Estrelas
- 786
- Forks
- 163
- Merge médio
- 4h
- PRs com merge (30d)
- 22
Preparar o ambiente
- Sem Dockerfile nem arquivo Docker Compose
- Sem modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de aws/bedrock-agentcore-sdk-python
-
bug high-severity
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
aws/bedrock-agentcore-sdk-python#752 ·
Mantenedores costumam responder em até 1 dia
-
OpenAIConverseConverter restores an empty history when one blob or text payload fails to parseAbertabug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 82/100
aws/bedrock-agentcore-sdk-python#751 · 1 reação ·
Mantenedores costumam responder em até 1 dia
-
delete_all_long_term_memories_in_namespace deletes only the first 10 recordsTalvez já em andamento @Fire162 assumiu há 18 dias. Abertabug high-severity
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 75/100
aws/bedrock-agentcore-sdk-python#727 ·
Mantenedores costumam responder em até 1 dia
-
MPP: credential is always sent in Authorization, ignoring header="Payment-Authorization" in the challengeTalvez já em andamento @abhiramshaji-cyber assumiu há 24 dias. Abertabug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
aws/bedrock-agentcore-sdk-python#702 ·
Mantenedores costumam responder em até 1 dia
-
[Bug] update_message fails with parameter validation error when SessionMessage.message_id is a Strands positional integer indexTalvez já em andamento @citizen204 assumiu há 144 dias. Aberta
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
aws/bedrock-agentcore-sdk-python#556 ·
Mantenedores costumam responder em até 1 dia
Todas as issues de aws/bedrock-agentcore-sdk-python
Issues semelhantes
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 88/100
snap-stanford/Biomni#380 ·
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 74/100
microsoft/playwright-python#3361 ·
Mantenedores costumam responder em até 1 dia
-
documentation priority: low size: S status: needs triage
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 74/100
cubrid-lab/sqlalchemy-cubrid#1397 ·
Mantenedores costumam responder em até 1 dia
-
documentation priority: low size: S status: needs triage
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
cubrid-lab/pycubrid#1307 ·
Mantenedores costumam responder em até 1 dia
-
[Bug]: Installer hides SSL certificate errors as bare URLError, and the suggested fix can't workAbertabug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 80/100
ShaftHQ/chaosengine-harness#143 ·
Mantenedores costumam responder em até 1 dia