Skip to content

docs: define the trusted-local Codex Security threat model - #61

Merged
mldangelo-oai merged 7 commits into
mainfrom
mdangelo/codex/trusted-local-security-policy-20260728
Jul 29, 2026
Merged

docs: define the trusted-local Codex Security threat model#61
mldangelo-oai merged 7 commits into
mainfrom
mdangelo/codex/trusted-local-security-policy-20260728

Conversation

@mldangelo-oai

@mldangelo-oai mldangelo-oai commented Jul 29, 2026

Copy link
Copy Markdown
Collaborator

Summary

Codex Security runs with your local permissions. This PR explains the practical security model: scan only repositories you trust and either own or are authorized to assess.

It also makes the scanner's behavior clear:

  • Scans use the codex_security_scan filesystem profile and approvalPolicy: "never".
  • --codex and codexOverrides do not make that profile or approval policy more restrictive.
  • Local workbench processes can inherit other credentials from your environment.
  • The scanner must use the target and output paths you authorize and report its actual coverage.

Why

Permission to assess a repository is not the same as trusting it. Configuration settings are not security guarantees when the scan does not apply them. Users should be able to see which actions and data flows are authorized before starting a scan.

Scope

The PR changes only:

  • SECURITY.md
  • sdk/typescript/README.md

It does not change skills, scanner behavior, or runtime configuration.

Validation

  • 385 tests passed; 3 expected skips.
  • Full Markdown formatting and SDK type checks passed.
  • Generated models and the production TypeScript build passed.
  • The packed npm artifact passed the public SDK, installed CLI, and bundled-plugin integrity checks.
  • The PR contains only the two documentation files listed above.

@mldangelo-oai
mldangelo-oai requested a review from ianw-oai July 29, 2026 05:21
@mldangelo-oai
mldangelo-oai marked this pull request as ready for review July 29, 2026 06:09

@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: 01e3cdb4da

ℹ️ 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 SECURITY.md Outdated
Comment thread sdk/typescript/README.md Outdated
ianw-oai
ianw-oai previously approved these changes Jul 29, 2026

@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: ea18cb11a4

ℹ️ 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 SECURITY.md Outdated
Comment thread SECURITY.md Outdated
@mldangelo-oai
mldangelo-oai merged commit 010ccaa into main Jul 29, 2026
4 checks passed
@mldangelo-oai
mldangelo-oai deleted the mdangelo/codex/trusted-local-security-policy-20260728 branch July 29, 2026 20:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants