신뢰할 수 있는 IP

승인되지 않은 IP 주소에서 API 키로 호출이 오면, 누군가 그 주소를 승인할 때까지 호출을 보류합니다. 유출된 키가 새로운 곳에서 쓰여도 돌아가는 것은 모델의 응답이 아니라 거부입니다.

콘솔 사이드바 위치(해당 기능이 계정에 적용되면 표시됩니다): Settings › Security 열기 ↗

진행 단계

  1. 설정 › 보안을 열고 새 IP 승인 필요를 켭니다. 대화상자에는 지난 7일 동안 각 키가 사용된 주소가 표시되며, 공인 주소는 선택된 상태입니다. 모르는 주소는 선택을 해제한 뒤 켜세요. 이 설정은 워크스페이스 소유자와 관리자만 바꿀 수 있으며, 게이트웨이가 실제 클라이언트 주소를 볼 수 없으면(모든 호출이 프록시 뒤의 사설 주소에서 오는 것처럼 보이면) 켤 수 없습니다.
  2. 이후 다른 주소에서 온 호출은 403, 오류 코드 ip_not_trusted로 거부됩니다. 오류에는 게이트웨이가 확인한 주소와 승인 페이지 링크(ip, approve_url 필드)가 담깁니다. 키를 만든 사람에게는 주소, 위치, 클라이언트, 요청한 모델(관리 키라면 호출한 작업)이 적힌 이메일이 갑니다. 워크스페이스에 속한 관리 키이거나 만든 사람이 워크스페이스를 떠난 키라면 소유자와 관리자에게 갑니다.
  3. 링크를 열고 로그인한 뒤 그 주소를 승인합니다. 나가는 주소가 바뀌는 클라이언트라면 그 대역(IPv4는 /24, IPv6는 /64)을 승인할 수도 있고, 거부할 수도 있습니다. 승인된 주소에서 오는 다음 호출부터 통과합니다.
  4. 신뢰할 수 있는 IP 목록에는 키가 사용된 주소가 위치, 상태와 함께 표시됩니다. 아는 주소는 클릭 한 번으로 신뢰하고, IP 추가로 주소나 대역(IPv4는 /16, IPv6는 /32까지)을 직접 추가하거나 삭제할 수 있습니다.

제한과 유의 사항

  • 신뢰는 키 단위입니다. 어떤 주소를 승인해도 그 주소에서 통과하는 것은 해당 키뿐이며, 워크스페이스의 다른 키는 해당되지 않습니다. 추론 키와 관리 키 모두에 적용됩니다.
  • 자체 IP 허용 목록이 있는 키는 목록에 /16(IPv4)이나 /32(IPv6)보다 넓은 대역이 없으면 영향을 받지 않고, 그 허용 목록만으로 판단됩니다. 0.0.0.0/0처럼 더 넓은 대역이 들어 있는 키는 다른 키와 마찬가지로 승인이 필요합니다. 새 IP 승인 필요를 끄면 모든 주소에서 다시 호출할 수 있고, 신뢰한 주소는 다음을 위해 그대로 남습니다.
  • 키를 만든 사람과 워크스페이스 소유자, 관리자가 승인할 수 있습니다(워크스페이스에 속한 관리용 키는 소유자와 관리자만). 승인은 콘솔에 로그인해서 합니다. 이메일에는 승인 버튼이 없으므로 전달된 이메일로는 아무것도 승인할 수 없습니다.
  • 대기 중인 요청은 7일 뒤 만료됩니다. 거부한 주소에서 온 호출은 이후 30일 동안 새 요청이나 이메일 없이 계속 거부됩니다. 실행할 때마다 새 주소로 호출하는 서버리스 함수와 CI 러너는 매번 보류됩니다. 이런 경우에는 IP 허용 목록을 설정한 키를 쓰거나 그 대역을 신뢰하세요.