We're here to help.

Setup and Configuration Guide for Azure ADFS


  • Contact Butterfly Support to set up your custom logon sub-domain.

    • Example:  https://myhospital.butterflynetwork.com

  • Provide your preferred email address to Butterfly Support to grant you access as an Enterprise Administrator. Only an Enterprise Admin account can access the security configuration settings within Butterfly Cloud.



  1. Log into Butterfly Cloud with your Enterprise Admin account.

    1. Your login page will be at your Butterfly Network Enterprise URL.

  2. Click your user initials in the top right of the window and select Enterprise Settings.

  3. SSO is the first tab, which allows you to configure the Single Sign-On integration with your corporate Identity Provider (IdP) solution.

    1. Examples include: Okta, Imprivata, Microsoft ADFS

  4. It is recommended to keep both Allowed Login Types enabled during the transition period to SSO authentication.

    1. Once you have successfully validated the SSO integration you may disable the ability for users to login with Butterfly Credentials.

  5. Service Provider Details - this information is static for your instance of Butterfly Enterprise. Please enter the provided information when configuring Butterfly Network as an SSO-enabled application in the configuration screen(s) of your Identity Provider’s (IdP) software.


Add Butterfly iQ as a New Enterprise Application in Azure ADFS

On the Azure homepage, navigate to the "Enterprise Applications" service.

  1. Click "New application".

  2. Under "Add your own application" click "Non-gallery application".

  3. Enter a name for your application and click "Add application".


Configure the Butterfly iQ SSO Settings in Azure ADFS

  1. Click "Set up single sign on".

  2. Click "SAML".

  3. Edit the Basic SAML Configuration to match the following:

    1. SSO URL: https://sso.butterflynetinc.com/saml2/idpresponse

    2. Logout URL: https://<your-domain>.butterflynetwork.com/-/federated-auth/logout

    3. Entity ID (aka Audience): urn:amazon:cognito:sp:us-east-1_DPQCgPjWG

    4. Entity ID (aka Audience): urn:amazon:cognito:sp:us-east-1_DPQCgPjWG

      1. Email Address: NameID

      2. Email Address: DomainUser.Email

  4. In the Logout Url field, replace "your-domain" with the subdomain of your enterprise cloud.

  5. Edit the "User Attributes & Claims" to match the following:


    You may map each claim from any value that contains the user's email.


Testing Log In


Testing in a Web Browser

  1. Go to your Butterfly Network subdomain address. E.g. https://myhospital.butterflynetwork.com

  2. Select the Login with Company Name Option (Blue Button).

  3. Ensure that you are taken to your corporate IdP login page.

  4. Login with your corporate credentials - you should be automatically taken to Butterfly Cloud upon successful login.

  5. Logout from Butterfly Cloud - you should be taken back to the Butterfly Cloud login page.


Testing in the Mobile App

  1. Open the Butterfly iQ App on your mobile device.

  2. At the login screen - tap the Enterprise User? Log in here option.

  3. On the following screen enter your Butterfly Network subdomain. (e.g. myhospital.butterflynetwork.com).

  4. Select the Login with Company Name Option (Blue Button). Note: If you have enabled MDM Shared Device Rapid Log In this step will be skipped.

  5. Ensure that you are taken to your corporate IdP (mobile) login page.

  6. Login with your corporate credentials - you should be automatically taken to the Butterfly iQ App upon successful login.

  7. Logout from Butterfly iQ App - you should be taken back to the corporate Butterfly iQ App login page.

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