Skip to content

Commit 604624d

Browse files
committed
Add confirmation steps
1 parent b6cf662 commit 604624d

File tree

1 file changed

+13
-7
lines changed

1 file changed

+13
-7
lines changed

tutorials/connect-jamf-pro-to-smallstep.mdx

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ You will need:
1616

1717
# Step-by-step instructions
1818

19-
### 1. Create API Client in Jamf Pro
19+
### Create an API Client in Jamf Pro
2020

2121
This API client will allow Smallstep to read your Jamf device inventory and manage the webhooks necessary for ongoing inventory syncing.
2222

@@ -39,7 +39,7 @@ This API client will allow Smallstep to read your Jamf device inventory and mana
3939
5. Choose **Generate client secret**
4040
6. Temporarily save the **Client ID** and **Client Secret**. You’ll use them in the next step.
4141

42-
### 2. Connect Jamf to Smallstep
42+
### Connect Jamf to Smallstep
4343

4444
Let’s add the Jamf API credentials you just created to Smallstep.
4545

@@ -49,7 +49,7 @@ Let’s add the Jamf API credentials you just created to Smallstep.
4949
4. Choose **Add Platform**. Your device inventory will start syncing from Jamf to Smallstep.
5050
5. Temporarily save the **Webhook URL**, **Username**, and **Password** presented.
5151

52-
### 3. Configure a SCEP Enrollment webhook in Jamf Pro
52+
### Configure a SCEP Enrollment webhook in Jamf Pro
5353

5454
Smallstep uses Dynamic SCEP certificate enrollment. This webhook allows Jamf to request a dynamic, short-lived challenge string from Smallstep during a SCEP certificate request. The challenge string is injected into a [SCEP payload](https://developer.apple.com/documentation/devicemanagement/scep) for your clients to authenticate to Smallstep.
5555

@@ -66,7 +66,7 @@ Smallstep uses Dynamic SCEP certificate enrollment. This webhook allows Jamf to
6666
5. Webhook Event: SCEPChallenge
6767
4. Choose **Save**
6868

69-
### 4. Create Agent Package for Distribution
69+
### Create an Agent Package for Distribution
7070

7171
In this step, you’ll upload the Smallstep agent package to Jamf’s distribution network.
7272

@@ -78,7 +78,7 @@ In this step, you’ll upload the Smallstep agent package to Jamf’s distributi
7878
2. Filename: (upload from step #1)
7979
5. Choose **Save**
8080

81-
### 5. Create Agent Script
81+
### Create an Agent Bootstrap Script
8282

8383
This step will install a script on your client devices that bootstraps the connection between your devices and Smallstep.
8484

@@ -97,7 +97,7 @@ This step will install a script on your client devices that bootstraps the conne
9797

9898
4. Choose **Save**
9999

100-
### 5. Create Agent Installation Policy
100+
### Create an Agent Installation Policy
101101

102102
Next, we’ll configure the Script we just created to run on your client devices.
103103

@@ -120,7 +120,7 @@ Next, we’ll configure the Script we just created to run on your client devices
120120
4. Under Scope, select your desired policy scope. The agent will be installed on all devices in this scope.
121121
4. Choose **Save**
122122

123-
### 6. Configure Agent Enrollment Profile
123+
### Configure an Agent Enrollment Profile
124124

125125
In this step, we’ll tie everything together by configuring Jamf to distribute the Smallstep Agent.
126126

@@ -192,3 +192,9 @@ In this step, we’ll tie everything together by configuring Jamf to distribute
192192

193193
Your Smallstep team is now linked to Jamf. The devices that you scoped will receive a certificate and have the agent installed and running.
194194

195+
### Confirmation
196+
197+
There's two ways to confirm installation on an endpoint:
198+
- In the Smallstep UI, go to the device's profile page. In the **Device Registration** section, you'll see an **Enrolled At** timestamp.
199+
- Alternatively, on the device itself, run `/Applications/SmallstepAgent/Contents/MacOS/SmallstepAgent version` to see that the agent is installed. And, in **System Settings**, check **Login Items** to confirm that there is a **Smallstep Agent** entry.
200+

0 commit comments

Comments
 (0)