Usar um endpoint privado VPC (prévia)

Criar um endpoint de interface VPC

1. Na interface do usuário do App Services, navegue até App Settings e clique na guia Private Endpoints .

2. Clique em Add Private Endpoint e, em seguida, clique em General.

3. Adicione sua ID de VPC e ID de sub-rede (lista separada por vírgulas) em seus campos separados e clique em Next.

4. Copie o VPC Interface Endpoint Command gerado . O comando deve ser semelhante 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>

5. Em seu terminal, execute o comando do gerado Amazon Web Services CLI para criar um VPC endpoint .

Adicione o endpoint privado ao seu aplicativo

Agora que você criou o ponto de conexão da interface em sua VPC, é necessário adicioná-lo ao seu aplicativo.

1. Encontre o do VPC endpoint ID na saída do CLI comando executado na etapa anterior ou na tela de detalhes do endpoint do Amazon Web Services VPC dashboard. Este valor começa com vpce-.

2. Copie o ID do seu novo endpoint VPC e cole-o no campo Your VPC Endpoint ID na interface do usuário do App Services e clique em Next.

3. Se este for o primeiro endpoint privado que você está criando, você verá um botão que pode ser usado para restringir ou abrir todo o acesso de solicitações fora da sua conexão PrivateLink. Por padrão, o Atlas App Services bloqueia todas as solicitações vindas de fora da sua conexão PrivateLink. Esta configuração se aplica a este endpoint e a todos os endpoints adicionais que você criar. Consulte alterar restrições de acesso para obter mais informações.

4. Clique em Finish Endpoint Creation.

Criar um endpoint de interface VPC

1. Ligue para o endpoint List VPC Private Endpoint Services .

2. Filtre o objeto de resposta para encontrar a entrada da região de sistema do seu aplicativo e o tipo de endpoint que você deseja criar.

   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 SAÍDA

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

3. Obtenha o campo service_name da entrada desejada na etapa anterior.

4. Crie um VPC endpoint usando o Amazon Web Services CLI create-vpc-endpoint comando. Você precisa de um nome de serviço de endpoint do App Services, VPC ID de , IDs de sub-rede e Amazon Web Services região de implantação . O comando deve ser semelhante 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>

Adicione o endpoint privado ao seu aplicativo

Agora que você criou o ponto de conexão da interface em sua VPC, é necessário adicioná-lo ao seu aplicativo.

1. Encontre o do VPC endpoint ID na saída do CLI comando executado na etapa anterior ou na tela de detalhes do endpoint do Amazon Web Services VPC dashboard. Este valor começa com vpce-.

2. Quando tiver o ID do endpoint VPC, chame Criar um endpoint privado de VPC com o ID do endpoint, a região de implantação da nuvem e o tipo de endpoint. Por exemplo, usando 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."
  }'

Criar um endpoint de interface VPC

1. Na interface do usuário do App Services, navegue até App Settings e clique na guia Private Endpoints .

2. Clique em Add Private Endpoint e, em seguida, clique em Sync.

3. Adicione sua ID de VPC e ID de sub-rede (lista separada por vírgulas) em seus campos separados e clique em Next.

4. Copie o VPC Interface Endpoint Command gerado . O comando deve ser semelhante 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>

5. Em seu terminal, execute o comando do gerado Amazon Web Services CLI para criar um VPC endpoint .

6. Você também deve criar um endpoint geral usando o comando que o App Services gera.

Adicione os endpoints privados à sua aplicação

Agora que você criou os pontos de conexão da interface na VPC, é necessário adicioná-los ao aplicativo.

1. Encontre as IDs de endpoint daVPC de sincronização e gerais na saída dos comandos CLI executados na etapa anterior ou na tela de detalhes do endpoint do dashboard da VPC do Amazon Web Services. Este valor começa com vpce-.

2. Copie suas novas IDs de endpoint VPC e cole-as em seu respectivo campo Your VPC Endpoint ID na interface do usuário do App Services e clique em Next.

3. Se este for o primeiro endpoint privado que você está criando, você verá um botão que pode ser usado para restringir ou abrir todo o acesso de solicitações fora da sua conexão PrivateLink. Por padrão, o Atlas App Services bloqueia todas as solicitações vindas de fora da sua conexão PrivateLink. Esta configuração se aplica a este endpoint e a todos os endpoints adicionais que você criar. Consulte alterar restrições de acesso para obter mais informações.

4. Você também deve criar um endpoint privado geral seguindo as etapas para criar um endpoint privado geral nesta página.

5. Clique em Finish Endpoint Creation.

Criar um endpoint de interface VPC

1. Ligue para o endpoint List VPC Private Endpoint Services .

2. Filtre o objeto de resposta para encontrar a entrada da região de sistema do seu aplicativo e o tipo de endpoint que você deseja criar.

   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 SAÍDA

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

3. Obtenha o campo service_name da entrada desejada na etapa anterior.

4. Crie um VPC endpoint usando o Amazon Web Services CLI create-vpc-endpoint comando. Você precisa de um nome de serviço de endpoint do App Services, VPC ID de , IDs de sub-rede e Amazon Web Services região de implantação . O comando deve ser semelhante 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>

Adicione o endpoint privado ao seu aplicativo

Agora que você criou o ponto de conexão da interface em sua VPC, é necessário adicioná-lo ao seu aplicativo.

1. Encontre o do endpoint da de sincronização na saída dos comandos da que você executou na etapa anterior ou na tela VPC de detalhes do endpoint do ID CLI Amazon Web Services VPC dashboard da do . Este valor começa com vpce-.

2. Crie um endpoint privado de sincronização chamando Create a VPC Private Endpoint com seu ID de endpoint, região de implantação na nuvem e tipo de endpoint. Por exemplo, usando 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. Você também deve criar um endpoint privado geral seguindo as etapas para criar um endpoint privado geral nesta página.