LangChain Reference home pageLangChain ReferenceLangChain Reference
  • GitHub
  • Main Docs
Deep Agents
LangChain
LangGraph
Integrations
LangSmith
  • Overview
  • Client
  • AsyncClient
  • Run Helpers
  • Run Trees
  • Evaluation
  • Schemas
  • Utilities
  • Wrappers
  • Anonymizer
  • Testing
  • Expect API
  • Middleware
  • Pytest Plugin
  • Deployment SDK
⌘I

LangChain Assistant

Ask a question to get started

Enter to send•Shift+Enter new line

Menu

OverviewClientAsyncClientRun HelpersRun TreesEvaluationSchemasUtilitiesWrappersAnonymizerTestingExpect APIMiddlewarePytest PluginDeployment SDK
Language
Theme
Pythonlangsmithsandbox_proxy_configaws_auth
Function●Since v0.8

aws_auth

Copy
aws_auth(
  *,
  access_key_id: SandboxProxySecret | None = None,
  secret_access_key: SandboxProxySecret | None

Used in Docs

  • Sandbox auth proxy
  • Sandbox mounts
View source on GitHub
=
None
,
role_arn
:
str
|
None
=
None
,
name
:
str
=
'aws'
,
enabled
:
bool
=
True
,
env_vars
:
Mapping
[
str
,
str
]
|
None
=
None
)
->
SandboxProxyRule

Parameters

NameTypeDescription
env_varsMapping[str, str] | None
Default:None

Build a sandbox proxy rule that signs AWS HTTPS requests.

The sandbox proxy keeps the real AWS credentials outside the sandbox and signs supported AWS requests with SigV4 on the sandbox's behalf. Provide either role_arn or both static credentials, supplied as workspace_secret or opaque values. IAM-role support must be enabled on the backend. LangSmith supplies the workspace External ID and renews credentials; clients must not provide temporary credentials or External IDs.

In proxy_config, a role uses its effective IAM permissions. In mount_config(auth=[...]), it is restricted to the configured S3 mounts. Role authentication is configured at sandbox creation, not through updates.

Plaintext environment variables set for every command in the sandbox while this rule is enabled, for tools that refuse to run unless a credential variable is present even though the proxy injects the real credential on the wire.