Skip to content

Commit 00c6a53

Browse files
committed
Clarify language around the typical client configuration
1 parent 097741f commit 00c6a53

File tree

1 file changed

+20
-15
lines changed

1 file changed

+20
-15
lines changed

tutorials/configure-enterprise-relay.mdx

Lines changed: 20 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,37 @@
11
---
22
title: Configure your endpoints for Smallstep Enterprise Relay
3-
updated_at: December 08, 2025
3+
updated_at: December 16, 2025
44
html_title: Configure your Apple endponts to use Smallstep's Enterprise MASQUE Relay
55
description: This tutorial describes how to deploy Smallstep's enterprise MASQUE relay service
66
---
77

88
## Before you begin
99

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:
1111

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.
1512
- **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.
1819

1920
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.
2223

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:
2627

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.
2930
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)
3035

3136
## Example: Jamf Pro Configuration Profile
3237

@@ -71,7 +76,7 @@ In this example, we’ll use Jamf Pro to configure endpoints connecting to a Sma
7176
- Hardware Bound: ✅
7277
- Attest: ✅
7378
- 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`
7580
5. Add a [Relay payload](https://developer.apple.com/documentation/devicemanagement/relay)
7681
1. Relays: Add the URL for your Smallstep Enterprise Relay
7782
2. Match domains: Up to you

0 commit comments

Comments
 (0)