Configure the ChatGPT desktop app with Amazon Bedrock in AWS GovCloud (US)

🖼️ 인포그래픽

🖼️ 4컷 인포그래픽

💡 한 줄 요약

ChatGPT 데스크톱 앱의 Codex를 Amazon Bedrock의 AWS GovCloud (US)에 연결하고, AWS 인증·관리자 정책·네트워크 제한으로 통제된 로컬 배포를 구성하는 안내다.

📌 핵심 요약

• ChatGPT 데스크톱 앱은 Amazon Bedrock의 AWS GovCloud (US)에서 OpenAI 모델을 사용할 수 있으며, Work는 복잡한 다단계 작업을, Codex는 소프트웨어 개발·테스트·검토를 담당한다. 안내의 구성은 Codex 추론 요청을 us-gov-west-1의 Amazon Bedrock Mantle로 보내며, Responses API를 사용한다.
• 데이터 처리는 선택한 Amazon Bedrock AWS 리전에 머무르며, 좌석 라이선스나 개발자별 약정 없이 토큰별로 과금된다. 선택적으로 구성하는 Zero data retention(ZDR) 모드에서는 프롬프트와 응답을 AWS의 영구 저장소에 기록하거나 모델 제공자와 공유하지 않는다.
• 인증에는 Amazon Bedrock API 키 또는 AWS SDK 자격 증명 체인을 사용할 수 있고, 자격 증명 체인은 AWS IAM Identity Center의 SSO도 지원한다. AWS_BEARER_TOKEN_BEDROCK이 있으면 예시 명명 프로필 codex-il5보다 우선하므로, 실제 적용된 자격 증명 출처와 AWS 신원을 확인해야 한다.
• 앱 실행 전에 관리자 통제 파일 requirements.toml과 사용자 설정 파일 config.toml을 배치한다. 예시는 API 방식 로그인, amazon-bedrock 제공자, 승인된 모델, us-gov-west-1, 승인된 Bedrock 엔드포인트를 지정하고 외부 연결 및 여러 네트워크 활용 기능을 제한한다. ChatGPT 워크스페이스 규칙과 사용자 역할 대신 기기 정책과 AWS IAM 권한이 주요 통제 수단이 된다.
• 배포 전 AWS GovCloud (US) 지원 앱 버전, 승인된 계정·모델·리전·엔드포인트·권한을 확인하고, 실행 후 amazon-bedrock 제공자와 실제 적용된 정책을 검증해야 한다. URL 변경이나 API 전용 로그인만으로 지원 여부와 기능 제한이 보장되지는 않으며, 검증 실패 시 배포를 중단하고 이전 승인 설정으로 복원한다. 이 안내를 따르는 것만으로 워크로드가 인가되지는 않는다.

🧩 주요 포인트

1. us-gov-west-1의 Amazon Bedrock Mantle로 추론을 연결한다는 사실은 통제의 중심이 기기 정책과 AWS IAM으로 옮겨간다는 의미이며, 조직의 별도 워크로드 인가 책임도 유지된다.
2. AWS_BEARER_TOKEN_BEDROCK이 codex-il5보다 우선한다는 인증 순서 때문에, 프로필을 지정했다는 사실만으로 의도한 AWS 신원이 사용된다고 판단할 수 없다.
3. requirements.toml과 config.toml을 실행 전에 적용하고 실행 후 정책을 검증해야 하므로, API 전용 로그인 설정이나 엔드포인트 URL만 확인하는 것으로는 통제된 배포를 입증하기 어렵다.

🧠 상세 정리

1. 제공 기능과 안내의 적용 범위

원문은 ChatGPT 데스크톱 앱을 Amazon Bedrock의 AWS GovCloud (US)에서 사용할 수 있으며, 이를 통해 OpenAI의 프런티어 모델에 접근한다고 설명한다. 앱의 두 구성 요소 가운데 Work는 계획·조사·파일 처리와 완성된 결과가 필요한 복잡한 다단계 작업을 맡고, Codex는 코드 수정·테스트 실행·풀 리퀘스트 검토 같은 기술 작업을 맡는다. Codex는 GPT 모델을 기반으로 복잡하고 장기적인 개발 흐름을 지원하며, 데스크톱 앱과 CLI뿐 아니라 Visual Studio Code, JetBrains, Xcode 통합에서도 사용할 수 있다고 소개된다. 다만 이 안내의 구체적인 구성 대상은 모델 추론에 AWS GovCloud (US)의 신원·엔드포인트·리전 통제를 요구하는 조직이며, Codex 요청을 us-gov-west-1의 Amazon Bedrock Mantle로 연결하는 데 초점을 둔다.

2. 데이터 처리 조건과 보안 책임

