TheJumpCloud / jumpcloud-ADMU

JumpCloud Active Directory Migration Utility - JCADMU
23 stars 7 forks source link

Sa 2670 case insensitive username search #77

Closed jworkmanjc closed 1 year ago

jworkmanjc commented 1 year ago

Issues

What does this solve?

This release removes the need for username lookup to be case sensitive when specifying the "AutoBind JumpCloud User" option of the ADMU GUI tool. In prior versions the specific casing was required.

In this example the "ITSupport" username will match any username in JumpCloud even if the JumpCloud username is described as an all lowercase string.

Screen Shot 2022-11-01 at 3 49 20 PM

Screen Shot 2022-11-01 at 3 50 41 PM

Is there anything particularly tricky?

How should this be tested?

Testing Case Sensitive Search

  1. In a windows VM with an AD user Bound, Run the version of ADMU from this branch.
  2. Take a snapshot to easily get back to this state
  3. Attempt to migrate a user matching a "JumpCloud Username" in your test org. (Attempt this with an all uppercase string "ITSUPPORT" or lowercase "itsupport").
  4. The JumpCloud API Key textbox & the "Autobind JC User" checkbox must be populated/ checked.
  5. The user search should identify the JumpCloud user by username and the user should be bound to the device after migration.

Testing Advanced Deployment Scripts

  1. Follow steps to setup the Advanced Deployment Scripts
  2. This essentially involves creating a private github repository, creating a token with access to just that repository.
  3. On the VM you've used to setup & test ADMU, run the Setup & Discovery Script. A .json file with the hostname for that system will be added to your github repository
  4. On another system, Run the Investigation script to collate the results of all systems and upload a CSV to your github repository.
  5. Edit the CSV directly in github (or locally and re-commit the file), for the user you wish to migrate, add a jumpcloud user in the "JumpCloudUserName" collumn. Save the file.
  6. Lastly take a snapshot of your VM. Then run the remote invocation scrip from JumpCloud, scoped to your test VM. The specified user in the CSV should be migrated to the a JumpCloud username.

Screenshots

Discovery Script Screen Shot 2022-11-02 at 1 47 55 PM

Populated Collated CSV Screen Shot 2022-11-02 at 1 47 37 PM

Command invocation from JumpCloud, specified user was migrated: Screen Shot 2022-11-02 at 1 50 13 PM