接続用に外向きの静的 IP アドレスを構成する

このページでは、接続に静的 IP アドレスを割り当てる方法について説明します。静的 IP アドレスを使用すると、バックエンドシステムへのアクセスを制限できるため、接続のセキュリティを強化できます。

Integration Connector をバックエンドシステムに接続する場合は、プライベート接続を使用できます。ただし、プライベート接続の設定を詳細に行いたくない場合は、バックエンドシステムをパブリック IP アドレスで公開してから、ファイアウォールルールでアクセスを制限することを検討してください。ファイアウォールルールでは、Integration Connectors から発信された IP アドレスのみをバックエンドシステムに接続できます。接続でパブリックエンドポイントに接続できるようにするには、次の大まかな手順を行う必要があります。

ファイアウォールを作成し、ファイアウォールの下り（外向き）トラフィックをルーティングします。
接続に静的 IP アドレスを割り当てます。
ファイアウォール内で割り当てられた静的 IP アドレスを許可リストに登録します。

ファイアウォールを作成して構成する手順については、このページでは扱いません。このページでは、接続に静的 IP アドレスを割り当てる方法のみを説明します。

デフォルトでは、Integration Connectors は自動的に IP アドレスを割り振ります。ただし、自動 IP アドレスではなく静的 IP アドレスを生成するように、Integration Connectors を構成できます。Integration Connectors は、リージョンレベルで静的 IP アドレスを割り当てます。たとえば、us-east1 リージョンの静的 IP アドレスは、us-west2 リージョンの静的 IP アドレスとは異なります。

接続に静的 IP アドレスを割り当てるには、次の手順を行います。

静的 IP アドレスを割り振る接続のリージョンを取得します。接続リージョンは、[接続] ページの [Location] 列で確認できます。
[接続] ページに移動
Google Cloud コンソールで、「Cloud Shell をアクティブにする」をクリックします。

Cloud Shell をアクティブにする

Google Cloud コンソールの下部で Cloud Shell セッションが開始し、コマンドラインプロンプトが表示されます。Cloud Shell はシェル環境です。Google Cloud CLI がすでにインストールされており、現在のプロジェクトの値もすでに設定されています。セッションが初期化されるまで数秒かかることがあります。

ヒント: この手順では Cloud Shell を開く方法を説明しますが、Integration Connectors の公開 API を呼び出すため、通常のターミナルでも次のコマンド実を実行できます。

Integration Connectors を構成して、手順 1 で取得したリージョンに静的 IP アドレスを割り当てます。Cloud Shell で次のコマンドを実行します。

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"networkConfig": {"egressMode": "static_ip"}}' \
https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/regionalSettings

LOCATION に、ステップ 1 で取得したリージョンを設定します。

このコマンドを実行すると、次のようなレスポンスが返されます。

{
"name": "projects/test-01/locations/us-central1/operations/operation-1696840994443-6074494b6d138-8215226d-516faaf8",
"metadata": {
  "@type": "type.googleapis.com/google.cloud.connectors.v1.OperationMetadata",
  "createTime": "2023-10-09T08:43:14.467058513Z",
  "target": "projects/test-01/locations/us-central1/regionalSettings",
  "verb": "update",
  "requestedCancellation": false,
  "apiVersion": "v1"
 },
"done": false
}

このコマンドは、オペレーション ID を返し、長時間実行オペレーション（LRO）を開始します。完了するまでに時間がかかることがあります。LRO が完了するまで待ちます。次のコマンドを使用して、オペレーションの進行状況を追跡できます。

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

静的 IP アドレスの割り振りが成功すると、次のようなレスポンスが返されます。

...
...
"response": {
  "@type": "type.googleapis.com/google.cloud.connectors.v1.RegionalSettings",
  "name": "projects/test-01/locations/us-central1/regionalSettings",
  "networkConfig": {
   "egressMode": "STATIC_IP",
    "egressIps": [
      "35.193.227.203",
      "34.133.63.9",
      "35.223.253.58",
      "34.170.27.253"
    ]
  }
}

このサンプルレスポンスでは、us-central1 リージョンに 4 つの静的 IP アドレスが割り振られ、リージョンの egressMode は STATIC_IP に設定されます。

ファイアウォールルールで静的 IP アドレス（ステップ 4 で取得したもの）を許可リストに登録してください。

リージョンの静的 IP アドレスを取得する

リージョン（ロケーション）に割り振られた静的 IP アドレスを取得する場合は、次のコマンドを実行します。

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/regionalSettings

このコマンドを実行すると、次のようなレスポンスが返されます。

  "response": {
    "@type": "type.googleapis.com/google.cloud.connectors.v1.RegionalSettings",
    "name": "projects/test-01/locations/us-central1/regionalSettings",
    "networkConfig": {
     "egressMode": "STATIC_IP",
      "egressIps": [
        "35.193.227.203",
        "34.133.63.9",
        "35.223.253.58",
        "34.170.27.253"
      ]
    }
  }

リージョンに自動 IP アドレスを割り当てる

リージョンの静的 IP アドレス構成を削除して IP アドレスを自動的に割り当てる場合は、ターミナルで次のコマンドを実行する必要があります。

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{"networkConfig": {"egressMode": "auto_ip"}}' \
    https://connectors.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/regionalSettings

前述の静的 IP アドレスの構成コマンドと同様に、このコマンドもオペレーション ID を返し、長時間実行オペレーション（LRO）を開始します。LRO は完了するまでに時間がかかることがあります。LRO が完了するまで待ちます。

考慮事項

リージョンに静的 IP アドレスを割り振る場合は、次の点を考慮してください。

予約された静的 IP アドレスのセットは、プロジェクト内のリージョンによって異なります。
リージョンの下り（外向き）モードを STATIC_IP から AUTO_IP に変更すると元の静的 IP アドレスのセットは保持されないため、下り（外向き）モードを再び STATIC_IP から AUTO_IP に変更すると、静的 IP アドレスの新しいセットが割り振られます。
下り（外向き）モードを AUTO_IP から STATIC_IP（またはその逆）に変更すると、数秒程度のダウンタイムが予想されます。