모델 추론은 Amazon Bedrock의 Responses API를 통해 전달되며, 데이터 상주 요건이 있는 고객의 처리는 선택한 Amazon Bedrock AWS 리전 안에 머문다고 설명한다. 비용은 토큰 단위로 부과되고 좌석 라이선스나 개발자별 약정은 없으며, Zero data retention(ZDR)도 지원된다. ZDR은 구성 가능한 모드로 제시되며, 이 모드에서는 프롬프트와 응답을 AWS의 영구 저장소에 기록하거나 모델 제공자와 공유하지 않는다는 설명이 붙는다. 그러나 AWS GovCloud (US)를 사용하고 이 안내를 따르는 것만으로 워크로드가 인가되는 것은 아니며, 조직은 선택한 모델·AWS 서비스·리전·엔드포인트·워크스테이션 통제·저장소·자격 증명·데이터 흐름을 자체 시스템 보안 계획과 인가 절차에 따라 검토할 책임을 진다.

3. 배포 구조와 사전 준비

구성은 조직이 관리하는 컴퓨터에서 데스크톱 앱이나 CLI를 실행하고, 설정된 AWS 자격 증명으로 us-gov-west-1의 Amazon Bedrock Mantle 엔드포인트에 요청을 보내는 방식이다. AWS를 직접 사용하므로 ChatGPT 워크스페이스의 규칙과 사용자 역할은 이 구성을 통제하지 않으며, 컴퓨터 정책과 사용 중인 AWS 신원 및 권한이 주요 보안 통제 수단이 된다. 시작 전에는 앱 버전이 Amazon Bedrock의 AWS GovCloud (US)를 지원하는지 확인하고, 승인된 AWS GovCloud (US) 계정과 IAM 신원, 승인된 자격 증명, 모델·리전·엔드포인트 접근 및 사용 권한을 확보해야 한다. 전체 절차는 인증 설정, requirements.toml과 config.toml 구성, 앱 실행·초기화·검증의 세 단계이며, 보안팀이 확대 사용을 승인하기 전에 시험하고 문서화할 수 있는 통제된 로컬 배포를 목표로 한다.

4. 인증 방식과 자격 증명 우선순위

인증 설정에서는 us-gov-west-1의 승인된 모델에 접근할 수 있는 AWS GovCloud (US) 계정과 IAM 신원 또는 역할을 선택하고, 조직이 승인한 방식으로 자격 증명을 발급받는다. 예시 명명 프로필은 codex-il5이며, 자격 증명·베어러 토큰·세션 토큰 등 비밀정보를 TOML 파일에 넣지 않고, 프로필 설정·자격 증명 출처·SSO 토큰 캐시·보조 도구를 앱 작업의 쓰기로부터 보호하되 승인된 인증 도구의 갱신은 허용하도록 안내한다. 앱은 Amazon Bedrock API 키와 AWS SDK 자격 증명 체인을 지원하며, 환경의 AWS_BEARER_TOKEN_BEDROCK을 먼저 확인하므로 해당 값이 있으면 프로필 기반 인증보다 우선한다. 데스크톱에서는 이 변수를 Windows의 %USERPROFILE%.codex.env 또는 Linux·macOS의 ~/.codex/.env로 제공할 수 있고, 토큰이 없으면 AWS SDK 자격 증명 체인으로 전환한다. 이 체인은 AWS 자격 증명 및 설정 파일과 SSO 프로필을 지원하며, SSO에서는 설정과 캐시된 세션으로 임시 역할 자격 증명을 얻으므로 이를 자격 증명 파일에 수동 저장할 필요가 없다.

5. 관리자 정책과 기능·네트워크 제한

requirements.toml은 사용자가 덮어쓸 수 없는 보안 한계를 정하는 관리자 통제 파일이며, Windows에서는 %ProgramData%\OpenAI\Codex\requirements.toml, Linux와 macOS에서는 /etc/codex/requirements.toml에 둔다. 예시는 로그인 방식을 api로, 허용 샌드박스를 read-only와 workspace-write로, 승인 검토자를 user로 제한하고, 세분화된 승인 정책에서 규칙 및 스킬 승인을 허용하면서 샌드박스 승인과 권한 요청 등은 제한한다. 브라우저·컴퓨터 사용, 원격 제어, 로그인 셸, 피드백, 앱 내 업데이트, 이미지 생성, 메모리, 앱·플러그인 및 여러 외부 연결 기능도 제한하는 기준 설정을 제시한다. 네트워크는 관리자 허용 도메인만 사용하도록 구성하고, 애플리케이션 연결 대상으로 bedrock-mantle.us-gov-west-1.api.aws를 허용하는 한편 원문에 열거된 OpenAI·ChatGPT 및 관련 인증·정적 자산·업데이트 등의 도메인을 거부한다. Windows 전용 설정은 elevated 샌드박스 구현과 sandbox_private_desktop을 요구하며, 후자는 승인된 런타임에서 지원되어야 한다.

6. 사용자 설정과 모델 연결

