버킷 IP 필터링 규칙 만들기

이 페이지에서는 버킷 IP 필터링 규칙을 만드는 방법을 설명합니다. 버킷 IP 필터링을 사용 설정하면 버킷 IP 필터링 규칙에 지정된 IP 주소를 기준으로 수신 요청을 검사하여 버킷에 대한 액세스를 제어할 수 있습니다. 자세한 내용은 버킷 IP 필터링을 참고하세요.

필요한 역할

버킷 IP 필터링 규칙을 만드는 데 필요한 권한을 얻으려면 관리자에게 버킷에 대한 스토리지 관리자 (roles/storage.admin) 역할을 부여해 달라고 요청하세요. 이 역할에는 버킷 IP 필터링 규칙을 만드는 데 필요한 권한이 포함되어 있습니다.

필요한 정확한 권한을 보려면 필수 권한 섹션을 확장하세요.

커스텀 역할로도 이러한 권한을 얻을 수 있습니다. 다른 사전 정의된 역할로도 이 권한을 얻을 수 있습니다. 어떤 역할이 어떤 권한과 연결되어 있는지 확인하려면 Cloud Storage에 대한 IAM 역할을 참조하세요.

버킷에 대한 역할 부여는 버킷에 IAM 사용을 참조하세요.

버킷 IP 필터링 규칙 만들기

버킷 IP 필터링 구성

이 섹션에서는 Cloud Storage 버킷에 대한 액세스를 제어하는 버킷 IP 필터링 JSON 파일 구성의 예를 제공합니다. 다음 예시 중 하나라도 사용하여 수신 요청에 대한 액세스 권한을 부여할 수 있습니다.

• 모든 공개 IP 주소 (IPv4 또는 IPv6):

  다음 구성은 모든 공개 IPv4 또는 IPv6 주소에 대한 액세스 권한을 부여하지만 VPC에서 발생한 트래픽은 차단합니다.

  {
  "ipFilterConfig": {
    "mode": "Enabled"
    "publicNetworkSource": {
      "allowedIpCidrRanges": ["0.0.0.0/0", "::/0"]
    }
  }
  }

• 특정 공개 IP 범위:

  • 다음 구성 예에서는 192.0.2.0/24 공개 IPv4 주소 범위에 대한 액세스 권한을 부여하지만 모든 VPC에서 발생하는 트래픽을 차단합니다.

    {
    "ipFilterConfig": {
      "mode": "Enabled"
      "publicNetworkSource": {
        "allowedIpCidrRanges": ["192.0.2.0/24"]
      }
    }
    }

  • 다음 구성 예에서는 2001:db8::/32 공개 IPv6 주소 범위에 대한 액세스 권한을 부여하지만 모든 VPC에서 발생하는 트래픽을 차단합니다.

    {
    "ipFilterConfig": {
      "mode": "Enabled"
      "publicNetworkSource": {
        "allowedIpCidrRanges": ["2001:db8::/32"]
      }
    }
    }

• VPC 네트워크: 다음 구성을 사용하여 VPC 네트워크 내 리소스에 대한 액세스 권한을 부여할 수 있습니다. VPC 내의 모든 IP 주소 또는 VPC 내 특정 IP 범위에 대한 액세스 권한을 부여할 수 있습니다. 이러한 각 예시에서 PROJECT_ID는 VPC 네트워크가 있는 프로젝트 ID이고 NETWORK_NAME는 버킷에 액세스할 수 있는 VPC 네트워크의 이름입니다.

  • 다음 구성 예에서는 특정 VPC에서 오는 모든 IPv4 또는 IPv6 주소의 요청에 대한 액세스 권한을 부여하고 공개 IP 주소에서 발생하는 트래픽을 차단합니다.

    {
    "ipFilterConfig": {
      "mode": "Enabled"
      "vpcNetworkSources": [
          {
              "network": "projects/PROJECT_ID/global/networks/NETWORK_NAME",
              "allowedIpCidrRanges": ["0.0.0.0/0", "::/0"]
          },
      ]
    }
    }

  • 다음 구성 예에서는 외부 IPv4 주소가 192.0.2.0/24인 VM과 연결된 VPC의 요청에 대해서만 액세스 권한을 부여하고 공개 IP 주소에서 발생한 트래픽을 차단합니다.

    {
    "ipFilterConfig": {
      "mode": "Enabled"
    "vpcNetworkSources": [
          {
              "network": "projects/PROJECT_ID/global/networks/NETWORK_NAME",
              "allowedIpCidrRanges": ["192.0.2.0/24"]
          },
      ]
    }
    }

  • 다음 구성 예에서는 외부 IP 주소가 없는 VM에 연결된 내부 IPv4 서브넷 범위가 있는 VPC에서 발생하는 요청에 대해서만 액세스 권한을 부여하고 공개 IP 주소에서 발생하는 트래픽을 차단합니다.

    {
    "ipFilterConfig": {
      "mode": "Enabled"
    "vpcNetworkSources": [
          {
              "network": "projects/PROJECT_ID/global/networks/NETWORK_NAME",
              "allowedIpCidrRanges": ["IP_ADDRESS"]
          },
      ]
    }
    }

    여기서 IP_ADDRESS는 내부 IPv4 서브넷 범위입니다.

  • 다음 구성 예에서는 외부 IPv6 주소 범위가 2001:db8::/32인 VM에 연결된 이중 스택 IPv4 및 IPv6 서브넷 범위가 있는 VPC에서 발생하는 요청에 대해서만 액세스 권한을 부여하고 공개 IP 주소에서 발생하는 트래픽을 차단합니다.

    {
    "ipFilterConfig": {
      "mode": "Enabled"
    "vpcNetworkSources": [
          {
              "network": "projects/PROJECT_ID/global/networks/NETWORK_NAME",
              "allowedIpCidrRanges": ["2001:db8::/32"]
          },
      ]
    }
    }

다음 단계

• 버킷 IP 필터링 규칙 업데이트
• 버킷 IP 필터링 규칙 가져오기
• 버킷 IP 필터링 규칙 나열
• 버킷 IP 필터링 사용 중지