Claude Platform Docs
관리인증

IP 허용 목록

신뢰할 수 있는 특정 IP 주소로 접근을 제한하여 조직을 보호하세요.

“IP allowlisting”(IP 허용 목록)은 적용 대상 요청을 특정 IP 범위에서만 허용하여 조직을 보호합니다. 즉, API 키가 유출되더라도 공격자가 해당 키를 사용하기가 훨씬 어려워집니다. 이를 통해 데이터 유출을 방지하고 악용으로 인한 요금 부과 가능성을 줄일 수 있습니다.

허용 목록은 키가 작동하는 위치를 제한할 뿐, 작동 기간을 제한하지는 않습니다. 짧은 키 만료도 함께 설정하거나, 정적 키 사용을 중단하려면 Workload Identity Federation으로 전환하는 것이 좋습니다. 이 방법이 허용 목록만 사용하는 것보다 더 안전합니다.

작동 방식

조직 관리자 또는 소유자가 설정에서 IP 범위 목록을 구성합니다. 이 범위 목록은 조직 전체에 적용됩니다. 적용 대상 요청마다 Anthropic은 요청의 공개 IP 주소를 목록과 비교하고, 허용되지 않은 경우 요청을 거부합니다.

  • 목록 외부의 주소에서 적용 대상 엔드포인트로 보낸 API 요청은 거부됩니다. 예를 들어 Messages API는 Your IP address isn't in this organization's allowed range. 메시지와 함께 403 permission_error를 반환합니다.
  • 허용되지 않은 주소에서 접속하는 사용자는 Your current network can’t access this organization이라는 제목의 페이지를 보게 됩니다. 조직 관리자도 차단되지만, 접근 차단을 방지하기 위해 선택적으로 관리자에게 복구 경로를 제공할 수 있으며, 이 경우 관리자는 허용 목록 설정에만 접근할 수 있습니다.

Claude Platform 조직

허용 목록이 적용되는 범위

제한 사항도 참조하세요.

Claude Enterprise 조직

Claude Enterprise 조직에는 자체 IP 허용 목록이 있어, 특정 IP 범위에서만 적용 대상 앱에 접근할 수 있도록 허용합니다. 즉, 사용자의 로그인 정보가 도용되더라도 공격자가 이를 사용하기가 훨씬 어려워집니다. 이 목록은 소유자를 포함한 조직 전체에 적용됩니다. 소유자와 기본 소유자가 이를 설정할 수 있습니다. 허용 목록을 켜기 전에 접근 차단 방지를 읽어 보세요.

허용 목록이 적용되는 앱

목록 외부의 사용자는 다음에서 조직에 대한 접근 권한을 잃게 됩니다:

  • 브라우저의 Claude, 데스크톱 앱, 모바일 앱
  • 사용자가 Claude 계정으로 로그인한 경우의 Claude Code
  • Claude in Chrome, Office 추가 기능, Cowork, Remote Tools

여기에는 이러한 앱의 커넥터와 Artifacts가 포함되며, 사용자가 조직 외부에 공유한 Artifacts는 제외됩니다. Claude Science의 경우 Claude Science 관리자 제어의 Identity and access를 참조하세요.

허용 목록은 이 조직에만 적용되는 키를 사용하는 Admin API와 Compliance API에도 적용됩니다.

제한 사항도 참조하세요.

사용자에게 예상되는 사항

웹과 데스크톱 앱에서 차단된 사용자는 Your current network can’t access this organization이라는 제목의 페이지를 보게 됩니다. 소유자도 차단되지만, 접근 차단을 방지하기 위해 선택적으로 소유자에게 복구 경로를 제공할 수 있으며, 이 경우 소유자는 허용 목록 설정에만 접근할 수 있습니다. Claude Code에서는 차단된 사용자에게 Your IP address isn't in this organization's allowed range. 메시지와 함께 403 API 오류가 표시됩니다.

  • 다른 계정: 차단된 사용자도 여전히 로그인하여 다른 조직이나 개인 계정을 사용할 수 있습니다.
  • 원격 사용자: 모바일 데이터를 사용하는 휴대폰, 가정용 Wi-Fi, VPN에 연결되지 않은 노트북은 목록에 있는 네트워크를 통해 연결하기 전까지 차단됩니다.
  • 프록시: 일부 기능은 bridge.claudeusercontent.com을 통해 연결됩니다: Claude in Chrome, Cowork, Remote Tools, 그리고 Office 추가 기능의 앱 간 작업. 프록시가 이 호스트로의 트래픽을 claude.ai 및 api.anthropic.com과 다른 주소로 내보내는 경우, 해당 주소도 목록에 추가하세요.

제한 사항

  • Claude Platform: 허용 목록은 Claude Managed Agents 엔드포인트에 대한 요청에 적용되며, 에이전트 자체에는 적용되지 않습니다. Claude Managed Agents 런타임의 어떤 네트워킹에도 적용되지 않습니다. 허용 목록은 Claude in Amazon Bedrock, Claude Platform on AWS, Claude Models on Google Cloud 또는 Claude in Microsoft Foundry에는 적용되지 않습니다.
  • Claude Enterprise: Claude Design, Claude in Slack, Claude Academy는 적용 대상이 아닙니다. 사용자가 차단될 때 Claude가 채팅에서 작업을 수행 중이었다면, 해당 작업은 최대 24시간 동안 계속될 수 있습니다. 사용자는 목록 외부에서 해당 채팅을 열거나 제어할 수 없습니다.

