關於透過端點存取全域 Google API

本文概略說明用於存取全域 Google API 的 Private Service Connect 端點。

根據預設,如果應用程式使用 Cloud Storage 等 Google 服務,應用程式會連線至該服務的預設 DNS 名稱,例如 storage.googleapis.com。Google 服務的預設 DNS 名稱會解析為可公開轉送的 IP 位址。不過,從Google Cloud 資源傳送至這些 IP 位址的流量,仍會保留在 Google 網路中。

您可以使用 Private Service Connect,在虛擬私有雲網路中,以全域內部 IP 位址建立私人端點。您可以將 DNS 名稱指派給這些內部 IP 位址,並使用有意義的名稱,例如 storage-vialink1.p.googleapis.com 和 bigtable-adsteam.p.googleapis.com。這些名稱和 IP 位址是虛擬私有雲網路和任何地端部署網路的內部名稱和 IP 位址,這些網路使用 Cloud VPN 通道或 VLAN 連結連線至虛擬私有雲網路。您可以控管哪些流量傳至哪個端點,並證實這些流量會留在 Google Cloud中。

這個選項可讓您存取 API 套件中包含的所有 Google API 和服務。

圖 1. Private Service Connect 可讓您使用虛擬私有雲網路專屬的端點,將流量傳送至 Google API (按一下即可放大)。

功能與相容性

下表摘要列出用於存取全域 Google API 的端點支援的功能。

設定 詳細資料
消費者設定 (端點)
全球可達性 使用內部全域 IP 位址
Cloud Interconnect 流量
Cloud VPN 流量
透過虛擬私有雲網路對等互連存取
透過 NCC 傳播連線 (預先發布版)
自動 DNS 設定
IP 版本 IPv4
Producer
支援的服務 支援的全域 Google API

混合存取權

您可以使用支援的連線地端部署主機,存取用於存取 Google API 的 Private Service Connect 端點。詳情請參閱「透過地端部署主機存取端點」。

透過 Service Directory 自動設定 DNS

端點會註冊至 Service Directory。Service Directory 是用於儲存、管理及發布服務的平台。建立端點來存取 Google API 和服務時,請選取 Service Directory 區域和 Service Directory 命名空間。

Service Directory 區域

Service Directory 是區域性服務,您選取的區域會定義 Service Directory 控制層的位置。各區域之間沒有功能差異,但您可能會基於管理原因而有偏好。

在虛擬私有雲網路中為 Google API 建立第一個端點時,您選取的區域會做為該網路中所有後續端點的預設區域。如果網路尚未設定區域,且您未指定區域,則區域會設為 us-central1。網路中的所有端點都必須使用相同的 Service Directory 區域。

Service Directory 命名空間

在虛擬私有雲網路中為 Google API 建立第一個端點時,您選取的命名空間會做為該網路中所有後續建立端點的預設命名空間。如果尚未為網路設定命名空間,且您未指定命名空間,系統會使用產生的命名空間。網路中的所有端點都必須使用相同的 Service Directory 命名空間。您選擇的命名空間只能用於存取 Google API 的端點。您可以將相同的命名空間用於多個網路中的端點。

建立端點時,系統會建立下列 DNS 設定:

  • 系統會為 p.googleapis.com 建立 Service Directory 私人 DNS 區域。

  • 系統會在 p.googleapis.com 中,為一些可透過 Private Service Connect 使用、且預設 DNS 名稱結尾為 googleapis.com 的常用 Google API 和服務建立 DNS 記錄。舉例來說,如果端點名稱為 xyz,系統會為 storage-xyz.p.googleapis.com、compute-xyz.p.googleapis.com 和 API 套件中其他常用的 API 建立 DNS 記錄。

    如要為 p.googleapis.com 中沒有 DNS 記錄的 API 和服務建立 DNS 記錄,請參閱「建立 DNS 記錄」的操作說明。

可用的服務會因您選取 all-apis 或 vpc-sc API 套件而異。

系統會為每個包含端點的虛擬私有雲網路,建立一個 Service Directory DNS 區域。

在虛擬私有雲網路的所有區域中,都可以存取端點的 DNS 名稱。

DNS 解析

與端點位於相同虛擬私有雲網路的用戶端,在解析主機名稱時,可以查詢自動建立的私人 DNS 區域,以及您手動建立的任何私人區域。如果 Compute Engine 執行個體透過端點 (例如 storage-xyz.p.googleapis.com) 向服務傳送要求,用戶端會查詢對應的私人 DNS 區域來解析主機名稱,並接收 Private Service Connect 端點的 IP 位址。

不過,如果用戶端查詢的主機名稱不存在於私人 DNS 區域,查詢就會轉送至 Google 的公開 DNS 伺服器。googleapis.com (和其他 Google 網域) 的公開 DNS 記錄包含萬用字元項目,這表示所有主機名稱都會解析為 IP 位址。舉例來說,如果虛擬私有雲網路中沒有 p.googleapis.com 的私人 DNS 區域,而您對 storage-xyz.p.googleapis.com 執行 DNS 查詢,主機名稱會解析為屬於 Cloud Front End 的公開 IP 位址,而「不是」Private Service Connect 端點的內部 IP 位址。

