Skip to content

Commit 2e32f0d

Browse files
Document TLS certificate coverage limitations for localhost.localstack.cloud region endpoints (#430)
Co-authored-by: Quetzalli <hola@quetzalliwrites.com>
1 parent d250c38 commit 2e32f0d

File tree

3 files changed

+46
-0
lines changed

3 files changed

+46
-0
lines changed

src/content/docs/aws/capabilities/networking/external-port-range.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,3 +104,4 @@ services:
104104
105105
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.
106106
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.
107+
Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
---
2+
title: HTTPS/TLS Support
3+
description: Overview of TLS certificate coverage for the `localhost.localstack.cloud` domain and supported AWS regions for secure HTTPS access to LocalStack service endpoints.
4+
template: doc
5+
sidebar:
6+
order: 7
7+
---
8+
9+
## Introduction
10+
11+
LocalStack provides TLS certificates for the `localhost.localstack.cloud` domain, which allows secure HTTPS access to service endpoints using region-specific hostnames such as:
12+
13+
```arduino
14+
https://s3.us-east-1.localhost.localstack.cloud:4566
15+
```
16+
These certificates enable proper hostname validation for supported AWS regions when using HTTPS with SDKs, the AWS CLI, browsers, and other tools.
17+
18+
### Supported Regions
19+
20+
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:
21+
22+
```vbnet
23+
SSL: CERTIFICATE_VERIFY_FAILED
24+
hostname mismatch
25+
x509: certificate is not valid for any names
26+
```
27+
28+
The full list of supported regions is available here:
29+
30+
- `us-east-1`
31+
- `us-east-2`
32+
- `us-west-1`
33+
- `us-west-2`
34+
- `eu-central-1`
35+
- `eu-west-1`
36+
37+
### Why this limitation exists
38+
39+
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.
40+
41+
We are actively working to expand coverage where technically feasible.

src/content/docs/aws/capabilities/networking/index.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,6 +49,10 @@ For example, setting the `endpoint_url` parameter with an [AWS SDK](/aws/integra
4949
}
5050
]} />
5151

52+
:::note
53+
TLS certificates for `localhost.localstack.cloud` support only certain AWS regions. See [TLS Certificate Coverage](/aws/capabilities/networking/https-tls-support) for details.
54+
:::
55+
5256
## [Using transparent endpoint injection](/aws/capabilities/networking/transparent-endpoint-injection)
5357

5458
For example, you have a Lambda function that needs to access LocalStack resources.

0 commit comments

Comments
 (0)