Amazon Detective and interface VPC endpoints (AWS PrivateLink)

You can establish a private connection between your VPC and Amazon Detective by creating an interface VPC endpoint. Interface endpoints are powered by AWS PrivateLink, a technology that enables you to privately access Detective APIs without an internet gateway, NAT device, VPN connection, or AWS Direct Connect connection. Instances in your VPC don't need public IP addresses to communicate with Detective APIs. Traffic between your VPC and Detective does not leave the Amazon network.

Each interface endpoint is represented by one or more Elastic Network Interfaces in your subnets.

For more information, see Interface VPC endpoints (AWS PrivateLink) in the AWS PrivateLink Guide.

Considerations for Detective VPC endpoints

Before you set up an interface VPC endpoint for Detective, ensure that you review Interface endpoint properties and limitations in the AWS PrivateLink Guide.

Detective supports making calls to all of its API actions from your VPC.

Detective supports FIPS in the following Regions:

Creating an interface VPC endpoint for Detective

You can create a VPC endpoint for the Detective service using either the Amazon VPC console or the AWS Command Line Interface (AWS CLI). For more information, see Create an interface endpoint in the AWS PrivateLink Guide.

Create a VPC endpoint for Detective using the following service name:

If you enable private DNS for the endpoint, you can make API requests to Detective using its default DNS name for the Region, for example, api.detective.us-east-1.amazonaws.com. For more information, see Amazon Detective endpoints in the Amazon Web Services General Reference.

For more information, see Access a service through an interface endpoint in the AWS PrivateLink Guide.

Creating a VPC endpoint policy for Detective

You can attach an endpoint policy to your VPC endpoint that controls access to Detective. The policy specifies the following information:

For more information, see Control access to services with VPC endpoints in the AWS PrivateLink Guide.

Example: VPC endpoint policy for Detective actions

The following is an example of an endpoint policy for Detective. When attached to an endpoint, this policy grants access to the listed Detective actions for all principals on all resources.

{
   "Statement":[
      {
         "Principal":"*",
         "Effect":"Allow",
         "Action":[
            "detective:ListGraphs",
            "detective:ListMembers"
         ],
         "Resource":"*"
      }
   ]
}

Shared subnets

You can't create, describe, modify, or delete VPC endpoints in subnets that are shared with you. However, you can use the VPC endpoints in subnets that are shared with you. For information about VPC sharing, see Share your VPC with other accounts in the Amazon VPC User Guide.