30 Days Gen AI Risk Trial -Start Now
Skip to main content

Developer data protection

  • OpenAI

Review Codex repository access by location

Separate local filesystem access from hosted repository access. Local Codex clients operate within the device’s effective permissions and configuration; Codex cloud uses a connected source system and a hosted checkout. Workspace access, repository grants and data handling are distinct decisions. Record the identities, repositories and execution locations actually approved.

For Enterprise AI and engineering-platform administrators

Aona field notesD12
Repository access
Local files or hosted checkout?

Identify the authorisation boundary before extending access.

Illustrative access paths and blank observations. No repository grant or product test is performed.

01

Map the local repository path

For a local CLI or IDE client, identify the machine, operating-system account, workspace roots and effective permissions. A company repository may already be present on the device; that does not mean every local file is relevant to the task or approved for model context.

Record the permitted repository and task alongside the local control configuration. Keep credentials and private file contents out of the access worksheet. Use the separate local-secret guide for file-read and inherited-environment tests rather than making a repository-access review depend on real sensitive data.

Source context: OpenAI: Agent approvals and security

02

Map the hosted source-system grant

OpenAI’s enterprise setup guidance treats cloud access, the source-system integration, repository permissions and environment configuration as separate steps. Limit the source-system grant to the intended repositories and audience. A workspace seat is not an override of the connected repository’s permissions.

Codex cloud checks out a selected repository branch or commit into a hosted environment. Record the source-system identity and grant, the selected repository and the environment owner. The question is who can cause which code to be made available in that environment, not merely whether the product is enabled.

Source context: OpenAI: Enterprise admin setup · OpenAI: Cloud environments

03

Compare the two paths explicitly

Use a two-lane map so that a local approval is not silently reused for a hosted checkout. The local lane begins with files available on the device. The cloud lane begins with the connected source-system grant. Both can lead to code entering model context, but their access, administration and retained-record questions differ.

If a task moves between clients or locations, review the destination boundary before moving restricted material. A screenshot of a repository name is not enough: record the actual authorisation and the owner who can change it.

Compare the two paths explicitly
BoundaryLocal clientHosted cloud task
Code sourceLocal accessible workspaceConnected repository checkout
Primary access evidenceDevice identity, roots and permissionsSource-system integration and grant
Execution ownerDevice/client administratorCloud environment administrator
Data handlingClient/provider and local recordsHosted environment and applicable workspace terms

04

Record the records created by the task

Identify the relevant conversation, task artefacts and source-system records. OpenAI’s administrative guidance notes that connected services retain their own access, logging and retention requirements. A task’s workspace policy should not be treated as deletion or permission evidence for every external system.

Keep setup secrets and agent-phase variables out of this worksheet’s detailed procedure; they have their own guide. Here, record the environment owner and whether its data-handling review is complete. Unknown retention or access fields should stay unresolved rather than being filled from a different client’s settings.

Source context: OpenAI: Enterprise admin setup · OpenAI: Enterprise Work admin FAQ

05

Approve and periodically recheck the grant

Test the intended access with a representative authorised user and a synthetic repository or otherwise approved non-sensitive code. Confirm the expected repository is available and unrelated repositories are not part of the grant. Do not broaden access simply to make the test succeed.

Close with a named audience, repository scope, location, purpose and owner. Recheck after integration, group membership, repository ownership or environment changes. Record access removal and retained-data review separately when a tool or user is retired; revoking a grant is not proof that all earlier copies were deleted.

Source context: OpenAI: Enterprise admin setup

Put it into practice

Local and cloud repository-access worksheet

Record where code comes from, which identity authorises access and who owns the resulting records.

Illustrative access paths and blank observations. No repository grant or product test is performed.

Two repository access paths
01

Local path

Device identity → accessible workspace → local client

Review roots and permissions

02

Hosted path

Source-system grant → selected checkout → cloud environment

Review repository and audience

03

Shared review

Code context → model handling and task records

Confirm the applicable terms

Local and cloud repository-access worksheet
PathAuthorisation to verifyObservation
Local workspaceDevice identity and effective rootsUntested
Hosted checkoutSource-system grant and selected repositoryUntested
Task recordsApplicable workspace/provider handlingUnreviewed
External source systemIts own access and retained recordsUnreviewed

Work through your review

Use the checks to organise the evidence you need. Your selections stay in this tab.

0 of 3 reviewed

Example files for this task

Keep the source material and the instructions together. You can also download the complete worksheet or matrix as CSV.

README.mdInspect
# Codex repository-access review

