We're here to help.

Mobile Device Management (MDM)

Mobile Device Management (MDM) is an optional security and advanced configuration feature that lets Butterfly Enterprise organizations manage access to their Butterfly account and optimize authentication workflows with their corporate-owned devices. With MDM configured, the Butterfly iQ mobile app will respect advanced configurations deployed remotely with the application. 

Butterfly currently has three MDM configuration options. Customers can configure any of the options below independently and should do so based on their current operating environment. The configurations are:

  1. MDM Device Restrictions
  2. MDM Shared Device Rapid Log In
  3. Butterfly iQ Session Time Out

Configurations 1-3  are ideal for an environment with fully corporate-owned devices, however, in the more common occurrence of a hybrid between corporate and bring your own device (BYOD), 2 and 3 may not be ideal as they are primarily for shared devices.

Note:  As a precursor to the directions below, make sure Butterfly iQ is deployed to your corporate-owned mobile devices and that the Butterfly iQ App can receive automated updates without user intervention as soon as the update is made available through the applicable app store. Since the Butterfly iQ probe and App are together classified as a medical device - this will ensure that any critical changes or new/improved clinical functionality will reach our end users as quickly as possible.

MDM Restrictions

With MDM Device Restrictions, Butterfly Enterprise organizations can restrict access to their Butterfly account to only devices that have an MDM profile installed. 

To enable MDM Device Restrictions:

  1. Contact your existing users alerting them that they will need an MDM-enrolled device to continue accessing Butterfly Cloud.
  2. Log into Butterfly using your Enterprise administrator email and password via your custom Enterprise URL.
  3. Select your avatar on the top right corner of the screen and select "Enterprise Settings".
  4. Select the “MDM” tab. In this tab, you will see your Enterprise specific secret. 
  5. In your MDM system, deploy the “Butterfly iQ” app to the desired devices.
  6. Add a custom application configuration to the deployment and copy the key/value pair from Butterfly Cloud into that configuration.
    • Attribute Name: ApprovedEnterpriseDeviceSecret
    • Attribute Type:  string
    • Value (from Entterprise MDM Setting in Butterfly Cloud):  MySecRetStRiNg
  7. Once the app has deployed, check the box on Butterfly Cloud that says “Restrict logging into Butterfly iQ to devices provisioned with secret app configuration.”
  8. Log in from an approved device and confirm that you can log in successfully.

MDM Shared Device Rapid Log In

With Shared Device Rapid Log In enabled, the Butterfly iQ mobile app will open to the organization’s specific Enterprise URL without any additional typing or taps. This setting is recommended for all of your MDM provisioned mobile devices.

To enable MDM Device Restrictions:

  1. In your MDM system, deploy the “Butterfly iQ” app to the desired devices.
  2. Add a custom application configuration to the deployment with the following parameters.
    • Attribute Name: ButterflyDomain
    • Attribute Type:  string
    • Value (your subdomain):  myhospital
      • For example, if your Enterprise URL is myhospital.butterflynetwork.com the value would simply be "myhospital".
      • NOTE: the value is case sensitive and must be all lowercase.
  3. Once the app and configuration has been deployed, open the app and you should be guided directly to your enterprise’s SSO log in page.

Butterfly iQ Session Time Out

Note:  We recommend using Butterfly iQ Session Time Out on shared devices. 

Butterfly Enterprise users who are using a shared device will be logged out before the next scanner accesses the device. For devices that are deployed with Mobile Device Management (MDM), the MDM administrator can use a custom application configuration to do two things:

  1. Enable phones to log out after a period of inactivity
  2. Control the number of seconds after inactivity that the device will perform a log out

To enable Butterfly iQ Mobile Device Time Out With MDM for Your Organization:

  1. In your MDM system, deploy the “Butterfly iQ” app to the desired devices.
  2. Add a custom application configuration to the deployment with the key being “InactivityTimeoutSeconds” and the value being the number of seconds after the device goes idol will the log out occur. 
    • Attribute Name: InactivityTimeoutSeconds
    • Attribute Type:  integer
    • Value (time in seconds):  900
      • Please adjust the time as needed based on your workflow. For example - if multiple departmental users will be sharing the mobile device then you may want a shorter timeout, versus a device that may be used by a single provider for the duration of a shift.  
  3. Deploy the custom configuration to your MDM’ed devices and confirm that the timeout is working.

Note:  If you have previously deployed and the Butterfly iQ application prior to deploying an MDM application configuration you will need to force quit the application after the configuration has been applied. The next time the application is opened after the deploy the configuration will be activated. 

Note:  If you are logged out with captures in your exam reel that have not been uploaded you will have an opportunity to log back in and complete the upload.

Sample MDM Application Configuration 

<dict>

<key>ApprovedEnterpriseDeviceSecret</key>

<string>XXXXXXXXXXXXX</string>

<key>ButterflyDomain</key>

<string>myhospital</string>

<key>InactivityTimeoutSeconds</key>

<integer>900</integer>

</dict>

Was this article helpful?
0 out of 0 found this helpful
Thank you for your feedback

We’re sorry this didn’t answer your question. We’re here to help. Contact us