API 조직 접근 차단

API 조직 접근 차단 기능을 사용하면 네트워크에서 사용자가 접근할 수 있는 API 조직을 제한할 수 있습니다. 프록시 또는 보안 액세스 서비스 에지(SASE) 서비스에서 접근을 허용할 조직의 ID 목록을 설정하세요.

작동 방식

• 사용자 지정 허용 목록 헤더 네트워크 설정에 사용자 지정 HTTP 헤더 OpenAI-Allowed-Organization-Ids를 추가해 접근을 허용할 API 조직을 지정합니다. 헤더에는 org-…와 같은 조직 ID를 하나 이상 입력할 수 있습니다. 여러 개를 입력할 때는 공백 없이 쉼표로 구분하세요.
• API 플랫폼의 허용 목록 적용 방식
  • 사용자가 해당 네트워크에서 API 플랫폼에 로그인하면 OpenAI는 헤더를 읽고 사용자가 접근하려는 API 조직의 ID가 OpenAI-Allowed-Organization-Ids 헤더에 있는지 확인합니다.
  • 사용자가 헤더에 없는 조직에 접근하려고 하면 OpenAI는 해당 요청을 자동으로 거부하고 상태 코드 403을 반환해 접근을 차단합니다. 사용자는 헤더에 있는 조직에만 접근할 수 있습니다.

설정

1단계: 조직 ID 찾기

특정 조직에 대한 접근을 허용하려면 허용할 각 조직의 ID를 복사하세요. 조직 ID는 API 플랫폼의 조직 설정 페이지에서 확인할 수 있습니다.

• API 플랫폼 계정에 로그인한 다음 원하는 조직으로 전환하세요.
• 조직 설정 페이지로 이동해 조직 ID를 기록하세요. 조직 ID의 예시는 org-Tkxfm8owx4zIPaJGNDVrPs6m입니다.

2단계: 헤더 설정하기

프록시 또는 보안 액세스 서비스 에지(SASE) 서비스를 통해 헤더를 전송하도록 네트워크를 설정하세요.

• 여러 조직에 대한 접근을 허용하려면 조직 ID를 공백 없이 쉼표로 구분해 입력하세요.
• 헤더를 적용할 URL 지정
  • https://api.openai.com/*로 보내는 요청에만 헤더를 적용하도록 프록시 또는 SASE 서비스를 설정하세요.

3단계: 설정 확인하기

헤더를 설정한 후 규칙이 적용되는 네트워크에 연결된 기기에서 조직 접근을 테스트하세요.

1. 다음 두 조직에 모두 접근할 수 있는 계정으로 API 플랫폼에 로그인하세요.
   • 허용 목록에 있는 조직
   • 허용 목록에 없는 조직
2. 허용 목록에 있는 조직을 열어 접근할 수 있는지 확인하세요.
3. 허용 목록에 없는 조직을 열어 보세요. 접근이 차단되고 오류 상태 코드 403이 반환되는지 확인하세요.
4. 여러 조직에 대한 접근을 허용했다면 각 조직에 접근할 수 있는지 확인하세요.

결과가 예상과 다르면 프록시 또는 SASE 규칙이 테스트 기기에 적용되는지, 헤더에 올바른 조직 ID가 있는지 확인하세요.

접근 오류 해결하기

• 상태 코드 403 사용자가 허용되지 않은 API 조직에 접근하려고 하면 오류가 표시됩니다. 오류의 상태 코드는 403이며, 메시지에는 해당 조직에 접근할 권한이 없다고 표시됩니다.
• 상태 코드 400 조직 ID가 유효하지 않은 경우처럼 헤더 값의 형식이 잘못되면 해당 헤더가 포함된 모든 요청이 실패하고 오류 상태 코드 400이 반환됩니다.