신뢰할 수 있는 IP
승인되지 않은 IP 주소에서 API 키로 호출이 오면, 누군가 그 주소를 승인할 때까지 호출을 보류합니다. 유출된 키가 새로운 곳에서 쓰여도 돌아가는 것은 모델의 응답이 아니라 거부입니다.
콘솔 사이드바 위치(해당 기능이 계정에 적용되면 표시됩니다): Settings › Security 열기 ↗
진행 단계
- 설정 › 보안을 열고 새 IP 승인 필요를 켭니다. 대화상자에는 지난 7일 동안 각 키가 사용된 주소가 표시되며, 공인 주소는 선택된 상태입니다. 모르는 주소는 선택을 해제한 뒤 켜세요. 이 설정은 워크스페이스 소유자와 관리자만 바꿀 수 있으며, 게이트웨이가 실제 클라이언트 주소를 볼 수 없으면(모든 호출이 프록시 뒤의 사설 주소에서 오는 것처럼 보이면) 켤 수 없습니다.
- 이후 다른 주소에서 온 호출은
403, 오류 코드ip_not_trusted로 거부됩니다. 오류에는 게이트웨이가 확인한 주소와 승인 페이지 링크(ip,approve_url필드)가 담깁니다. 키를 만든 사람에게는 주소, 위치, 클라이언트, 요청한 모델(관리 키라면 호출한 작업)이 적힌 이메일이 갑니다. 워크스페이스에 속한 관리 키이거나 만든 사람이 워크스페이스를 떠난 키라면 소유자와 관리자에게 갑니다. - 링크를 열고 로그인한 뒤 그 주소를 승인합니다. 나가는 주소가 바뀌는 클라이언트라면 그 대역(IPv4는 /24, IPv6는 /64)을 승인할 수도 있고, 거부할 수도 있습니다. 승인된 주소에서 오는 다음 호출부터 통과합니다.
- 신뢰할 수 있는 IP 목록에는 키가 사용된 주소가 위치, 상태와 함께 표시됩니다. 아는 주소는 클릭 한 번으로 신뢰하고, IP 추가로 주소나 대역(IPv4는 /16, IPv6는 /32까지)을 직접 추가하거나 삭제할 수 있습니다.
제한과 유의 사항
- 신뢰는 키 단위입니다. 어떤 주소를 승인해도 그 주소에서 통과하는 것은 해당 키뿐이며, 워크스페이스의 다른 키는 해당되지 않습니다. 추론 키와 관리 키 모두에 적용됩니다.
- 자체 IP 허용 목록이 있는 키는 목록에 /16(IPv4)이나 /32(IPv6)보다 넓은 대역이 없으면 영향을 받지 않고, 그 허용 목록만으로 판단됩니다. 0.0.0.0/0처럼 더 넓은 대역이 들어 있는 키는 다른 키와 마찬가지로 승인이 필요합니다. 새 IP 승인 필요를 끄면 모든 주소에서 다시 호출할 수 있고, 신뢰한 주소는 다음을 위해 그대로 남습니다.
- 키를 만든 사람과 워크스페이스 소유자, 관리자가 승인할 수 있습니다(워크스페이스에 속한 관리용 키는 소유자와 관리자만). 승인은 콘솔에 로그인해서 합니다. 이메일에는 승인 버튼이 없으므로 전달된 이메일로는 아무것도 승인할 수 없습니다.
- 대기 중인 요청은 7일 뒤 만료됩니다. 거부한 주소에서 온 호출은 이후 30일 동안 새 요청이나 이메일 없이 계속 거부됩니다. 실행할 때마다 새 주소로 호출하는 서버리스 함수와 CI 러너는 매번 보류됩니다. 이런 경우에는 IP 허용 목록을 설정한 키를 쓰거나 그 대역을 신뢰하세요.