You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: platform/enrollment-guide.mdx
+19-13Lines changed: 19 additions & 13 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ description: There are several ways to add your devices to Smallstep. In this gu
6
6
7
7
In this guide,
8
8
we'll talk about different approaches you can take
9
-
as you build yout device inventory in Smallstep.
9
+
as you build your device inventory in Smallstep.
10
10
11
11
It's worth restating the overall goal of this process:
12
12
To build a high-assurance device inventory,
@@ -32,9 +32,8 @@ and they will be able to self-enroll devices
32
32
using the [Smallstep Desktop App](./smallstep-app.mdx)
33
33
or the [Smallstep Agent for Linux](./smallstep-agent.mdx).
34
34
35
-
As the administrator,
36
-
by default,
37
-
you must approve each new device
35
+
By default, administrators
36
+
must approve a new device
38
37
before it can access any of your resources.
39
38
You can change this in [Team Settings](https://smallstep.com/app/?next=/settings/team).
40
39
@@ -49,9 +48,8 @@ via single sign-on,
49
48
using the [Smallstep Desktop App](./smallstep-app.mdx)
50
49
or the [Smallstep Agent for Linux](./smallstep-agent.mdx).
51
50
52
-
As the administrator,
53
-
by default,
54
-
you must approve each new device
51
+
By default, administrators
52
+
must approve a new device
55
53
before it can access any of your resources.
56
54
You can change this in [Team Settings](https://smallstep.com/app/?next=/settings/team).
57
55
@@ -62,8 +60,10 @@ Once an MDM is synced,
62
60
you can deploy the Smallstep Agent to your endpoints
63
61
to enable high-assurance protections.
64
62
65
-
Devices synced from an MDM inventory do not require manual approval.
66
-
But, they will not be marked as high-assurance until Smallstep receives an attestation from the device.
63
+
Devices synced from an MDM inventory
64
+
are automatically approved,
65
+
but they will not be marked as high-assurance
66
+
until Smallstep receives an attestation from the device.
67
67
68
68
For a concrete example,
69
69
see [Connect Jamf Pro to Smallstep](../tutorials/connect-jamf-pro-to-smallstep.mdx)
@@ -73,8 +73,9 @@ see [Connect Jamf Pro to Smallstep](../tutorials/connect-jamf-pro-to-smallstep.m
73
73
74
74
You can import devices from any source into Smallstep using our API.
75
75
76
-
Devices added via API do not require manual approval.
77
-
But, they will not be marked as high-assurance until Smallstep receives an attestation from the device.
76
+
Devices added via API are automatically approved.
77
+
but they will not be marked as high-assurance
78
+
until Smallstep receives an attestation from the device.
78
79
79
80
#### Example: I have a list of device identifiers
80
81
@@ -83,10 +84,15 @@ For each device, use the [Save Collection Instance](https://gateway.smallstep.co
83
84
- For Apple devices, the `instanceID` must be the device's serial number.
84
85
- For TPM 2.0 devices, the `instanceID` must be the TPM Endorsement Key URI, in the format `urn:ek:sha256:ul3sYf6uQ6jVEXAMPLEXoAuHI10U8gTvEJ6bMj95LXI=`. (You can retrieve the EK URI by running `step agent tpm --fingerprint` on the device.)
85
86
86
-
For the body of the request, use the following value, replacing `[email protected]` with the device owner's email address:
87
+
For the body of the request,
88
+
create a user using the following value
89
+
(replacing `[email protected]` with the device owner's email address):
0 commit comments