This pack creates no repository, grant, cloud environment or network call. Use synthetic repository labels until the responsible administrator records approved non-secret details.

Complete local-cloud-access.csv and access-decision.md. Use a representative authorised user to verify any actual grant through the organisation’s normal process. Do not paste tokens or broaden repository access to fill a worksheet row. Setup/agent-phase secrets are reviewed separately in D16.

## Guide and sources

Canonical guide: https://aona.ai/resources/guides/codex-local-cloud-repository-access/
Source review: 2026-09-21
- OpenAI: Agent approvals and security: https://learn.chatgpt.com/docs/agent-approvals-security
- OpenAI: Enterprise admin setup: https://learn.chatgpt.com/docs/enterprise/admin-setup
- OpenAI: Cloud environments: https://learn.chatgpt.com/docs/environments/cloud-environment
- OpenAI: Enterprise Work admin FAQ: https://learn.chatgpt.com/docs/enterprise/work-admin-faq
Download README.md
local-cloud-access.csvInspect
boundary,local_path,cloud_path,evidence,owner,status
Identity,RECORD DEVICE ACCOUNT,RECORD SOURCE-SYSTEM IDENTITY,,ASSIGN,UNVERIFIED
Repository,RECORD WORKSPACE,RECORD SELECTED REPOSITORY,,ASSIGN,UNVERIFIED
Audience,RECORD LOCAL ACCESS,RECORD GRANTED USERS OR GROUPS,,ASSIGN,UNVERIFIED
Authorisation,RECORD EFFECTIVE ROOTS,RECORD INTEGRATION AND GRANT,,ASSIGN,UNVERIFIED
Execution,RECORD DEVICE,RECORD HOSTED ENVIRONMENT,,ASSIGN,UNVERIFIED
Task records,RECORD HANDLING,RECORD HANDLING,,ASSIGN,UNREVIEWED
External records,RECORD IF APPLICABLE,RECORD SOURCE-SYSTEM HANDLING,,ASSIGN,UNREVIEWED
Download local-cloud-access.csv
access-decision.mdInspect
# Repository access decision

Illustrative repository: SYNTHETIC_REPO_ONLY
Approved audience: ____________________
Local or hosted execution: ____________________
Repository/workspace scope: ____________________
Identity and grant evidence: ____________________
Representative access check: UNTESTED
Data-handling owner: ____________________
Unresolved questions: ____________________
Decision: NOT YET REVIEWED
Recheck after integration, group, repository or environment changes.
Download access-decision.md

Before you proceed

Keep these distinctions clear

Equating a workspace seat with repository permission
Check the connected source-system grant and the repository’s own protections.
Treating revoked access as deleted history
Review earlier task records and external retained copies through their separate owners.

Apply it to employee AI use

Bring your actual data path.

Aona can help review supported employee endpoint paths used by local coding clients.

An installed laptop endpoint does not establish protection of a vendor-hosted checkout. No agentless cloud enforcement is implied.

Bring the local path and a synthetic task to a scoped endpoint evaluation; keep hosted access with its environment owner.

Review your use case

FAQ

Questions for this decision

Does a Codex workspace seat grant access to every repository?
No. OpenAI’s enterprise guidance separates workspace access from the source-system integration and repository permissions. Review the actual audience and selected repository grant.
Does approving local Codex also approve Codex cloud?
Not automatically. Hosted code checkout introduces a connected source-system grant and cloud environment. Record those boundaries and their data-handling review before extending the approval.
Does this worksheet configure repository permissions?
No. It is an inert decision record. An authorised administrator must use the supported source-system and workspace controls and verify the intended scope.
Where should we review setup credentials?
Use the linked cloud setup-versus-agent guide. This worksheet records who owns the environment and repository access, while the separate guide addresses phase-specific secret availability.

Evidence behind the guide

Sources and scope

Prepared by Aona. Sources checked 2026-09-21. The cited material supports the specific points below; it does not certify a product or your use case.

  1. OpenAI: Agent approvals and security

    Explains local sandbox and approval boundaries.

    vendor · checked 2026-09-21
  2. OpenAI: Enterprise admin setup

    Separates workspace, source-system grant, repository permission and environment administration.

    vendor · checked 2026-09-21
  3. OpenAI: Cloud environments

    Describes hosted repository checkout and task execution.

    vendor · checked 2026-09-21
  4. OpenAI: Enterprise Work admin FAQ

    Explains workspace and connected-service access/data-handling distinctions.

    vendor · checked 2026-09-21
Codex local versus cloud repository access