IP 허용 목록

IP 허용 목록을 사용하면 신뢰할 수 있는 IP 주소나 CIDR 범위에서 보낸 OpenAI API 요청만 허용할 수 있습니다. 허용 목록을 활성화하면 다른 IP 주소에서 보낸 요청은 유효한 API 키를 포함하더라도 OpenAI가 거부합니다.

외부로 나가는 네트워크 경로가 고정되어 있거나 명확히 정해진 프로덕션 워크로드에는 IP 허용 목록을 추가 보호 수단으로 사용하세요. 허용 목록은 API 요청에만 적용되며 platform.openai.com 접속이나 사용자 로그인을 제한하지 않습니다.

허용 목록 활성화 전 준비 사항

API를 호출하는 모든 워크로드의 아웃바운드 공인 IP 주소 또는 범위를 파악하세요. API는 OpenAI에 도달한 요청의 출발지 IP 주소를 기준으로 허용 여부를 판단하므로 네트워크 주소 변환(NAT), VPN, 방화벽 또는 프록시를 거친 후의 주소를 확인하세요.

허용 목록에는 개별 IP 주소와 CIDR 범위를 합쳐 최대 50개까지 등록할 수 있습니다. 조직 소유자 역할에는 IP 허용 목록 설정을 관리하는 데 필요한 Read 및 Write 권한이 있습니다. 권한에 관한 자세한 내용은 OpenAI 플랫폼에서 권한 관리하기를 참고하세요.

조직 전체에 허용 목록을 적용하기 전에 중요도가 낮은 프로젝트 하나에서 먼저 테스트하세요. 설정을 테스트하는 동안에는 허용된 IP 주소에서 요청을 보낼 수 있도록 미리 검증한 경로를 확보해 두세요.

프로젝트 수준의 허용 목록은 조직 수준의 허용 목록보다 우선합니다. 두 목록의 항목은 합쳐지지 않습니다. 프로젝트에 자체 허용 목록이 활성화되어 있으면 해당 목록을 사용하고, 그렇지 않으면 조직 수준의 허용 목록을 사용합니다.

IP 허용 목록 설정하기

1. 설정 > 보안 > IP 허용 목록을 여세요.
2. 허용할 개별 IP 주소나 CIDR 범위를 추가하세요. 예를 들어 단일 주소는 203.0.113.10, 주소 범위는 203.0.113.0/24와 같이 입력하세요.
3. 필요한 경우 확인 도구를 사용해 특정 IP 주소가 허용 목록에 포함되는지 확인하세요.
4. 특정 프로젝트 또는 조직 전체에 허용 목록을 활성화하세요.
5. 변경 사항이 적용될 때까지 최대 15분간 기다리세요.
6. API를 사용할 각 환경에서 요청을 보내 접근할 수 있는지 확인하세요.

허용 목록 적용 여부 확인하기

허용된 네트워크 경로에서 평소 사용하는 API 요청을 하나 보내세요. 예를 들어 다음 명령어를 실행하세요.

curl https://api.openai.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY"

요청은 해당 API 키에 평소 적용되는 인증 및 권한 검사 결과에 따라 처리되어야 합니다. 활성화된 허용 목록에 포함되지 않은 IP 주소에서 요청을 보내면 HTTP 401 상태 코드와 ip_not_authorized 오류 코드가 반환되며 요청이 실패합니다.

차단된 요청 문제 해결하기

허용될 것으로 예상한 요청이 ip_not_authorized 오류로 실패하면 다음 사항을 확인하세요.

• API 요청을 보낼 때와 동일한 네트워크 경로에서 워크로드의 아웃바운드 공인 IP 주소를 확인하세요. 로컬 개발 머신과 배포된 서비스의 공인 IP 주소는 서로 다를 수 있습니다.
• NAT 게이트웨이, VPN, 방화벽, 프록시 또는 클라우드 제공업체가 아웃바운드 IP 주소를 변경했는지 확인하세요.
• 확인 도구는 IP 허용 목록 설정에서 사용할 수 있습니다. 이 도구로 해당 주소가 등록된 항목에 포함되는지 확인하세요.
• 활성화된 허용 목록이 API 키와 연결된 조직 또는 프로젝트에 적용되는지 확인하세요.
• 설정을 변경한 후 최대 15분간 기다렸다가 다시 테스트하세요.

IP 허용 목록을 사용하더라도 API 키를 안전하게 보관하고 주기적으로 교체하며 계정 보안을 관리해야 합니다. 요청을 공인 IP 주소가 아닌 Azure 프라이빗 네트워크에서 보내야 한다면 Private Link를 고려하세요. Private Link는 IP 허용 목록을 통한 접근 제어와 호환되지 않습니다.