ChatGPT 데스크톱 앱이 이제 Amazon Bedrock 에서 AWS GovCloud(US)사용할 수 있게 되었으며, 두 가지 구성 요소를 통해 OpenAI의 최첨단 모델에 대한 액세스를 제공합니다. Work는 복잡한 다단계 작업을 완료하고 검토 준비가 된 결과를 전달하며, Codex는 소프트웨어를 개발, 테스트 및 검토하기 위한 코딩 에이전트입니다.
이 워크스루는 보안 아키텍처에서 모델 추론이 AWS GovCloud(US) 자격 증명, 엔드포인트 및 리전별 제어를 사용하도록 요구하는 조직을 위해 작성되었습니다. Codex가 모델 요청을 Amazon Bedrock Mantle을 통해 us-gov-west-1으로 라우팅하도록 구성하며, 여기서 액세스는 AWS Identity and Access Management(IAM) 및 기존 AWS GovCloud(US) 네트워크 제어를 사용하여 관리할 수 있습니다.
Codex는 AI 기반 소프트웨어 개발을 위한 OpenAI 코딩 에이전트입니다. GPT 모델이 추론을 지원하며, Codex는 복잡하고 장기적인 개발자 워크플로에 최적화된 새로운 클래스의 인텔리전스를 도입합니다. ChatGPT 데스크톱 앱, Codex CLI, 그리고 Visual Studio Code, JetBrains, Xcode와의 IDE 통합을 사용할 수 있습니다. 모델 추론은 Amazon Bedrock의 Responses API를 통해 라우팅됩니다.
데이터 레지던시 요구 사항이 있는 고객의 경우, 처리는 선택한 Amazon Bedrock AWS 리전 내에 머무릅니다. 시트 라이선스나 개발자당 약정 없이 토큰 단위로 비용을 지불합니다. 제로 데이터 보존(ZDR)도 지원됩니다. 이 구성 가능한 모드에서는 프롬프트와 응답이 AWS에 의해 영구 스토리지에 기록되거나 모델 제공업체와 공유되지 않고 처리됩니다. 이를 통해 민감한 정보를 보호하고 엄격한 데이터 거버넌스, 프라이버시 및 보안 요구 사항을 충족할 수 있습니다.
이 게시물은 모델 추론을 AWS GovCloud(US-West)의 Amazon Bedrock으로 전송하는 ChatGPT 데스크톱 앱의 통제된 로컬 배포를 안내합니다. 구성은 API 모드 로그인, 관리형 디바이스 정책, 명명된 AWS 프로필 및 네트워크 제한을 사용합니다. 이러한 제한은 승인된 Amazon Bedrock 엔드포인트에 대한 액세스만 허용하고 다른 외부 연결 및 네트워크 기반 기능은 비활성화합니다. 그 결과 기관 보안 팀이 더 폭넓은 사용을 승인하기 전에 테스트하고 문서화할 수 있는 배포가 완성됩니다.
AWS GovCloud(US)를 사용하고 이 가이드를 따르는 것만으로는 워크로드가 승인되지 않습니다. 선택한 모델, AWS 서비스, 리전, 엔드포인트, 워크스테이션 제어, 리포지토리, 자격 증명 및 데이터 흐름을 시스템 보안 계획 및 승인 프로세스에 따라 검토할 책임은 조직에 있습니다.
솔루션 개요
ChatGPT 데스크톱 앱은 두 가지 방식으로 사용할 수 있습니다:
- 계획, 조사, 파일 및 완성된 결과가 필요한 더 큰 작업에는 Work.
- 코드 편집, 테스트 실행, 풀 리퀘스트 검토와 같은 기술 작업에는 Codex.
ChatGPT 데스크톱 앱은 조직이 관리하는 컴퓨터에서 데스크톱 앱 또는 CLI를 통해 실행됩니다. 구성된 AWS 자격 증명을 사용하여 us-gov-west-1의 Amazon Bedrock Mantle 엔드포인트에 요청을 안전하게 전송합니다. 이 설정은 AWS를 직접 사용하므로 ChatGPT 워크스페이스 규칙과 사용자 역할이 이를 제어하지 않습니다. 주요 보안 제어는 컴퓨터의 정책과 사용 중인 AWS 자격 증명 및 권한입니다.
워크스루
구성에는 세 가지 주요 단계가 있습니다: 인증 설정, ChatGPT 데스크톱 앱 구성 파일 설정, 그리고 배포 실행, 초기화 및 검증.
사전 요구 사항
AWS GovCloud(US)와 함께 ChatGPT 데스크톱 앱을 설정하기 전에 ChatGPT 데스크톱 앱의 버전 이 AWS GovCloud(US)의 Amazon Bedrock을 지원하는지 확인하십시오. 승인된 AWS GovCloud(US) 계정, IAM 자격 증명 및 승인된 자격 증명, 승인된 모델, AWS 리전 및 엔드포인트에 대한 액세스, 그리고 이를 사용할 권한이 필요합니다. 또한 requirements.toml 및 config.toml 파일을 설정해야 합니다.
1단계: 인증 설정
승인된 AWS GovCloud(US) 계정과 us-gov-west-1. 조직의 승인된 메커니즘을 통해 자격 증명을 얻으십시오. 이 안내서는 named profile을 사용합니다. codex-il5TOML 파일에 자격 증명, bearer 토큰, 세션 토큰 및 기타 비밀 정보를 두지 마십시오.
승인된 인증 도구가 자격 증명을 유지하고 갱신할 수 있도록 하면서, 프로파일 구성, 자격 증명 소스, SSO 토큰 캐시 및 모든 자격 증명 헬퍼를 ChatGPT 데스크톱 앱 작업 쓰기로부터 보호하십시오.
ChatGPT 데스크톱 앱은 두 가지 Amazon Bedrock 인증 경로를 지원합니다: Amazon Bedrock API 키 또는 AWS SDK 자격 증명 체인입니다. AWS IAM Identity Center를 통한 AWS SSO는 자격 증명 체인 경로 내에서 지원됩니다.
앱은 먼저 자신의 환경에서 AWS_BEARER_TOKEN_BEDROCK 을(를) 확인합니다. 데스크톱 환경에서는 이 변수를 Windows에서는 %USERPROFILE%\.codex\.env 을(를), Linux 및 macOS에서는 ~/.codex/.env 을(를) 통해 제공할 수 있습니다. 베어러 토큰이 존재하면 프로파일 기반 인증보다 우선합니다.
베어러 토큰을 사용할 수 없는 경우 앱은 표준 AWS SDK 자격 증명 체인으로 대체합니다. 이 체인은 ~/.aws/credentials 에서 AWS 자격 증명을 읽고, 관련 프로파일 설정은 ~/.aws/config에서 읽습니다. Windows에서 해당 기본 경로는 %USERPROFILE%\.aws\credentials 및 %USERPROFILE%\.aws\config입니다. 이 체인은 SSO 프로파일도 지원합니다. SSO의 경우 AWS config 파일의 프로파일 설정과 캐시된 SSO 세션을 사용하여 임시 역할 자격 증명을 획득합니다. 이러한 자격 증명은 AWS credentials 파일에 수동으로 저장할 필요가 없습니다. 자세한 내용은 OpenAI의 Bedrock 인증 문서 및 AWS IAM Identity Center 자격 증명 공급자 문서를 참조하십시오..
2단계: ChatGPT 데스크톱 앱 구성 파일 설정
두 개의 ChatGPT 데스크톱 앱 구성 파일을 생성해야 합니다: config.toml 및 requirements.toml.
중요: 구성 파일은 애플리케이션을 시작하기 전에 설정해야 합니다. 다음 표는 파일 위치를 보여줍니다.
| 운영 체제 | 사용자 config.toml |
관리자 requirements.toml |
| Windows | %USERPROFILE%\.codex\config.toml |
%ProgramData%\OpenAI\Codex\requirements.toml |
| Linux | ~/.codex/config.toml |
/etc/codex/requirements.toml |
| macOS | ~/.codex/config.toml |
/etc/codex/requirements.toml |
다음에서 시작하십시오: requirements.toml 파일. requirements.toml 은(는) 관리자가 제어하는 규칙 파일입니다. 이 파일은 사용자가 재정의할 수 없는 보안 제한을 설정합니다. 예를 들어 ChatGPT 데스크톱 앱이 사용할 수 있는 권한 수준, 도구 또는 설정을 제한합니다.
지원되는 AWS GovCloud (US) Amazon Bedrock 배포를 위해 다음 기준선을 사용하십시오. [windows] 섹션은 Windows에만 적용되며, sandbox_private_desktop 은(는) 승인된 런타임에서 지원되어야 합니다.
allowed_login_methods = ["api"]
allowed_sandbox_modes = ["read-only", "workspace-write"]
allowed_approvals_reviewers = ["user"]
allowed_approval_policies = [
{ granular = { sandbox_approval = false, rules = true,
mcp_elicitations = false, request_permissions = false,
skill_approval = true } },
]
allowed_web_search_modes = ["disabled", "cached"]
allow_browser_and_computer_use = false
allow_appshots = false
allow_remote_control = false
allow_login_shell = false
allow_managed_hooks_only = true
check_for_update_on_startup = false
mcp_servers = {}
[feedback]
enabled = false
[features]
network_proxy = true
in_app_chat = false
in_app_dictation = false
in_app_browser = false
browser_use = false
browser_use_external = false
browser_use_full_cdp_access = false
computer_use = false
in_app_updates = false
image_generation = false
memories = false
chronicle = false
external_agent_memory_import = false
guardian_approval = false
guardianv2 = false
guardian_ext = false
apps = false
enable_mcp_apps = false
plugins = false
remote_plugin = false
plugin_sharing = false
recommended_plugins = false
skill_mcp_dependency_install = false
skill_search = false
workspace_dependencies = false
hooks = false
standalone_web_search = false
[experimental_network]
enabled = true
managed_allowed_domains_only = true
domains = {}
unix_sockets = {}
allow_upstream_proxy = false
dangerously_allow_non_loopback_proxy = false
dangerously_allow_all_unix_sockets = false
allow_local_binding = false
[application.network]
enabled = true
[application.network.domains]
"bedrock-mantle.us-gov-west-1.api.aws" = "allow"
"api.openai.com" = "deny"
"chat.openai.com" = "deny"
"chatgpt.com" = "deny"
"ab.chatgpt.com" = "deny"
"platform.openai.com" = "deny"
"auth.openai.com" = "deny"
"gov.api.openai.com" = "deny"
"gov.chatgpt.com" = "deny"
"sdfedpreastus2.oaiusercontent.com" = "deny"
"o33249.ingest.us.sentry.io" = "deny"
"persistent.oaistatic.com" = "deny"
"oaisidekickupdates.blob.core.windows.net" = "deny"
[windows]
allowed_sandbox_implementations = ["elevated"]
sandbox_private_desktop = true다음으로 config.toml 파일을 구성합니다. config.toml 은(는) ChatGPT 데스크톱 앱이 어떻게 작동할지, 즉 사용할 모델 공급자(amazon-bedrock), 선택할 모델, 그리고 권한이나 컨텍스트 제한과 같은 설정을 지정합니다.
모델 ID와 명명된 프로파일(예: codex-il5)을 승인된 값으로 교체하십시오.
model = "REPLACE_WITH_APPROVED_MODEL_ID"
model_provider = "amazon-bedrock"
forced_login_method = "api"
approval_policy = { granular = { sandbox_approval = false,
rules = true, mcp_elicitations = false,
request_permissions = false, skill_approval = true } }
approvals_reviewer = "user"
sandbox_mode = "workspace-write"
web_search = "cached"
allow_login_shell = false
check_for_update_on_startup = false
[model_providers.amazon-bedrock]
base_url = "https://bedrock-mantle.us-gov-west-1.api.aws/openai/v1"
wire_api = "responses"
requires_openai_auth = false
supports_websockets = false
supports_standalone_web_search = false
[model_providers.amazon-bedrock.aws]
region = "us-gov-west-1"
profile = "codex-il5"
[sandbox_workspace_write]
network_access = false
[features]
network_proxy = true
[analytics]
enabled = false
[feedback]
enabled = false
[otel]
exporter = "none"
trace_exporter = "none"
metrics_exporter = "none"
log_user_prompt = false
[memories]
generate_memories = false
use_memories = false
[skills.bundled]
enabled = false
[apps._default]
enabled = false
[windows]
sandbox = "elevated"3단계: 실행, 초기화 및 확인
ChatGPT 사이트에서 앱을 다운로드하여 설치하십시오. 설치 후에는 앱을 닫아 둔 상태로 유지하십시오. 앱이 자동으로 열리거나 이전에 앱이 실행된 적이 있는 경우, ChatGPT를 완전히 종료하고 남아 있는 ChatGPT 또는 Codex 프로세스를 모두 종료하십시오.
다음 항목들이 requirements.toml 와 config.toml 위치에 있는지 첫 앱 실행 전에 확인하십시오.
앱을 시작하여 requirements.toml 및 config.toml 설정을 로드하십시오. 모델 제공자로 amazon-bedrock 이 표시되는지 확인하십시오.
Codex CLI에서 다음과 같은 /status 탭이 표시되어야 합니다:
그림 1: amazon-bedrock이 모델 제공자임을 확인하는 Codex CLI /status 탭
ChatGPT 데스크톱 앱에서도 모델 제공자로 amazon-bedrock 임을 확인할 수 있습니다.
그림 2: amazon-bedrock이 모델 제공자로 표시된 ChatGPT 데스크톱 앱 설정
문제 해결
애플리케이션이 OpenAI 계정을 요구합니다. 앞의 표에 나온 정확한 위치와 파일 이름을 사용하는지 requirements.toml 및 config.toml 파일을 확인하고, 모든 ChatGPT 및 Codex 프로세스를 종료한 후 다시 실행하십시오. 이 파일들은 앱 실행 전에 존재해야 합니다.
AWS GovCloud (US) 엔드포인트가 지원되지 않는다고 표시됩니다. 정확한 데스크톱 또는 app-server 릴리스, 엔드포인트 및 모델을 OpenAI에 확인하십시오. URL만 변경한다고 해서 지원이 확립되는 것은 아닙니다.
잘못된 AWS 자격 증명(Identity)이 사용됩니다. 유효 자격 증명 소스와 이름이 지정된 프로파일을 점검하십시오. Amazon Bedrock API 키가 해당 프로파일보다 우선하는지 확인하십시오.
기능 제한이 누락되었습니다. 재시작 후 전체 유효 요구 사항을 점검하십시오. API 전용 로그인 설정은 기능 정책을 적용하지 않습니다.
롤백 및 정리
유효성 검사가 실패하면 배포를 중단하십시오. 영향을 받은 디바이스를 이전에 승인된 정책 및 공급자 설정으로 되돌린 후 ChatGPT 데스크톱 앱을 재시작하십시오. 임시 AWS 자격 증명이나 API 키를 폐기하고, 해당 디바이스가 더 이상 Amazon Bedrock에 연결할 수 없는지 확인하십시오. 테스트 기록을 보관하고, 다시 시도하기 전에 무엇이 실패했는지 명확하게 문서화하십시오.
결론
AWS GovCloud (US)의 Amazon Bedrock용 ChatGPT 데스크톱 앱은 OpenAI 프론티어 모델과 코딩 지원을 통제된 방식으로 사용할 수 있게 해 줍니다. 추론은 AWS GovCloud (US) 리전 내에 유지됩니다. 구성을 검증하고, 승인된 AWS 자격 증명과 엔드포인트를 확인하고, 보안 제어를 점검함으로써 더 폭넓은 사용을 위한 배포를 자신 있게 준비할 수 있습니다. 이 접근 방식은 배포 결정을 각 조직의 보안, 권한 부여 및 데이터 처리 요구 사항에 맞추면서 혁신을 지원합니다.
AWS GovCloud (US)의 Amazon Bedrock에서 Codex가 포함된 ChatGPT 데스크톱 앱을 사용해 볼 준비가 되셨습니까? 통제된 배포로 시작하고, 보안 제어를 검증하며, 보안 팀과 협력하여 더 폭넓은 도입을 준비하십시오.
관련 리소스
- Bedrock AWS GovCloud (US) 구성 – ChatGPT 데스크톱 앱의 디바이스, 공급자, 네트워크, 검증 및 문제 해결 지침.
- Amazon Bedrock의 Responses API – Responses API를 위한 AWS 리전, 엔드포인트 동작, 인증 및 권한.
- AWS GovCloud (US) 규정 준수 – 규정 준수 프로그램 및 고객 승인 고려 사항.
- OpenAI의 Bedrock 인증 문서 – SSO를 포함한 Amazon Bedrock API 키 및 AWS SDK 자격 증명 체인 인증.
- AWS IAM Identity Center 자격 증명 공급자 문서 – SSO 프로파일 구성 및 임시 AWS 자격 증명.