Usar un punto final privado de VPC (versión preliminar)

Crear un punto final de interfaz de VPC

1. En la interfaz de usuario de App Services, navegue hasta App Settings, luego haga clic en la pestaña Private Endpoints.

2. Hacer clic en Add Private Endpoint, luego hacer clic en General.

3. Agregue su ID de VPC y las ID de subred (lista separada por comas) en sus campos separados, luego haga clic en Next.

4. Copia el VPC Interface Endpoint Command generado. El comando debería ser similar a esto:

   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. En su terminal, ejecute el comando AWS CLI generado para crear un punto final de VPC.

Agregue el punto final privado a su aplicación

Ahora que ha creado el punto final de la interfaz en su VPC, debe agregarlo a su aplicación.

1. Busque el ID del punto de conexión de la VPC, ya sea en la salida del comando CLI que ejecutó en el paso anterior o en la pantalla de detalles del punto de conexión del panel de AWS VPC. Este valor empieza vpce- por.

2. Copie el ID de su nuevo punto final de VPC y péguelo en el campo Your VPC Endpoint ID en la interfaz de usuario de App Services, luego haga clic en Next.

3. Si este es el primer punto de conexión privado que crea, verá un interruptor que puede usar para restringir o habilitar el acceso a solicitudes externas a su conexión PrivateLink. De forma predeterminada, App Services bloquea todas las solicitudes externas a su conexión PrivateLink. Esta configuración se aplica a este punto de conexión y a todos los demás que cree. Consulte "Cambiar las restricciones de acceso" para obtener más información.

4. Haga clic en Finish Endpoint Creation.

Crear un punto final de interfaz de VPC

1. Llame al punto final de servicios de punto final privado de VPC de lista.

2. Filtra el objeto de respuesta para encontrar la entrada correspondiente a la región de implementación de tu aplicación y al tipo de endpoint que deseas crear.

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

   OCULTAR SALIDA

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

3. Obtenga el campo service_name de la entrada deseada en el paso anterior.

4. Cree un punto de conexión de VPC con el comando create-vpc-endpoint de la AWS CLI. Necesitará un nombre de servicio de punto de conexión de App Services, un ID de VPC, ID de subred y una región de implementación de AWS. El comando debería ser similar a este:

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>

Agregue el punto final privado a su aplicación

Ahora que ha creado el punto final de la interfaz en su VPC, debe agregarlo a su aplicación.

1. Busque el ID del punto de conexión de la VPC, ya sea en la salida del comando CLI que ejecutó en el paso anterior o en la pantalla de detalles del punto de conexión del panel de AWS VPC. Este valor empieza vpce- por.

2. Cuando tenga el ID de su punto de conexión de VPC, ejecute "Crear un punto de conexión privado de VPC" con el ID de punto de conexión, la región de implementación en la nube y el tipo de punto de conexión. Por ejemplo,aws-us-east-1 usando:

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."
  }'

Crear un punto final de interfaz de VPC

1. En la interfaz de usuario de App Services, navegue hasta App Settings y luego haga clic en la pestaña Private Endpoints.

2. Hacer clic en Add Private Endpoint, luego hacer clic en Sync.

3. Agregue su ID de VPC y las ID de subred (lista separada por comas) en sus campos separados, luego haga clic en Next.

4. Copia el VPC Interface Endpoint Command generado. El comando debería ser similar a esto:

   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. En su terminal, ejecute el comando AWS CLI generado para crear un punto final de VPC.

6. También debe crear un punto final general utilizando el comando que genera App Services.

Agregue los puntos finales privados a su aplicación

Ahora que ha creado los puntos finales de la interfaz en su VPC, debe agregarlos a su aplicación.

1. Busque los ID de los puntos de conexión de sincronización y generales de VPC, ya sea en la salida de los comandos de la CLI que ejecutó en el paso anterior o en la pantalla de detalles del punto de conexión del panel de AWS VPC. Este valor empieza vpce- por.

2. Copie los nuevos ID de punto final de VPC y péguelos en el campo Your VPC Endpoint ID correspondiente en la interfaz de usuario de App Services, luego haga clic en Next.

3. Si este es el primer punto de conexión privado que crea, verá un interruptor que puede usar para restringir o habilitar el acceso a solicitudes externas a su conexión PrivateLink. De forma predeterminada, App Services bloquea todas las solicitudes externas a su conexión PrivateLink. Esta configuración se aplica a este punto de conexión y a todos los demás que cree. Consulte "Cambiar las restricciones de acceso" para obtener más información.

4. También debe crear un punto final privado general siguiendo los pasos para crear un punto final privado general en esta página.

5. Haga clic en Finish Endpoint Creation.

Crear un punto final de interfaz de VPC

1. Llame al punto final de servicios de punto final privado de VPC de lista.

2. Filtra el objeto de respuesta para encontrar la entrada correspondiente a la región de implementación de tu aplicación y al tipo de endpoint que deseas crear.

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

   OCULTAR SALIDA

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

3. Obtenga el campo service_name de la entrada deseada en el paso anterior.

4. Cree un punto de conexión de VPC con el comando create-vpc-endpoint de la AWS CLI. Necesitará un nombre de servicio de punto de conexión de App Services, un ID de VPC, ID de subred y una región de implementación de AWS. El comando debería ser similar a este:

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>

Agregue el punto final privado a su aplicación

Ahora que ha creado el punto final de la interfaz en su VPC, debe agregarlo a su aplicación.

1. Busque el ID del punto de conexión de sincronización de VPC, ya sea en la salida de los comandos de la CLI que ejecutó en el paso anterior o en la pantalla de detalles del punto de conexión del panel de AWS VPC. Este valor empieza vpce- por.

2. Cree un punto de conexión privado de sincronización llamando a "Crear un punto de conexión privado de VPC" con su ID de punto de conexión, región de implementación en la nube y tipo de punto de conexión. Por ejemplo,aws-us-east-1 usando:

   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. También debe crear un punto final privado general siguiendo los pasos para crear un punto final privado general en esta página.