Skip to content

Commit db8dc2c

Browse files
authored
Merge pull request #25547 from dvdksn/worktree-droid-oauth-docs
docs(sandboxes): note Cursor and Droid support OAuth login
1 parent 48e239b commit db8dc2c

1 file changed

Lines changed: 10 additions & 8 deletions

File tree

content/manuals/ai/sandboxes/security/credentials.md

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ value for the same service, the stored secret takes precedence.
2828
| --------------------------------------------------------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
2929
| [Stored secrets](#stored-secrets) (`sbx secret set`) | A value in your OS keychain, keyed by service | The default for any built-in or kit-declared service |
3030
| [Custom secrets](#custom-secrets) (`sbx secret set-custom`) | A value keyed to a domain and environment variable | The service model doesn't fit — the agent validates the variable's format, or the secret rides in a request body |
31-
| OAuth | A host-side sign-in flow; the token never enters the sandbox | The agent supports it, such as Claude Code, Codex, or Cursor |
31+
| OAuth | A host-side sign-in flow; the token never enters the sandbox | The agent supports it, such as Claude Code, Codex, Cursor, or Droid |
3232
| [Registry credentials](#registry-credentials) (`sbx secret set --registry`) | Authentication for pulling images and kits | Pulling templates or kits from a private registry |
3333

3434
For multi-provider agents (OpenCode, Docker Agent), the proxy selects
@@ -358,13 +358,15 @@ $ sbx secret rm my-sandbox --registry ghcr.io -f
358358
proxy-injected service credentials, which never enter the sandbox. Reserve
359359
them for sandboxes that need registry access, and prefer sandbox scope over
360360
global (`-g`) to limit exposure.
361-
- For Claude Code and Codex, OAuth is another secure option: the flow runs on
362-
the host, so the token is never exposed inside the sandbox. If you haven't
363-
stored a credential, both agents prompt you to authenticate before the
364-
sandbox launches — Codex prompts on the host from `sbx run codex`, and Claude
365-
Code prompts inside the agent. To authenticate ahead of time, run
366-
`sbx secret set -g openai --oauth` for Codex, or use `/login` inside Claude
367-
Code.
361+
- Several agents support OAuth as another secure option: the flow runs on the
362+
host, so the token is never exposed inside the sandbox. If you haven't stored
363+
a credential, the agent prompts you to authenticate — Codex prompts on the
364+
host from `sbx run codex`, while Claude Code, Cursor, and Droid prompt
365+
interactively inside the sandbox. To authenticate ahead of time, run
366+
`sbx secret set -g openai --oauth` for Codex or use `/login` inside Claude
367+
Code; Cursor and Droid have no ahead-of-time option, so their sign-in prompt
368+
appears when the agent starts. See the individual [agent pages](../agents/)
369+
for each agent's flow.
368370
- If you store credentials in 1Password, see
369371
[Sourcing credentials from 1Password](../workflows.md#sourcing-credentials-from-1password)
370372
for how to use `op read` and `op run` with `sbx`.

0 commit comments

Comments
 (0)