fleetdm / fleet

Open-source platform for IT, security, and infrastructure teams. (Linux, macOS, Chrome, Windows, cloud, data center)
https://fleetdm.com
Other
2.99k stars 415 forks source link

MDM install instructions are incorrect #20020

Closed zwass closed 2 months ago

zwass commented 3 months ago

Fleet version: 4.52.0

macOS 13.2.1 (also checked on macOS 14.5 and see same issues)


💥  Actual behavior

Instructions say to click "Enrollment Profile". Profile is actually called "Migration Test enrollment". I'm guessing the profile is always called "[Organization Name] enrollment"? Screenshot 2024-06-26 at 9 44 29 AM

Instructions say to "select Install" but there is no "Install" option. Screenshot 2024-06-26 at 9 50 49 AM

🧑‍💻  Steps to reproduce

  1. Go to My Device page on a device that is not enrolled in MDM.
  2. Follow instructions to enroll.

🕯️ More info (optional)

N/A

🛠️ To fix

Figma link

PezHub commented 3 months ago

@marko-lisica looks like we need to remove and select install. from Step 4 and maybe replace Enrollment Profile with [Organization name] enrollment profile or similar?

Example:

  1. In the search bar, type "Profiles". Select Profiles, then double click the [Organization name] enrollment profile.
marko-lisica commented 3 months ago

@PezHub Do you know if the profile is always called [Org name] enrollment? I see in our enrollment profile that PayloadDisplayName is set to "Fleet enrollment". So it might be anything in that case.

Screenshot 2024-06-28 at 16 57 51

In Fleet's copy we always refer to UI elements with bold text. In this case we refer to Enrollment Profile as UI element and not to the name. Not sure if that makes sense. In this case I would just change Install to Enroll since button is called differently now.

@noahtalerman Do you know if PayloadDisplayName is displayed in Profiles pane in System Settings?

PezHub commented 3 months ago

@marko-lisica Just ran a quick test and renamed my local instance and can confirm It's pulling the 'Organization Name' then appending enrollment

In Fleet's copy we always refer to UI elements with bold text. In this case we refer to Enrollment Profile as UI element and not to the name. Not sure if that makes sense.

Yeah, that makes sense. Maybe adding the word "the" in front of Enrollment Profile would help?

For theinstall -> Enroll copy change just keep in mind if you replaceinstall with Enroll, you'll want to eliminate Step 5.

marko-lisica commented 3 months ago

@PezHub Good point. I think you were right in the first place. We can remove and select install. I guess in Sonoma they removed this extra step to "Install" profile and user get this "Enroll" dialog instead?

PezHub commented 3 months ago

I just checked Ventura and it's the same workflow as Sonoma so perhaps it was macOS12 and earlier

marko-lisica commented 3 months ago

Hey @PezHub and @georgekarrv, I just added Figma link with copy changes in the "To fix" section of issue description.

PezHub commented 3 months ago

confirmed copy is updated on both macOS 13 and 14.

Screenshot 2024-07-01 at 11 21 11 PM

QA Approved!

p.s. Sequoia renamed Profiles toDevice Management in System Settings so we will need to revisit once ver 15 drops 🫠

fleet-release commented 2 months ago

Correct instructions shine, Like a beacon in the cloud. Fleet's path, now aligned.