에이전트가 생성한 코드는 실행 환경에서 사용할 수 있는 파일, 자격 증명, 네트워크에 접근할 수 있습니다.
워크로드 격리
가상 머신처럼 격리된 컴퓨팅 환경에서 워크로드를 실행하세요. 데이터를 공유해서는 안 되는 사용자나 워크로드에는 각각 별도의 환경을 사용하세요. 애플리케이션이나 워크로드 전용 OpenAI 프로젝트를 만드세요.
네트워크 접근 제한
실행기의 필수 호스트를 포함해 승인된 엔드포인트로 향하는 아웃바운드 트래픽만 허용하세요.
각 도구가 어디에서 연결을 시작하는지에 따라 네트워크 접근을 설정하세요.
- 실행기 MCP는 사용자의 환경에서 연결을 시작합니다. 실행기 MCP가 필요한 서버에 접근할 수 있도록 허용하세요.
- 원격 MCP는 OpenAI 서비스에서 연결을 시작합니다. 해당 서비스에서 원격 MCP 엔드포인트에 접근할 수 있어야 합니다.
연결 옵션은 MCP 도구에서 확인하세요.
에이전트 작업 검토
자동 검토를 활성화하려면 세션 수준에서 review: "auto_review"를 설정하세요. 그러면 지원되는 승인 요청이 자동으로 승인되거나 거부됩니다. 자동 검토가 환경의 네트워크 제한과 자격 증명 제어를 대체하지 않으므로 이러한 조치는 그대로 유지하세요.
자동 검토는 workspace-write를 기본 권한으로 사용하고 네트워크 접근을 제한하는 권한 프로필을 적용합니다. 표준 실행기를 사용하는 경우 컨테이너가 샌드박스를 지원해야 하며, Codex가 샌드박스를 만들 수 있도록 허용해야 합니다. 자세한 내용은 실행 환경 요구 사항을 참고하세요.
브라우저의 출처별 접근 승인과 로그인에는 여전히 애플리케이션의 기존 핸들러가 필요합니다. 해당 워크플로우는 컴퓨터 사용에서 확인하세요.
자격 증명 분리
애플리케이션 키에 세션용 api.agents.read 및 api.agents.write 권한과 추론용 api.responses.write 권한을 부여하세요. 볼트를 관리하려면 api.vaults.read 및 api.vaults.write 권한을 추가하세요.
실행기에서 환경 키를 CODEX_API_KEY 값으로 설정하세요. 이 키는 환경 연결에만 사용할 수 있습니다. 다른 API 작업을 수행할 권한은 부여하지 않습니다. 설정 방법은 실행기 인증을 참고하세요.
에이전트가 생성한 코드는 환경 키를 읽을 수 있습니다. 애플리케이션 API 키는 환경 외부에 보관하세요. 이미지, 소스 코드 또는 로그에 키를 포함하지 마세요. 필요할 때 키를 교체하거나 폐기하세요.
외부 서비스 접근 중개
외부 서비스의 자격 증명은 환경 외부에 보관하세요. OpenAI가 호스팅하는 샌드박스에서 API 요청을 보낼 때는 볼트의 시크릿을 환경 변수로 사용하세요. 샌드박스 코드는 자리표시자를 사용하고, 네트워크 프록시는 승인된 호스트로 보내는 요청에 실제 시크릿을 넣습니다.
자체 호스팅 환경에서는 신뢰할 수 있는 프록시나 서버가 환경 외부에서 시크릿을 제공하도록 설정하세요. 이 인프라는 직접 마련해야 합니다. 함수 도구를 사용할 때는 호출을 처리하는 애플리케이션에 자격 증명을 보관하고 결과만 반환하세요.
장기간 사용하는 자격 증명은 시크릿 관리자에 보관하세요. 저장한 시크릿이라도 환경에 주입하면 에이전트가 생성한 코드에서 읽을 수 있습니다. 자격 증명을 정기적으로 교체하고 노출이 의심되면 즉시 폐기하세요.