config.toml은 모델 제공자와 모델, 권한 및 동작 설정을 지정하며, Windows에서는 %USERPROFILE%.codex\config.toml, Linux와 macOS에서는 ~/.codex/config.toml에 둔다. 예시는 model_provider를 amazon-bedrock으로, 로그인 방식을 api로 설정하고 모델 ID와 codex-il5 같은 명명 프로필을 조직이 승인한 값으로 교체하도록 안내한다. 제공자 주소는 https://bedrock-mantle.us-gov-west-1.api.aws/openai/v1이고 wire_api는 responses이며, 리전은 us-gov-west-1로 지정하고 OpenAI 인증 요구·WebSocket·독립 웹 검색 지원은 비활성화한다. 작업 샌드박스는 workspace-write로 설정하되 해당 샌드박스의 네트워크 접근은 끄고, 네트워크 프록시 기능을 켜며 웹 검색 설정은 cached로 둔다. 분석·피드백·텔레메트리 내보내기·사용자 프롬프트 기록·메모리 생성과 사용·번들 스킬·기본 앱도 비활성화하고, Windows에서는 elevated 샌드박스를 지정한다.

7. 설치·실행과 적용 상태 검증

설치 단계에서는 ChatGPT 사이트에서 앱을 내려받아 설치하되, 설치 후 앱을 닫힌 상태로 유지하도록 안내한다. 자동으로 실행되었거나 과거에 실행한 적이 있다면 ChatGPT를 완전히 종료하고 남아 있는 ChatGPT 또는 Codex 프로세스도 끝내야 하며, requirements.toml과 config.toml은 첫 앱 실행 전에 준비되어 있어야 한다. 이후 앱을 시작해 두 파일을 읽게 하고 모델 제공자가 amazon-bedrock으로 표시되는지 확인하는데, 원문은 Codex CLI의 /status 탭과 데스크톱 앱 설정 화면을 확인 위치로 제시한다. OpenAI 계정 로그인을 요구한다면 두 파일의 정확한 이름과 운영체제별 위치를 확인하고 모든 관련 프로세스를 종료한 뒤 다시 실행해야 한다. 기능 제한이 보이지 않는 경우에는 재시작 후 실제로 적용된 전체 requirements를 확인해야 하며, API 전용 로그인 설정 자체가 기능 제한 정책까지 적용해 주는 것은 아니라고 강조한다.

8. 지원 문제·인증 오류와 복원

AWS GovCloud (US) 엔드포인트가 지원되지 않는다는 오류가 나오면, 정확한 데스크톱 앱 또는 app-server 릴리스와 엔드포인트 및 모델을 OpenAI에 확인하도록 안내한다. 주소만 바꾼다고 지원이 성립하지 않는다는 점을 명시하므로, 설정 문자열의 변경과 실제 지원 여부를 구분해야 한다. 잘못된 AWS 신원이 사용될 때는 실제 자격 증명 출처와 명명 프로필을 살피고, Amazon Bedrock API 키가 프로필보다 우선하고 있는지도 확인하도록 한다. 검증 항목을 통과하지 못하면 배포를 중단하고 해당 기기를 이전에 승인된 정책과 제공자 설정으로 되돌린 뒤 ChatGPT 데스크톱 앱을 재시작하는 것이 원문에 명시된 복원 절차다. 제공된 source_body는 이어지는 문장이 'Revoke any tempo'에서 끊기므로, 그 뒤의 자격 증명 폐기나 추가 정리 절차는 확인할 수 없다.

🧾 핵심 주장 / 시사점

• 이 구성에서 통제된 사용을 뒷받침하는 것은 리전 선택 하나가 아니라 AWS 신원, 관리자 정책, 엔드포인트 제한, 실행 후 검증의 결합이다.
• ZDR과 리전 내 처리는 데이터 취급 조건을 설명하지만, 조직의 워크로드 인가를 대신하지 않는다. 원문도 서비스의 제공 조건과 조직의 보안 책임을 구분한다.
• 설정 파일의 내용뿐 아니라 배치 시점과 실제 적용 상태가 중요하다. 앱 실행 전 파일 준비, 관련 프로세스 종료, 재시작 후 정책 확인이 반복해서 강조된다.

✅ 액션 아이템

• AWS GovCloud (US) 지원 앱 버전과 승인된 모델·리전·엔드포인트·권한 확인.
• AWS_BEARER_TOKEN_BEDROCK의 우선 적용 여부와 codex-il5를 포함한 실제 AWS 신원 확인.
• 앱 실행 전 requirements.toml·config.toml 배치 및 실행 후 amazon-bedrock 제공자·정책 검증, 검증 실패 시 배포 중단과 이전 승인 설정 복원.

❓ 열린 질문

• 사용할 앱 버전과 승인된 모델은 us-gov-west-1의 Amazon Bedrock Mantle 엔드포인트를 지원하는가?
• AWS_BEARER_TOKEN_BEDROCK이 codex-il5보다 우선 적용되어 의도와 다른 AWS 신원이 사용되고 있지는 않은가?
• requirements.toml과 config.toml이 앱 실행 전에 배치되었으며, 실행 후 amazon-bedrock 제공자와 기능 제한 정책이 실제로 적용되었는가?