VPC プライベートエンドポイントの使用（プレビュー）

VPC インターフェイスエンドポイントの作成

1. App Services UI で、 App Settingsに移動し、 Private Endpointsタブをクリックします。

2. [Add Private Endpoint をクリックし、[General] をクリックします。

3. VPC ID とサブネット ID（カンマ区切りのリスト）を別々のフィールドに追加し、 Next ] をクリックします。

4. 生成されたVPC Interface Endpoint Commandをコピーします。 コマンドは次のようになります。

   aws ec2 create-vpc-endpoint \
     --vpc-endpoint-type Interface
     --service-name <App Services Endpoint Service Name> \
     --vpc-id <your-vpc-id> \
     --region <your-aws-deployment-region> \
     --subnet-ids <your-subnet-ids>

5. ターミナルで、生成されたAmazon Web Services CLIコマンドを実行してVPCエンドポイントを作成します。

アプリへのプライベートエンドポイントの追加

VPC にインターフェイスエンドポイントを作成したので、それをアプリに追加する必要があります。

1. 前のステップで実行した コマンドの出力、または VPCダッシュボードのエンドポイント詳細画面で、 エンドポイントID CLIAmazon Web ServicesVPCを見つけます。この値はvpce-から始まります。

2. 新しい VPC エンドポイントの ID をコピーして、App Services UI のYour VPC Endpoint IDフィールドに貼り付け、 Nextをクリックします。

3. これが最初に作成するプライベートエンドポイントである場合は、PrivateLink 接続外のリクエストからのすべてのアクセスを制限または開くために使用できるトグルが表示されます。 デフォルトでは、App Services は PrivateLink 接続外部からのすべてのリクエストをブロックします。 この設定は、このエンドポイントと作成する 追加のすべてのエンドポイントに適用されます。 詳細については、「アクセス制限の変更」を参照してください。

4. [Finish Endpoint Creation] をクリックします。

VPC インターフェイスエンドポイントの作成

1. List VPC プライベートエンドポイント サービスエンドポイントを呼び出します。

2. 応答オブジェクトをフィルタリングして、アプリの配置リージョンと作成するエンドポイント タイプのエントリを見つけます。

   curl https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/security/private_endpoint_service_infos \
   -H "Authorization: Bearer <access_token>"

   出力を非表示

   [
   {
      "cloud_provider_region": "aws-us-east-1",
      "service_name": "com.amazonaws.vpce.us-east-1.vpce-svc-0718bec2c0bdeab5c",
      "endpoint_type": "general"
   },
   ...
   ]

3. 前のステップで、目的のエントリからservice_nameフィールドを取得します。

4. Amazon Web Services CLI の create-vpc-endpoint コマンドを使用してVPCエンドポイントを作成します。App Services エンドポイント サービス名、 VPC ID、サブネット ID、 Amazon Web Services配置リージョンが必要です。 コマンドは次のようになります。

aws ec2 create-vpc-endpoint \
  --vpc-endpoint-type Interface
  --service-name <App Services Endpoint Service Name> \
  --vpc-id <your-vpc-id> \
  --region <your-aws-deployment-region> \
  --subnet-ids <your-subnet-ids>

アプリへのプライベートエンドポイントの追加

VPC にインターフェイスエンドポイントを作成したので、それをアプリに追加する必要があります。

1. 前のステップで実行した コマンドの出力、または VPCダッシュボードのエンドポイント詳細画面で、 エンドポイントID CLIAmazon Web ServicesVPCを見つけます。この値はvpce-から始まります。

2. VPC エンドポイントの ID が取得されたら、「 エンドポイント ID、クラウド配置リージョン、エンドポイントタイプを使用して VPC プライベートエンドポイントの作成」を呼び出します。 たとえば、 aws-us-east-1を使用する場合は次のようになります。

curl https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/security/private_endpoints \
  -X POST \
  -H "Authorization: Bearer <accessToken>" \
  -H "Content-Type: application/json" \
  -d '{
    "cloud_provider_region": "<your-cloud-deployment-region>",
    "cloud_provider_endpoint_id": "<your-vpc-endpoint-id>",
    "endpoint_type": "general",
    "comment": "Optional: add a comment describing the endpoint."
  }'

VPC インターフェイスエンドポイントの作成

1. App Services UI で、 App Settingsに移動し、 Private Endpointsタブをクリックします。

