1# Improving the threat model1# Improve the Cloud threat model
2 2
3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.3> For the complete documentation index, see [llms.txt](https://learn.chatgpt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to the page URL.
4 4
5Review and update the threat model for a repository monitored by Codex Security Cloud.5Update a monitored repository's threat model when the generated version misses
6security assumptions or deployment context. This guide applies to Codex
7Security Cloud. For local plugin policy, see [Configure the
8scan](https://learn.chatgpt.com/docs/security/plugin/scans#configure-the-scan).
6 9
7## What a threat model is10## What a threat model is
8 11
9A threat model is a short security summary of how your repository works. Codex Security creates the first draft from the code and uses it to guide future commit scans and prioritize findings.12A threat model is a short security summary of how your repository works. Codex Security creates the first draft from the code and uses it to guide future commit scans and prioritize findings.
10 13
11A useful threat model calls out:14A threat model describes:
12 15
13- entry points and untrusted inputs16- Entry points and who can supply input to them
14- trust boundaries and auth assumptions17- Trust boundaries and authentication or authorization assumptions
15- sensitive data paths or privileged actions18- Sensitive data and privileged actions
16- the areas your team wants reviewed first19- Areas that need particular attention
17 20
18For example:21For example:
19 22
20> Public API for account changes. Accepts JSON requests and file uploads. Uses an internal auth service for identity checks and writes billing changes through an internal service. Focus review on auth checks, upload parsing, and service-to-service trust boundaries.23> The public account API accepts authenticated users' JSON requests and file
24> uploads. Users may change only accounts in their own tenant. The identity
25> service authenticates the caller, but each handler must check tenant access.
26> Billing changes go through a privileged internal service. Prioritize missing
27> tenant checks and upload paths that can reach that service.
21 28
22## Improving and revisiting the threat model29Identify uncertain assumptions. For example, don't describe an endpoint
30as internal-only unless that is true of the deployment you want assessed.
23 31
24Update the threat model when your architecture or priorities change, or when findings miss the areas you care about.32## Edit the threat model
25
26### Where to edit
27 33
281. Open the Codex Security Cloud plugin. See [Cloud setup](https://learn.chatgpt.com/docs/security/setup)341. Open the Codex Security Cloud plugin. See [Cloud setup](https://learn.chatgpt.com/docs/security/setup)
29 if you haven't installed it or configured commit monitoring.35 if you haven't installed it or configured commit monitoring.
302. Open **Repositories** and select the monitored repository.362. Open **Repositories** and select the monitored repository.
313. Open **Monitoring settings**.373. Open **Monitoring settings**.
324. Under **Project context**, edit **Threat model**, then select **Save**.384. Edit **Threat model**, then select **Save**.
33 39
34Changes apply to future scans.40Changes apply to future scans.
35 41
36## Related docs42Revisit the model after changes to authentication, tenant boundaries, or exposed
37 43services. Keep facts about the deployment separate from priorities for the scan.
38- [Codex Security Cloud setup](https://learn.chatgpt.com/docs/security/setup) covers repository setup and findings review.
39- [Codex Security](https://learn.chatgpt.com/docs/security) gives the product overview.
40- [Codex Security Cloud FAQ](https://learn.chatgpt.com/docs/security/faq) covers common cloud questions.