diff --git a/src/content/docs/aws/capabilities/networking/external-port-range.mdx b/src/content/docs/aws/capabilities/networking/external-port-range.mdx index 7f689030..1fc870e9 100644 --- a/src/content/docs/aws/capabilities/networking/external-port-range.mdx +++ b/src/content/docs/aws/capabilities/networking/external-port-range.mdx @@ -104,3 +104,4 @@ services: By customizing the `GATEWAY_LISTEN` and `EXTERNAL_SERVICE_PORTS_START`/`EXTERNAL_SERVICE_PORTS_END` values for each instance, you can ensure that they operate on distinct port ranges, preventing any conflicts and enabling smooth execution of multiple LocalStack instances. Please make sure to set `MAIN_CONTAINER_NAME` for following usages of the LocalStack CLI to specify which instance of LocalStack you want to address with the specific CLI command. + diff --git a/src/content/docs/aws/capabilities/networking/https-tls-support.mdx b/src/content/docs/aws/capabilities/networking/https-tls-support.mdx new file mode 100644 index 00000000..bededcbc --- /dev/null +++ b/src/content/docs/aws/capabilities/networking/https-tls-support.mdx @@ -0,0 +1,41 @@ +--- +title: HTTPS/TLS Support +description: Overview of TLS certificate coverage for the `localhost.localstack.cloud` domain and supported AWS regions for secure HTTPS access to LocalStack service endpoints. +template: doc +sidebar: + order: 7 +--- + +## Introduction + +LocalStack provides TLS certificates for the `localhost.localstack.cloud` domain, which allows secure HTTPS access to service endpoints using region-specific hostnames such as: + +```arduino +https://s3.us-east-1.localhost.localstack.cloud:4566 +``` +These certificates enable proper hostname validation for supported AWS regions when using HTTPS with SDKs, the AWS CLI, browsers, and other tools. + +### Supported Regions + +Due to certificate authority and infrastructure limitations, TLS certificates are currently only issued for a subset of AWS regions. If you attempt to use an unsupported region, you may encounter TLS errors such as: + +```vbnet +SSL: CERTIFICATE_VERIFY_FAILED +hostname mismatch +x509: certificate is not valid for any names +``` + +The full list of supported regions is available here: + +- `us-east-1` +- `us-east-2` +- `us-west-1` +- `us-west-2` +- `eu-central-1` +- `eu-west-1` + +### Why this limitation exists + +TLS certificates must explicitly include supported hostnames. Because each region requires hostname coverage, and certificate authorities impose size and validation constraints, it is currently not possible to include all AWS regions in the LocalStack certificate. + +We are actively working to expand coverage where technically feasible. diff --git a/src/content/docs/aws/capabilities/networking/index.mdx b/src/content/docs/aws/capabilities/networking/index.mdx index c6dc4aaa..be5c610a 100644 --- a/src/content/docs/aws/capabilities/networking/index.mdx +++ b/src/content/docs/aws/capabilities/networking/index.mdx @@ -49,6 +49,10 @@ For example, setting the `endpoint_url` parameter with an [AWS SDK](/aws/integra } ]} /> +:::note +TLS certificates for `localhost.localstack.cloud` support only certain AWS regions. See [TLS Certificate Coverage](/aws/capabilities/networking/https-tls-support) for details. +::: + ## [Using transparent endpoint injection](/aws/capabilities/networking/transparent-endpoint-injection) For example, you have a Lambda function that needs to access LocalStack resources.