Skip to content

docs(skill): keep access-key creation out of agent sessions - #373

Closed
luvs01 wants to merge 9 commits into
devfrom
codex/propose-fix-for-agent-key-rotation-vulnerability
Closed

docs(skill): keep access-key creation out of agent sessions#373
luvs01 wants to merge 9 commits into
devfrom
codex/propose-fix-for-agent-key-rotation-vulnerability

Conversation

@luvs01

@luvs01 luvs01 commented Aug 30, 2026

Copy link
Copy Markdown
Owner

Motivation

  • An agent-facing recipe instructed models to run ocx access key create --json, which prints a one-time plaintext data-plane credential that can leak into model transcripts.
  • That disclosure allows an upstream, untrusted agent host to obtain a live admission key accepted by the server, creating an integrity/availability risk if the proxy is reachable beyond loopback.

Description

  • added a new "Secret-bearing commands" section to skills/ocx/SKILL.md that explicitly forbids running ocx access key create from an agent session and instructs the user to create keys in a separate terminal and only report the new key id.
  • updated skills/ocx/references/03_recipes.md to remove the agent-invokable ocx access key create step and to document a user-mediated rotation workflow that only removes the old key after the replacement is configured.
  • added a regression test in tests/skill-ocx.test.ts that asserts the skill contains the prohibition and that the recipes file does not include an executable ocx access key create invocation.

Testing

  • Ran the focused suite node_modules/.bin/bun test tests/skill-ocx.test.ts, which passed (12 tests, 0 failures).
  • Ran bun run typecheck and the repository bun run privacy:scan, both of which completed successfully.
  • The full bun run test suite was exercised but encountered unrelated environment/timing failures (lab sandbox / proxy-environment guards and a few timeouts); these failures are external to the documentation-only changes and do not affect the focused regression added here.

Codex Task

lidge-jun and others added 9 commits August 25, 2026 10:36
release: promote dev into main for v2.32.1
# Conflicts:
#	package.json
[WRONG BRANCH] merge dev into main for the v2.33.0 release
Promotes the dev integration line onto main. The resulting tree is byte-identical
to origin/dev, including package.json at 2.34.0.

The package.json conflict is resolved to dev's side, NOT to main's stale 2.33.0.
Earlier promotions (lidge-jun#2553, lidge-jun#2507) kept the target's version so the release bump
would land on its own "release: vX.Y.Z" commit. That is no longer legal: this very
delta adds tests/release-version-line.test.ts, which fails when the in-tree version
sits behind the highest release tag. With v2.34.0-preview.20260827 now published,
2.33.0 orders behind it, so a promotion carrying the stale line turns CI red on
every shard that runs the suite.

The consequence for the release step is that scripts/release.ts skips the bump
(release.ts:568, currentVersion === version), so v2.34.0 gets tagged on this merge
commit rather than on a separate release commit. The workflow creates the tag itself
after publishing and validates expected-sha against the checked-out commit, so the
tag still names exactly the audited tree.
[WRONG BRANCH] promote dev onto main for v2.34.0
[WRONG BRANCH] promote dev onto main for v2.35.0
@coderabbitai

coderabbitai Bot commented Aug 30, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Team

Run ID: 50862777-5978-4522-9019-c160e78e5463


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions

Copy link
Copy Markdown

Deterministic PR hygiene checks passed.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Aug 30, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-08-30T05:41:47.196101Z 6230c42 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Aug 30, 2026
@github-actions github-actions Bot changed the title docs(skill): keep access-key creation out of agent sessions [WRONG BRANCH] docs(skill): keep access-key creation out of agent sessions Aug 30, 2026
@github-actions

github-actions Bot commented Aug 30, 2026

Copy link
Copy Markdown

✅ READY

  • all PR quality gates passed.

Hygiene

Deterministic PR hygiene checks passed.

@github-actions
github-actions Bot marked this pull request as draft August 30, 2026 05:39

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6230c42908

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread skills/ocx/SKILL.md

## Secret-bearing commands

**Do not run `ocx access key create`.** Its one-time response contains the new plaintext

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Prohibit the access-key creation alias

When an agent discovers the advertised ocx api-key create alias, this prohibition does not cover it, and src/cli/dispatch.ts forwards that alias to the same handleAccessCommand(["key", ...]) path that returns the plaintext credential. The new regression test likewise checks only the canonical spelling, so the stated secret boundary remains bypassable; prohibit all access-key creation paths from agent sessions and test both command spellings.

AGENTS.md reference: AGENTS.md:L287-L293

Useful? React with 👍 / 👎.

@luvs01 luvs01 changed the title [WRONG BRANCH] docs(skill): keep access-key creation out of agent sessions docs(skill): keep access-key creation out of agent sessions Sep 3, 2026
@luvs01
luvs01 changed the base branch from main to dev September 3, 2026 06:23
@github-actions
github-actions Bot marked this pull request as ready for review September 3, 2026 06:33
@luvs01

luvs01 commented Sep 3, 2026

Copy link
Copy Markdown
Owner Author

Closing this personal-fork review path because lidge-jun#3324 fully covers the same access-key session-safety requirement and includes the reviewed alias, API, and rotation fixes.

@luvs01 luvs01 closed this Sep 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

aardvark codex documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants