개요
IP 허용 목록은 OpenAI API에 액세스할 수 있는 IP 주소를 제한하는 선택적 보안 기능입니다.
이 기능을 활성화하면 설정된 IP 주소 또는 IP 범위에서 전송된 요청만 허용됩니다. 그 외 모든 IP에서 전송된 요청은 유효한 API 키를 포함하더라도 거부됩니다.
이 기능은 신뢰할 수 있는 네트워크 환경에서만 액세스를 허용하여 무단 API 사용 위험을 줄이는 데 도움이 됩니다.
참고: IP 허용 목록은 API 요청에만 적용됩니다. platform.openai.com 액세스나 사용자 로그인에는 영향을 미치지 않습니다.
IP 허용 목록을 사용하는 이유
IP 허용 목록을 사용하면 다음과 같은 이점이 있습니다.
확인된 인프라(예: 자체 서버 또는 클라우드 환경)에서만 API 액세스 허용
API 키 유출 시 위험 노출 감소
API 트래픽의 출발지를 제어하는 수단 추가
IP 허용 목록은 API 트래픽이 고정되거나 명확히 정의된 네트워크 범위에서 발생하는 프로덕션 환경에서 가장 흔히 사용됩니다.
작동 방식
허용할 IP 주소 또는 CIDR 범위 목록을 설정합니다.
허용된 IP에서 전송된 요청은 수락됩니다.
허용 목록에 없는 IP에서 전송된 요청은 거부됩니다.
IP 허용 목록은 다음 단위로 적용할 수 있습니다.
조직 단위 또는
프로젝트 단위
이용 대상
IP 허용 목록은 모든 API 고객이 사용할 수 있습니다.
IP 허용 목록을 설정하려면 아래 단계를 따르세요.
IP 허용 목록 설정
참고: IP 주소 또는 CIDR 범위는 최대 50개까지 추가할 수 있습니다.
설정을 엽니다.
보안을 선택합니다.
IP 허용 목록을 선택합니다.
IP 주소 또는 CIDR 범위를 하나 이상 추가합니다.
(선택 사항) 확인 도구를 사용해 IP가 허용 목록에 포함되어 있는지 확인합니다.
다음 중 하나에 허용 목록을 적용합니다.
특정 프로젝트 또는
조직 전체
실제로 사용할 환경에서 요청을 테스트합니다.
조직 전체에 적용하기 전에 단일 프로젝트부터 시작하는 것이 좋습니다.
변경 사항이 적용되기까지 최대 15분이 걸릴 수 있습니다.
참고: IP 허용 목록을 설정하려면 조직 내에서 적절한 권한이 있어야 합니다.
문제 해결
예기치 않게 요청이 실패하는 경우:
요청이 허용된 IP 주소에서 전송되는지 확인하세요.
인프라의 IP 주소가 변경되었는지 확인하세요.
설정한 IP 범위가 정확한지 검토하세요.
설정 변경 사항이 반영되도록 최대 15분 동안 기다려 주세요.
확인 도구를 사용해 IP가 허용되는지 확인하세요.
요청이 차단되면 어떻게 되나요?
허용 목록에 없는 IP 주소에서 전송된 요청은 실패하며 다음을 반환합니다.
HTTP 상태: 401 Unauthorized
오류 코드: ip_not_authorized
응답 예시:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
자주 묻는 질문
IP 허용 목록으로 API 키의 모든 무단 사용을 방지할 수 있나요?
아니요. IP 허용 목록은 API 요청이 전송되는 위치를 제한하여 위험을 줄이는 데 도움이 되지만, 모든 형태의 오용을 완전히 방지하지는 못합니다. 키의 안전한 보관, 주기적인 키 교체, 강력한 계정 보안 등 다른 보안 모범 사례와 함께 사용해야 합니다. 보안을 더욱 강화하려면 도움말 센터의 API 키 보안 모범 사례 및 무단 사용 방지 가이드를 확인하세요.
IP 허용 목록이 지연 시간에 영향을 미치나요?
IP 허용 목록을 사용하면 일부 경우에, 주로 최초 요청 시 아주 짧은 지연이 발생할 수 있습니다. 전반적인 API 성능에는 큰 영향을 미치지 않을 것으로 예상됩니다.
IP 허용 목록 때문에 요청이 실패하는지 어떻게 알 수 있나요?
IP 허용 목록 때문에 실패한 요청은 다음을 반환합니다.
HTTP status: 401 UnauthorizedError code: ip_not_authorized