|
1 | 1 | --- |
2 | 2 | title: Configure your endpoints for Smallstep Enterprise Relay |
3 | | -updated_at: December 08, 2025 |
| 3 | +updated_at: December 16, 2025 |
4 | 4 | html_title: Configure your Apple endponts to use Smallstep's Enterprise MASQUE Relay |
5 | 5 | description: This tutorial describes how to deploy Smallstep's enterprise MASQUE relay service |
6 | 6 | --- |
7 | 7 |
|
8 | 8 | ## Before you begin |
9 | 9 |
|
10 | | -To get your Relay set up, you will need to give Smallstep the following information: |
| 10 | +To create your Relay server, you will need to give Smallstep the following information: |
11 | 11 |
|
12 | | -- **Relay Trust Bundle**. This will be used by the Relay to verify client certificates. |
13 | | -This bundle needs to include both Root and Intermediate CA certificates for any CAs you want your Relay to trust. |
14 | | -A typical configuration will include your team's Smallstep Accounts Root and Intermediate CA. |
15 | 12 | - **Relay Region**. The GCP region for the relay, eg. `US_CENTRAL1` |
16 | | - |
17 | | -## Client Configuration |
| 13 | +- **Relay Trust Bundle** (optional). This will be used by the Relay to verify client certificates. |
| 14 | +This bundle needs to include both Root and Intermediate CA certificates for any CAs you want your Relay to trust. |
| 15 | +By default, your team's Smallstep Accounts Root and Intermediate CAs are trusted. |
| 16 | +- **Relay Issuing Authority** (optional). The CA that will issue the Relay's server TLS certificate. |
| 17 | +This must be a Smallstep CA in your team. |
| 18 | +By default, your team's Smallstep Workloads CA is used. |
18 | 19 |
|
19 | 20 | Once we have your details, |
20 | | -Smallstep will create your relay server and give you the Relay URL, |
21 | | -which you’ll need to configure clients. |
| 21 | +Smallstep will create your relay server and respond with a **Relay URL**, |
| 22 | +which you’ll need for configuring clients. |
22 | 23 |
|
23 | | -For most customers, the Relay will accept client certificates from your team's Smallstep Accounts CA. |
24 | | -And, therefore, your clients will need to trust your team's Smallstep Accounts Root CA. |
25 | | -You can download the Accounts Root CA certificate from your [Authorities](https://smallstep.com/app/?next=/cm/authorities) page. |
| 24 | +## Typical Client Configuration |
| 25 | + |
| 26 | +On Apple platforms, a typical client could be configured as follows: |
26 | 27 |
|
27 | | -For most customers, the Relay’s server certificate is issued by your team’s Workloads CA. |
28 | | -And, therefore, your clients will need to trust your team's Smallstep Workloads Root CA. |
| 28 | +- **Workloads CA Trust**: The Relay’s server certificate is issued by your team’s Workloads CA. |
| 29 | +Therefore, the client must trust your team's Workloads Root CA to connect to the relay. |
29 | 30 | You can download the Workloads Root CA certificate from your [Authorities](https://smallstep.com/app/?next=/cm/authorities) page. |
| 31 | +- **Accounts CA Trust**: To obtain its client certificate, the client must trust your team's Smallstep Accounts Root CA |
| 32 | +You can download the Accounts Root CA certificate from your [Authorities](https://smallstep.com/app/?next=/cm/authorities) page. |
| 33 | +- **Client Certificate**: An [ACMECertificate MDM payload](https://support.apple.com/guide/deployment/automated-certificate-management-environment-depb95c66a07/web) is used to obtain a client certificate for accessing the Relay. |
| 34 | +- **Relay Configuration**: The Relay is configured using a [Relay MDM payload](https://developer.apple.com/documentation/devicemanagement/relay) |
30 | 35 |
|
31 | 36 | ## Example: Jamf Pro Configuration Profile |
32 | 37 |
|
@@ -71,7 +76,7 @@ In this example, we’ll use Jamf Pro to configure endpoints connecting to a Sma |
71 | 76 | - Hardware Bound: ✅ |
72 | 77 | - Attest: ✅ |
73 | 78 | - Key Usage: `0xB` |
74 | | - - Extended Key Usage: `1.3.6.1.5.5.7.3.2\` |
| 79 | + - Extended Key Usage: `1.3.6.1.5.5.7.3.2` |
75 | 80 | 5. Add a [Relay payload](https://developer.apple.com/documentation/devicemanagement/relay) |
76 | 81 | 1. Relays: Add the URL for your Smallstep Enterprise Relay |
77 | 82 | 2. Match domains: Up to you |
|
0 commit comments