如果您是從混合網路中的用戶端存取 Private Service Connect 端點,則須進行額外設定,混合用戶端才能正確解析 Private Service Connect 端點的主機名稱。詳情請參閱「透過混合式網路存取端點」。

支援的 API

建立端點來存取 Google API 和服務時,您必須選擇要存取的 API 套件:所有 API (all-apis) 或 VPC-SC (vpc-sc):

API 套件僅支援透過 TCP 傳輸的 HTTP 通訊協定 (HTTP、HTTPS 和 HTTP/2)。不支援其他所有通訊協定,包括 MQTT 和 ICMP。

API 套裝組合 支援的服務 應用實例
all-apis

無論是否支援 VPC Service Controls,都能啟用大多數 Google API 和服務的 API 存取權。包括 Google 地圖、Google Ads、 Google Cloud和大多數其他 Google API 的 API 存取權,包括下列清單。不支援 Gmail 和 Google 文件等 Google Workspace 網頁應用程式。不支援任何互動式網站。

相符的網域名稱:

  • accounts.google.com (僅支援服務帳戶 OAuth 驗證所需的路徑;使用者帳戶驗證為互動式,因此不支援)
  • *.aiplatform-notebook.cloud.google.com
  • *.aiplatform-notebook.googleusercontent.com
  • appengine.google.com
  • *.appspot.com
  • *.backupdr.cloud.google.com
  • backupdr.cloud.google.com
  • *.backupdr.googleusercontent.com
  • backupdr.googleusercontent.com
  • *.cloudfunctions.net
  • *.cloudproxy.app
  • *.composer.cloud.google.com
  • *.composer.googleusercontent.com
  • *.datafusion.cloud.google.com
  • *.datafusion.googleusercontent.com
  • *.dataproc.cloud.google.com
  • dataproc.cloud.google.com
  • *.dataproc.googleusercontent.com
  • dataproc.googleusercontent.com
  • *.developerconnect.dev
  • dl.google.com
  • gcr.io或*.gcr.io
  • *.googleapis.com

    不含*.rep.googleapis.com區域和多區域端點。

  • *.gke.goog
  • gstatic.com或*.gstatic.com
  • *.kernels.googleusercontent.com
  • *.ltsapis.goog
  • *.notebooks.byoid.googleusercontent.com
  • *.notebooks.cloud.google.com
  • notebooks.cloud.google.com
  • *.notebooks.googleusercontent.com
  • packages.cloud.google.com
  • pkg.dev 或 *.pkg.dev
  • pki.goog或*.pki.goog
  • *.run.app
  • source.developers.google.com
  • storage.cloud.google.com

在下列情況下,請選擇「all-apis」:

  • 您未使用 VPC Service Controls。
  • 您使用 VPC Service Controls,但也需要存取 VPC Service Controls 不支援的 Google API 和服務。1

vpc-sc

啟用 VPC Service Controls 支援的 Google API 和服務 API 存取權。

禁止存取不支援 VPC Service Controls 的 Google API 和服務。不支援 Google Workspace API 或 Google Workspace 網頁應用程式,例如 Gmail 和 Google 文件。

如果「只要」存取 VPC Service Controls 支援的 Google API 和服務,請選擇 vpc-sc。vpc-sc 套件不允許存取不支援 VPC Service Controls 的 Google API 和服務。1

1 如要限制使用者只能存取支援 VPC Service Controls 的 Google API 和服務,請使用 vpc-sc,因為這項服務可進一步降低資料竊取風險。使用 vpc-sc 會拒絕存取 VPC Service Controls 不支援的 Google API 和服務。詳情請參閱 VPC Service Controls 說明文件中的「設定私人連線」。

IP 位址規定

設定適用於全域 Google API 的 Private Service Connect 時,您必須提供要用於端點的 IP 位址。

該位址會計入專案的全域內部 IP 位址配額。

IP 位址必須符合下列規格:

  • 必須是單一 IP 位址,而非位址範圍。

  • 必須是有效的 IPv4 位址。可以是 RFC 1918 位址或非 RFC 1918 位址。系統不支援 IPv6 位址。

  • 不得位於虛擬私有雲網路中設定的子網路範圍內。

  • 不得位於虛擬私有雲網路中任何子網路的主要或次要 IP 位址範圍,也不得位於使用虛擬私有雲網路對接連線至虛擬私有雲網路的網路。

  • 不得與本機虛擬私有雲網路中的 /32 自訂靜態路由重疊。舉例來說,如果虛擬私有雲網路有 10.10.10.10/32 的自訂靜態路由,就無法為 Private Service Connect 保留 10.10.10.10 位址。

  • 如果您已將對接網路設為匯出自訂路由,並將虛擬私有雲網路設為匯入自訂路由,則該範圍不得與 /32 對接自訂靜態路由重疊。

  • 如果本機虛擬私有雲網路是自動模式虛擬私有雲網路,或與自動模式虛擬私有雲網路對等互連,則不得位於任何自動模式 IP 範圍 (10.128.0.0/9) 內。

  • 不得位於本機虛擬私有雲網路的分配 IP 範圍內。不過,該範圍可以位於對接虛擬私有雲網路中已分配的 IP 範圍內。

  • 除非您在同一個虛擬私有雲網路中,為 Private Service Connect 端點預留內部範圍的 IP 位址,否則該位址不得位於內部範圍。

  • 如果端點與目的地相同的自訂動態路徑重疊,則以端點優先。/32

  • 如果端點 IP 位址位於本機靜態路由、本機動態路由或對接自訂路由的目的地範圍內,且該路由的子網路遮罩短於 /32,則端點的優先順序較高。

