MicroStrategy ONE

MicroStrategy Badge for Mac (10.7 and Older)

You can enable users to unlock and lock their Mac computers by holding their smartphone with the MicroStrategy Identity app close to their computer. MicroStrategy Badge uses Bluetooth® wireless technology to send the user's encrypted credentials to the Mac and unlock it. The user does not have to enter a user name or password.

When you first enable passwordless unlocking and locking for a Mac, you establish a trusted relationship between the smartphone and the computer by pairing the two devices. This trusted relationship enables a user to securely unlock her computer using Bluetooth wireless technology, even if her computer is offline.

You can also use Badge for Mac to log in to SAML enabled websites by utilizing the bluetooth connection between your MicroStrategy Badge iOS app and MicroStrategy Badge for Mac. When you navigate to a supported website, such as Salesforce, the MicroStrategy Badge app sends the user's encrypted credentials to the SAML enabled site, logging in without requiring the user to scan a QR code, or accept a push notification.

A user can pair their smartphone with multiple computers; however, each computer can be paired to a single smartphone at a time.

If a user changes their computer's password, they will be prompted to enter the new password in the MicroStrategy Badge app.

  • You have a MicroStrategy Cloud implementation.
  • If you have MicroStrategy Identity installed on your local IT infrastructure, you need to have Apple Push Notification Service from Apple. For more information, see the Apple Developer Library.
  • The computer on which you enable passwordless unlocking must meet the following requirements:
    • OS X® Yosemite/ El Capitan
  • Have one of the following certified Mac versions:
    • Mac mini (late 2012)
    • Macbook Pro (late 2013)
    • Macbook Air (late 2011)
  • The user unlocking her computer must have an iOS iPhone:
    • iPhone 4S, 5, 5S, 6, 6S

The user's smartphone and computer must be connected to the Internet while she pairs them with each other. After the user successfully pairs their smartphone with their computer, her computer does not need to be connected to the Internet to be able to unlock it.

To unlock a computer, the user must meet the following requirements:

  • Bluetooth wireless technology must be turned on for both her computer and her smartphone. See your third-party documentation for steps to turn on Bluetooth wireless technology.
  • MicroStrategy Badge for Mac application must be running.

To Download MicroStrategy Badge for Mac

  1. Log into MicroStrategy Identity Manager.
  2. Click Logical Gateways.
  3. Under Computer Workstation Access, click the Mac icon Mac icon.
  4. Click Download App. The UsherforMac.zip file is downloaded.
  5. On the computer on which you want to enable passwordless unlocking, double-click the UsherforMac.zip file to unzip it, then open the MicroStrategy Badge for Mac application.
  6. Review the Welcome information, then click Get Started. A QR code is displayed, for pairing your smartphone with your computer.
  7. On your smartphone, open the MicroStrategy Badge app and scan the displayed QR code.
  8. When your smartphone is successfully paired with your computer, click Done.

You can now unlock and lock your Mac using MicroStrategy Badge. For steps, see To Unlock Your Mac Using the MicroStrategy Badge on Your iPhone.

To Unlock Your Mac Using the MicroStrategy Badge on Your iPhone

  1. Ensure that your Mac is open. If it is sleeping, tap on the mousepad to awaken it.
  2. Hold your iPhone close to the locked Mac.
  3. If there are no conditions on your badge, the computer is unlocked without any further interaction.
    • If your badge requires a condition, the condition must be fulfilled before you can unlock your Mac.
    • If you have enabled a passcode for your badge, open the MicroStrategy Badge app on your iPhone and enter the passcode. The Mac then unlocks.

To Enable Locking with MicroStrategy Badge for Mac

  1. On your Mac, open the MicroStrategy Badge for Mac application, then from the navigation bar at the top of your screen, click the MicroStrategy Badge for Mac icon.
  2. Click the toggle to enable Lock Mac.
  3. You can specify the bluetooth signal strength that needs to be met in order to lock your Mac, as well as how long to wait before locking your computer. To change the default settings, do the following:
    1. From the MicroStrategy Badge for Mac page, click the Settings icon and select Advanced Settings.
    2. To change the threshold of your bluetooth signal strength, use the slider under Bluetooth Signal Strength to set a value.
    3. To change the timer for locking your Mac, use the slider under Timer to set a time value.
    4. By default, Allow Cancellation for the locking of your Mac is enabled. You can disable this setting by clicking the toggle.