허용 목록 켜기

  1. 토글 켜기

    조직의 설정 페이지로 이동하세요:

    IP allowlist 토글을 켜세요. 저장하기 전까지는 아무것도 변경되지 않습니다.

  2. 범위 추가 및 저장

    Add entry(Claude Console) 또는 Add IP range(claude.ai)를 클릭하고 하나 이상의 주소 또는 범위를 쉼표로 구분하여 입력한 다음 Enter 키를 누르세요. 현재 접속 중인 네트워크를 포함하여 서버, CI, 사용자가 접속하는 각 네트워크를 나열하세요. Anthropic은 접근 차단을 방지하기 위해 Allow admins to access this settings page from any IP address(Claude Console) 또는 Allow owners to access this settings page from any IP address(claude.ai) 체크박스가 선택되어 있는지 확인할 것을 권장합니다. 그런 다음 Save를 클릭하고 확인하세요.

  3. 트래픽 확인

    변경 사항이 적용되기까지 최대 15분이 걸릴 수 있습니다. 매일 또는 매주만 실행되는 작업을 포함하여 애플리케이션에서 403 permission_error 응답이 발생하는지 지켜보고, 누락된 주소가 있으면 추가하세요. Claude Enterprise 조직에서는 각 네트워크의 사용자에게 여전히 Claude를 열 수 있는지 확인해 달라고 요청하세요. 이러한 조직에서는 이미 열려 있는 연결, Office 추가 기능, Remote Tools에 변경 사항이 반영되기까지 더 오래 걸릴 수 있습니다.

항목 형식

  • 형식: IPv4 또는 IPv6 주소를 허용 목록에 추가할 수 있습니다. 각 항목은 단일 주소(203.0.113.5) 또는 CIDR 범위(203.0.113.0/24, 2001:db8::/32)일 수 있으며, 범위는 IPv4의 경우 /8, IPv6의 경우 /32보다 넓을 수 없습니다. 목록에는 최대 1,000개의 항목을 담을 수 있습니다.
  • 공개 주소만 사용: 10.0.0.0/8과 같은 사설 범위가 아니라, 트래픽이 네트워크에서 나가는 주소를 나열하세요. 공유 프록시 주소를 추가하는 경우, 유출된 키나 도용된 로그인 정보를 가진 공격자가 해당 프록시를 통해 이를 사용할 수 있다는 점에 유의하세요.

접근 차단 방지

저장할 때 설정 페이지는 사용자가 자신의 접근을 차단하지 않도록 현재 주소를 목록과 대조하여 확인합니다. 하지만 서버, 팀원 또는 내일 접속할 수도 있는 주소는 확인하지 않습니다.

  • 모든 네트워크를 먼저 나열하세요: 데이터 센터, CI 시스템, 사무실, VPN, 프록시, 그리고 모든 자체 호스팅 샌드박스의 워커를 공개 IPv4 및 IPv6 주소와 함께 포함하세요. 가정용 및 모바일 주소는 예고 없이 자주 변경될 수 있다는 점에 유의하세요.
  • 복구 경로를 유지하세요: Anthropic은 Allow admins to access this settings page from any IP address(Claude Console) 또는 Allow owners to access this settings page from any IP address(claude.ai) 체크박스를 선택할 것을 권장합니다. 그러면 관리자(claude.ai에서는 소유자)가 어디서든 목록을 수정할 수 있습니다. 단점은 관리자나 소유자의 세션을 탈취한 공격자가 원격 위치에서 허용 목록을 변경할 수 있다는 것입니다. 조직에 Compliance API를 설정한 경우 해당 Activity Feed가 허용 목록의 변경 사항을 기록하므로 이를 감사할 수 있습니다.

접근이 차단된 경우

Claude Enterprise 조직에서는 관리자가 목록을 변경할 수 없으므로, 아래 단계에서 "관리자나 소유자"는 소유자 또는 기본 소유자를 의미합니다.

  1. 목록에 있는 네트워크에서 다시 접속하세요: 사무실 네트워크나 VPN에 연결한 다음 Try again을 클릭하세요. Try again 버튼이 없으면 페이지를 새로고침하세요.
  2. 다른 관리자나 소유자에게 요청하세요: 목록에 있는 네트워크의 관리자나 소유자가 주소를 추가할 수 있습니다.
  3. 현재 위치에서 목록을 수정하세요: 관리자나 소유자이고 복구 경로를 유지하세요의 체크박스가 선택되어 있다면, 브라우저에서 Claude Console 또는 Claude를 열고 Open IP allowlist를 클릭하거나 Identity and access 페이지(claude.ai에서는 Organization and access)로 이동하세요. Add it을 클릭하여 현재 주소를 추가하거나 허용 목록을 끈 다음, Save를 클릭하고 확인하세요. 접근이 복구되기까지 최대 15분이 걸릴 수 있습니다.
  4. Anthropic에 문의하세요: 어떤 관리자나 소유자도 페이지에 접근할 수 없다면 Anthropic 지원팀에 허용 목록을 꺼 달라고 요청하세요.

이 페이지가 도움이 되었나요?