Skip to content

Commit 2951122

Browse files
authored
Merge branch 'main' into josh/ws1-script-assignment
2 parents 49843e7 + f344789 commit 2951122

File tree

1 file changed

+14
-12
lines changed

1 file changed

+14
-12
lines changed

tutorials/connect-workspace-one-to-smallstep.mdx

Lines changed: 14 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
2-
updated_at: November 17, 2025
2+
updated_at: November 18, 2025
33
title: Connect Workspace One UEM to Smallstep
4-
html_title: VMware Workspace ONE Integration Guide
4+
html_title: Omnissa Workspace ONE Integration Guide
55
description: Connect Workspace ONE UEM to Smallstep for unified device identity. Enterprise guide for cross-platform device security management.
66
---
77

@@ -39,7 +39,7 @@ Next, we’ll create an OAuth client for Smallstep:
3939
3. For **Organization Group**, select the group most appropriate for managing your desired device inventory
4040
4. For **Role**, choose **Smallstep**
4141
5. Choose **Save**
42-
6. Copy the resulting client ID and secret value
42+
6. Save the resulting client ID and secret value to a temporary location
4343

4444
### 2. Configure Smallstep OAuth settings
4545

@@ -49,7 +49,7 @@ Configure a new Omnissa Workspace ONE Integration with the values you gathered a
4949

5050
- The Workspace ONE UEM REST API URL for your tenant.
5151
- This URL is shown in UEM’s settings. Navigate to
52-
**Groups and Settings****All Settings** **System****Advanced****API****Rest API**
52+
**Groups and Settings****All Settings** **System****Advanced****API****Rest API**
5353
- Copy the REST API URL from that page
5454
- The Workspace ONE UEM [OAuth 2.0 Token URL for your region](https://docs.omnissa.com/bundle/WorkspaceONE-UEM-Console-BasicsVSaaS/page/UsingUEMFunctionalityWithRESTAPI.html#datacenter_and_token_urls_for_oauth_20_support)
5555
- The OAuth client ID and secret you saved in Step 1
@@ -68,7 +68,7 @@ Within a few minutes after adding the connection, you should see all of your Wor
6868
1. In Workspace One UEM, visit **Resources → Scripts**
6969
2. Choose **Add** and then **Windows**
7070
1. In the General tab, provide a name for the script, such as “Smallstep Agent Enrollment”
71-
2. On the Details tab, ensure the **Language** is “Poweshell” and the **Execution Context & Privileges** is “System Context”
71+
2. On the Details tab, ensure the **Language** is “Powershell” and the **Execution Context & Privileges** is “System Context”
7272
3. Use the following snippet as the **Code**, making sure to replace `<team-id>` with the Team ID value you copied from the Smallstep UI earlier. `<team-name>` should be replaced with your full Team name shown in the Smallstep dashboard.
7373

7474
```xml
@@ -130,7 +130,7 @@ In this step, we’ll tie everything together by creating Windows policy to enro
130130

131131
#### Gather required details
132132

133-
1. You’ll need the following values from when your configuration your Workspace ONE connection:
133+
You’ll need the following values from when you configured your Workspace ONE connection:
134134
- SCEP URL
135135
- SCEP Challenge URL
136136
- Challenge Basic Authentication Username
@@ -148,11 +148,11 @@ For compatibility with Workspace ONE, Smallstep emulates the Microsoft ADCS’s
148148
2. For Authority Type, choose `Microsoft ADCS`
149149
3. For Protocol, choose `SCEP`
150150
4. For Version, choose `NDES 2008/2012` ([NDES for SCEP](https://docs.omnissa.com/bundle/CertificateAuthorityIntegrationsV2410/page/NDESforSCEP.html))
151-
5. Provide the SCEP URL from Step 1
151+
5. Provide the SCEP URL
152152
6. For Challenge Type, choose `Dynamic`
153-
7. Provide the Challenge Username and Password from Step 1
153+
7. Provide the Challenge Username and Password
154154
8. No client certificate is needed
155-
9. Provide the SCEP Challenge URL from Step 1
155+
9. Provide the SCEP Challenge URL
156156
10. Choose **Show Advanced Options**
157157
- For SCEP Challenge Length, choose `32`
158158
11. Choose **Test Connection** and wait for a ✅ success modal
@@ -181,10 +181,10 @@ A new modal screen will be presented with the empty Request Template configurati
181181
3. Click Windows, and then select Windows again
182182
4. Click Device Profile
183183
5. Under General, Provide a name (e.g. “Smallstep Device Enrollment”)
184-
1. Select the All Devices group in the Smart Groups dropdown
184+
1. Select the All Devices group in the Smart Groups select list
185185
2. Other options can be left as-is
186186
3. Optionally, click the View Device Assignment button to see the devices to which the profile will be distributed
187-
6. Add a Credential by clicking the **Configure** button , and set the following settings:
187+
6. Select the **Credential** payload type on the left and choose **Configure**. Set the following settings:
188188
1. Credential Source: Defined Certificate Authority
189189
2. Certificate Authority: Choose the CA connection you created earlier
190190
3. The certificate template should be selected automatically. If not, select an appropriate one.
@@ -195,4 +195,6 @@ A new modal screen will be presented with the empty Request Template configurati
195195

196196
### Confirmation
197197

198-
In the Smallstep UI, go to the device's profile page. In the **Device Registration** section, you'll see an **Enrolled At** timestamp.
198+
In the Smallstep console, find your device. In the **Device Registration** section, you'll see an **Enrolled At** timestamp.
199+
Workspace ONE's device UI also shows both the installed apps and issued certificates on the device.
200+

0 commit comments

Comments
 (0)