用途

您可以在同一個虛擬私有雲網路中建立多個端點。傳送至特定端點的總頻寬沒有限制。由於端點使用全域內部 IP 位址,因此虛擬私有雲網路中的任何資源,或使用 Cloud VPN 通道或 Cloud Interconnect 連結連線的地端部署網路,都能使用這些端點。

如果有多個端點,您可以使用 Cloud Router 和防火牆規則指定不同的網路路徑。

  • 您可以建立防火牆規則,禁止部分 VM 透過端點存取 Google API,同時允許其他 VM 存取。

  • 您可以在 VM 執行個體上設定防火牆規則,禁止所有流量傳送至網際網路;傳送至 Private Service Connect 端點的流量仍會傳送至 Google。

  • 如果地端部署主機透過 Cloud VPN 通道或 VLAN 連結連至虛擬私有雲,您可以透過通道或 VLAN 傳送部分要求,並透過公開網際網路傳送其他要求。這項設定可讓您略過通道或 VLAN,存取 Google 圖書等不支援 Private Google Access 的服務。

    如要建立這項設定,請建立 Private Service Connect 端點,使用 Cloud Router 自訂路由 advertising advertise 端點 IP 位址,並啟用 Cloud DNS 傳入轉送政策。應用程式可以使用端點名稱,透過 Cloud VPN 通道或 VLAN 連結傳送部分要求,並使用預設 DNS 名稱透過網際網路傳送其他要求。

  • 如果您使用多個 VLAN 連結,將地端部署網路連線至虛擬私有雲網路,則可透過一個 VLAN 傳送部分地端部署流量,其餘流量則透過其他 VLAN 傳送,如圖 2 所示。這樣一來,您就能使用自己的廣域網路,而非 Google 的網路,並控管資料移動,以符合地理位置要求。

    如要建立這項設定,請建立兩個端點。在管理第一個 VLAN 的 Cloud Router BGP 工作階段中,為第一個端點建立自訂路由 advertising,並在管理第二個 VLAN 的 Cloud Router BGP 工作階段中,為第二個端點建立不同的自訂路由 advertising。設定為使用端點名稱的地端部署主機,會透過對應的 VLAN 連結傳送流量。

  • 您也可以在主動/主動拓撲中使用多個 VLAN 連結。如果您在管理 VLAN 的 Cloud Router 上,使用自訂路由 advertisement,advertise 相同的端點 IP 位址,則從地端部署系統傳送至端點的封包,會使用 ECMP 透過 VLAN 轉送。

    圖 2. 設定 Private Service Connect、Cloud Router 和地端部署主機,即可控管要使用哪個 VLAN 連結將流量傳送至 Google API (按一下即可放大)。

Shared VPC

一般來說,建議您在同一個 Google Cloud 專案中建立轉送規則和對應的位址資源。使用相同專案有助於避免專案刪除時發生問題。

不過,您無法在服務專案中建立位址資源,從主專案保留內部全域 IPv4 位址。如要建立以全域 Google API 組合為目標的端點,就必須使用這類 IP 位址。

您可以在服務專案中建立指定全域 Google API 組合的端點,並在設定中使用主專案的位址資源。不過,我們不建議建立這項設定。

如果您確實建立了這項設定,則必須在主專案中,將 Compute 網路使用者 (roles/compute.networkUser) 等角色授予服務專案管理員。這個角色包含必要的 compute.networks.use 和 compute.addresses.use 權限。

您無法使用 Google Cloud 控制台建立這項設定,必須使用 Google Cloud CLI 或 API。

定價

如要瞭解 Private Service Connect 的定價,請參閱「虛擬私有雲定價」頁面。

配額

您可以建立的 Private Service Connect 端點數量,取決於 PSC Google APIs Forwarding Rules per VPC Network 配額。詳情請參閱「配額」。

組織政策限制

組織政策管理員可以使用 constraints/compute.disablePrivateServiceConnectCreationForConsumers 限制,定義使用者無法建立轉送規則的端點類型組合。

如要瞭解如何建立使用這項限制的組織政策,請參閱「禁止用戶依連線類型部署端點」。

後續步驟