2. [Add Private Endpoint をクリックし、[Sync] をクリックします。

3. VPC ID とサブネット ID（カンマ区切りのリスト）を別々のフィールドに追加し、 Next ] をクリックします。

4. 生成されたVPC Interface Endpoint Commandをコピーします。 コマンドは次のようになります。

   aws ec2 create-vpc-endpoint \
     --vpc-endpoint-type Interface
     --service-name <App Services Endpoint Service Name> \
     --vpc-id <your-vpc-id> \
     --region <your-aws-deployment-region> \
     --subnet-ids <your-subnet-ids>

5. ターミナルで、生成されたAmazon Web Services CLIコマンドを実行してVPCエンドポイントを作成します。

6. また、App Services が生成するコマンドを使用して、一般的なエンドポイントも作成する必要があります。

アプリへのプライベートエンドポイントの追加

VPC にインターフェースエンドポイントを作成したので、それらをアプリに追加する必要があります。

1. 前のステップで実行した コマンドの出力、または ダッシュボードのエンドポイント詳細画面で、VPC 同期 エンドポイント ID および 一般的な VPC エンドポイント IDCLIAmazon Web ServicesVPC を見つけます。この値はvpce-から始まります。

2. 新しい VPC エンドポイント ID をコピーし、App Services UI のそれぞれのYour VPC Endpoint IDフィールドに貼り付け、 Nextをクリックします。

3. これが最初に作成するプライベートエンドポイントである場合は、PrivateLink 接続外のリクエストからのすべてのアクセスを制限または開くために使用できるトグルが表示されます。 デフォルトでは、App Services は PrivateLink 接続外部からのすべてのリクエストをブロックします。 この設定は、このエンドポイントと作成する 追加のすべてのエンドポイントに適用されます。 詳細については、「アクセス制限の変更」を参照してください。

4. このページに記載されている一般プライベートエンドポイントの作成手順に従って、一般プライベートエンドポイントも作成する必要があります。

5. [Finish Endpoint Creation] をクリックします。

VPC インターフェイスエンドポイントの作成

1. List VPC プライベートエンドポイント サービスエンドポイントを呼び出します。

2. 応答オブジェクトをフィルタリングして、アプリの配置リージョンと作成するエンドポイント タイプのエントリを見つけます。

   curl https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/security/private_endpoint_service_infos \
   -H "Authorization: Bearer <access_token>"

   出力を非表示

   [
   {
      "cloud_provider_region": "aws-us-east-1",
      "service_name": "com.amazonaws.vpce.us-east-1.vpce-svc-0718bec2c0bdeab5c",
      "endpoint_type": "sync"
   },
   ...
   ]

3. 前のステップで、目的のエントリからservice_nameフィールドを取得します。

4. Amazon Web Services CLI の create-vpc-endpoint コマンドを使用してVPCエンドポイントを作成します。App Services エンドポイント サービス名、 VPC ID、サブネット ID、 Amazon Web Services配置リージョンが必要です。 コマンドは次のようになります。

aws ec2 create-vpc-endpoint \
  --vpc-endpoint-type Interface
  --service-name <App Services Endpoint Service Name> \
  --vpc-id <your-vpc-id> \
  --region <your-aws-deployment-region> \
  --subnet-ids <your-subnet-ids>

アプリへのプライベートエンドポイントの追加

VPC にインターフェイスエンドポイントを作成したので、それをアプリに追加する必要があります。

1. 前のステップで実行した コマンドの出力、または VPCダッシュボードのエンドポイント詳細画面で、 同期 エンドポイントID CLIAmazon Web ServicesVPCを見つけます。この値はvpce-から始まります。

2. エンドポイント ID、クラウド配置リージョン、エンドポイントタイプを指定して VPC プライベートエンドポイントの作成を呼び出して、同期プライベートエンドポイントを作成します。 たとえば、 aws-us-east-1を使用する場合は次のようになります。

   curl https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/security/private_endpoints \
   -X POST \
   -H "Authorization: Bearer <accessToken>" \
   -H "Content-Type: application/json" \
   -d '{
      "cloud_provider_region": "<your-cloud-deployment-region>",
      "cloud_provider_endpoint_id": "<your-vpc-endpoint-id>",
      "endpoint_type": "sync",
      "comment": "Optional: add a comment describing the endpoint."
   }'

3. このページに記載されている一般プライベートエンドポイントの作成手順に従って、一般プライベートエンドポイントも作成する必要があります。