Logging In to Websites Using MicroStrategy Badge for Mac

  1. Navigate to a SAML enabled website. For example, https://salesforce.com. Contact your MicroStrategy Identity Administrator to find out what websites are integrated with Identity SAML.
  2. At the pop-up notification for MicroStrategy Identity, click Enable to allow a secure connection to be established between your MicroStrategy Badge app and the SAML website.
  3. After pairing, you are redirected to the SSO page for that website, which searches for your MicroStrategy Badge bluetooth signal and logs in.
  4. If at any time you want to enter your user name and password for the website instead of using SSO Login, click Enter my credentials.
  5. If you want to remove the pairing between your browser and MicroStrategy Badge for Mac, click the MicroStrategy Badge for Mac icon. Under Web SSO Login, click Remove Pairing.

To Remove the Pairing Between Your Smartphone and Mac

  1. On your Mac, open the MicroStrategy Badge for Mac application, then from the navigation bar at the top of your screen, click the MicroStrategy Badge for Mac icon.
  2. Click the name of your smartphone, then select Remove Pairing. The pairing between your smartphone and your computer is removed, and you can no longer unlock your computer using MicroStrategy Badge.

To Re-Pair a Smartphone with Your Mac

  1. On your Mac, open the MicroStrategy Badge for Mac application, then from the navigation bar at the top of your screen, click the MicroStrategy Badge for Mac icon.
  2. Select Pair a New Device.
  3. Click Get Started. A QR code is displayed, for pairing your smartphone with your computer.
  4. On your smartphone, open the MicroStrategy Badge app and scan the QR code.
  5. When your smartphone is successfully paired with your computer, click Done.

To Troubleshoot Pairing Between Your Smartphone and Mac

If your smartphone or Mac is continually searching, and fails to show a native pairing, try the following solutions:

Solution 1

  1. Cancel the pairing.
  2. On your Mac, open System Preferences, then Bluetooth.
  3. Remove all paired smartphone devices.
  4. Reattempt to pair your Mac with your smartphone.
  5. If this attempt fails, then proceed to Solution 2.

Solution 2

  1. Repeat Solution 1.
  2. On your smartphone, navigate to Settings, then Bluetooth.
  3. If your targeted Mac is listed there, tap to Forgot This Device.
  4. Attempt to pair your Mac with your smartphone again.
  5. If this attempt fails, then proceed to Solution 3.

Solution 3

  1. Repeat Solution 2.
  2. Restart your Mac. Then restart your smartphone.
  3. Attempt to pair your Mac with your smartphone.

If none of theses troubleshooting solutions solve your issue, please contact MicroStrategy Identity Technical Support.

To Troubleshoot Unlocking Your Mac with Your Smartphone

If your Mac fails to unlock within 20 or less seconds, try the following solutions:

Solution 1

  1. Ensure that your credentials saved in the MicroStrategy Badge app are correct.
  2. If they are and you are still unable to unlock your Mac, proceed to Solution 2.

Solution 2

  1. On your Mac, log in by entering your password.
  2. From the top toolbar, turn off bluetooth.
  3. Then, turn bluetooth back on.
  4. Lock your Mac, and attempt to unlock it using MicroStrategy Badge.

To Troubleshoot Receiving a BLEerror Message

If you are unable to unlock your Mac with MicroStrategy Badge and receive a bluetooth error, try the following solution:

  1. Restart your iPhone.
  2. On your Mac, log in by entering your password. You need to clear the bluetooth cache.
  3. If your MicroStrategy Badge for Mac app is open, quit the application.
  4. Turn off bluetooth.
  5. Navigate to Library/Preferences and delete the file named com.apple.Bluetooth.plist.
  6. Navigate to Library/Prefrences/SystemConfiguration and delete the file named com.apple.Bluetooth.plist.
  7. Navigate to Library/Preferences/ByHost and delete the file named com.apple.Bluetooth.somerandomcharacters.plist.
  8. Navigate to Library/Preferences/ByHost and delete the file named com.apple.Bluetooth.plist.
  9. Next, restart your Mac.
  10. Turn on bluetooth, and open the MicroStrategy Badge for Mac app.

Related Topics

Categorizing MicroStrategy Badge Resources

Creating a MicroStrategy Identity Network and Issuing an Administrator Badge

Distributing Badges to Users in Your MicroStrategy Identity Network

MicroStrategy Badge for Windows (10.7 and Older)

Logical Gateways