Logging In and Out

The Commure Pro icon provides access to the Commure Pro application. The Commure Pro icon is usually located on the Home screen, along with the other application icons. After tapping the icon to launch the application, providers can log into the application using either a password, a numeric PIN, Open Authentication (OAuth) capability, or Android’s Fingerprint Authentication. See Logging In and Logging Out. Your organization might also use Open Authentication (OAuth) for stronger login security and protection. Commure Pro integrates with Microsoft Azure Active Directory (AD) to provide this level of security for mobile users. During the login process, on the Commure Pro login screen, you enter your Commure Pro user name only. Then, you are directed to a Microsoft login screen where you enter your AD user name and password. You are then re-directed back to the Commure Pro application and the Patient List screen is displayed.

​

Logging In

The Commure Pro application supports two modes of logging in, depending on your experience level:

• Basic Mode: This is the default method, and also the simplest. Providers typically use this method. See the following topics:
  • Logging in the First Time Using Basic Mode (Provisioning the Device)
  • Logging in a Second/Subsequent Time Using Basic or Advanced Mode
  • Changing the Username or Host Fields (Reprovisioning the Device)
• Advanced Mode: This mode is for advanced users such as administrators who frequently change the values of the Username or Host fields for testing purposes. See the following topics:
  • Logging in the First Time Using Advanced Mode (Provisioning the Device)
  • Logging in a Second/Subsequent Time Using Basic or Advanced Mode
  • Changing the Username or Host Fields (Reprovisioning the Device)

​

Logging in the First Time Using Basic Mode (Provisioning the Device)

Once the Commure Pro application has been downloaded and installed on your device as described in Installing the Commure Pro Application, you can log into the application using Basic Mode, which is the default login mode. This is the simplest login mode and it is typically used by providers. The first time you log in, a few extra steps are required to provision the device, which performs the initial download of user and patient information. After the first login, subsequent logins are quicker.

1. If the Commure Pro application is not already open after having installed it (and showing the Login screen), tap the Commure Pro icon to launch the app. The Login screen appears.
2. Complete each of the fields below.
   • Username: Enter the provider’s Commure Pro username that was provided by your system administrator.
   • Password: Enter the provider’s Commure Pro password. Your password might be one that is configured (and changeable) on the Commure Pro web application, or it might be the same one that you use in your source AD/LDAP system (such as a Windows® password), or it might be the same one that you use in your source ADT/Registration system (such as a MEDITECH® password). A password can consist of any combination of alpha, numeric, or special characters.

3. Tap LOGIN.

If OAuth is enabled on the host, you are directed to the Microsoft login screen. Enter the username and password provided by your system administrator. When the Microsoft Authentication server successfully validates your AD username and password, you are re-directed to the Commure Pro application. You might also be required to provide a token code from the Microsoft Authenticator application as part of the login process. The application must be installed on your Android device. The application now searches the Commure Pro Central Provisioning Server (a master database of all Commure Pro users) for a matching username.

• If only one match is found, the application automatically enters the server address for your organization into the Host field for you (behind the scenes), and then logs you into the application (assuming your password is also valid).
• If more than one match is found for your username (for example, you work at more than one organization that uses Commure Pro, or more than one person has this username), the Select Host screen is shown. The Select Host screen displays a list of list of server names. Select the server that you want. You may notice some servers with similar names. These may be cases of servers in different time zones (for example, “CST” or “EST”); be sure to select the server that matches your own timezone. Once you select a server, the application completes the Host field for you (behind the scenes), and then logs you into the application (assuming your password is also valid for the selected server).

• If no matches are found, the following message is displayed: “User Not Found. We were unable to locate user “[the username you entered]” in our database. If your system administrator has provided you with a host name and you would like to enter it now, select Use Advanced Login.” Check to confirm that you spelled your username correctly and then select one of the options from the dialog box as follows:
• DISMISS: If your username is not spelled correctly, select DISMISS to return to the Login screen, retype your username, and then tap LOGIN again. If your username is spelled correctly, and your administrator did not provide you with a server address, tap DISMISS to close the dialog and contact your system administrator for instructions.
• USE ADVANCED LOGIN: Select this option if your username is spelled correctly and your administrator did provide you with a server address for the Host field. When the Host field is displayed, enter the server address. The address may use any of the acceptable formats listed below:
• The URL address, such as: generalhospital.commure.com
• The IP address, such as: 172.55.5.555 After you finish typing the address, the application contacts the server to verify that the address is valid. If the address is valid, the value you entered is replaced with a “user friendly” name for the host, such as “General Hospital” followed by a checkmark to indicate that it is valid. Once the address has been verified as valid, tap LOGIN. The system authenticates the login information and following messages are displayed: “Provisioning. Logging in. Synchronizing.”

4. If your organization has enabled PIN authentication, the following prompt is now displayed: “Do you want to use a numeric PIN in place of a password for mobile device authentication?”
   • Select OK to immediately establish a numeric PIN that the provider can use to log into the Commure Pro application. If the provider’s password is a complex one that uses a combination of alpha, numeric, or special characters, they might find it easier to use a numeric-only PIN. Once a PIN is established, the provider can then use either the PIN or their password to log into the Commure Pro application (and easily switch between the two). See Establishing a PIN for Logging In for more information and instructions.
   • Select Cancel to exit the dialog without establishing a PIN. If you are an administrator installing the application for a provider, you may want to choose Cancel. The provider can establish a PIN later by selecting More > Settings > Manage PIN. The Patient List screen is now displayed. The device is now ready for the provider to start using the application.

Fingerprint authentication can also be used to log into the Commure Pro application, but only after the initial login and provisioning process described above.

​

Logging in the First Time Using Advanced Mode (Provisioning the Device)

Once the Commure Pro application has been downloaded and installed on your device, administrators or advanced users can log into the application using either Basic Mode (the default mode, which assists the user in selecting a value for the Host field) or Advanced Mode (which allows the user to complete the Host field themselves). If you wish to use Advanced Mode, you must first switch to that mode, and then log into the application. The first time you log in, a few extra steps are required to provision the device, which performs the initial download of user and patient information. After the first login, subsequent logins are quicker.

1. If the Commure Pro application is not already open after having installed it (and showing the Login screen), tap the Commure Pro icon to launch the app. The Login screen appears.
2. Select SETTINGS at the top right of the Login screen.
3. On the Settings screen, tap Login Mode and then choose “Advanced.”
4. Tap Back to return to the Login screen. The Login screen is displayed.
5. Complete the fields below. All fields are required.
   • Host: Enter the address of the Commure Pro server. The address may use any of the acceptable formats listed below:
   • The URL address, such as: generalhospital.commure.com
   • The IP address, such as: 172.55.5.555 After you finish typing the address, the application contacts the server to verify that the address is valid. If the address is valid, the value you entered is replaced with a “user friendly” name for the host, such as “General Hospital” followed by a checkmark to indicate that it is valid.

• Username: Enter the provider’s Commure Pro username that was provided by your system administrator.
  • Password: Enter the provider’s Commure Pro password. Your password might be one that is configured (and changeable) on the Commure Pro web application, or it might be the same one that you use in your source AD/LDAP system (such as a Windows® password), or it might be the same one that you use in your source ADT/Registration system (such as a MEDITECH® password). A password can consist of any combination of alpha, numeric, or special characters.

6. Tap LOGIN.

If OAuth is enabled on the host, you are directed to the Microsoft login screen. Enter the username and password provided by your system administrator. When the Microsoft Authentication server successfully validates your AD username and password, you are re-directed to the Commure Pro application. You might also be required to provide a token code from the Microsoft Authenticator application as part of the login process. The application must be installed on your iOS device. The system authenticates the login information and following messages are displayed: “Provisioning. Logging in. Synchronizing.”

7. If your organization has enabled PIN authentication, the following prompt is now displayed: “Do you want to use a numeric PIN in place of a password for mobile device authentication?”
   • Select OK to immediately establish a numeric PIN that the provider can use to log into the Commure Pro application. If the provider’s password is a complex one that uses a combination of alpha, numeric, or special characters, they might find it easier to use a numeric-only PIN. Once a PIN is established, the provider can then use either the PIN or their password to log into the Commure Pro application (and easily switch between the two). See Establishing a PIN for Logging In for more information and instructions.
   • Select Cancel to exit the dialog without establishing a PIN. If you are an administrator installing the application for a provider, you may want to choose Cancel. The provider can establish a PIN later by selecting More > Settings > Manage PIN. The Patient List screen is now displayed. The device is now ready for the provider to start using the application.

Fingerprint authentication can also be used to log into the Commure Pro application, but only after the initial login and provisioning process described above.

​

Logging in a Second/Subsequent Time Using Basic or Advanced Mode

These instructions assume that you have already logged in at least one time using either Basic Mode or Advanced Mode to perform the initial download of user and patient data, as described in:

• Logging in the First Time Using Basic Mode (Provisioning the Device)
• Logging in the First Time Using Advanced Mode (Provisioning the Device) Once the initial login has been performed, subsequent logins are quicker. The steps are the same in both Basic and Advanced Mode.

1. From the Home or Applications screen, tap the Commure Pro icon . The Login screen is displayed. The Host (the server to which you are connected) and your Commure Pro Username are already filled in. Do not change these fields unless you want to clear the data on the device and reprovision it.
2. Below the Username field, enter your Commure Pro password, PIN, or use Android’s Fingerprint feature. The options available to you depend on which features have been enabled. When entering a password or a PIN, you have a limited number of tries to enter it correctly. If you exceed the number of attempts, you are locked out of the Commure Pro application. Contact your system administrator for assistance if this occurs.

• Password: If Password authentication is enabled, the field below Username is labeled Password. Enter your Commure Pro or other system password and then select the LOGIN button or the Go key (on the keyboard).
• Password and PIN: If both Password and PIN authentication are enabled (and your PIN has been established via Establishing a PIN for Logging In), the field below Username is labeled either Password or PIN, depending on which you used the last time you logged in. If it is labeled Password, enter your password. If it is labeled PIN, enter your PIN. Or, if you want to switch from one type to the other, tap into the Password or PIN field and then select the Keyboard icon on the right side of the field. The field then changes to the other type, so that you can enter the other item (password or PIN). Enter your Commure Pro, or other system password, or enter your PIN, and then select the LOGIN button or the Go key (on the keyboard).
  • Fingerprint with Password, or Fingerprint with Password and PIN: If Fingerprint authentication is enabled in addition to Password, or in addition to Password and PIN (and your Fingerprint and PIN have been established via Establishing Fingerprint Authentication for Logging In or Signing Orders and Establishing a PIN for Logging In), then immediately after you select the Commure Pro icon the following dialog is displayed: “Sign in: Confirm fingerprint to continue.” Just press your finger lightly on the device sensor to register your fingerprint and immediately log in. If you prefer to use your password or PIN instead of Fingerprint authentication, or if your fingerprint is not accepted (as might happen if your finger is damp or dirty), you can tap Use Password to access either the Password or the PIN field. If only Password is enabled, then the Password field is shown. If both Password and PIN are enabled, then one or the other of those fields is shown, depending on which you used the last time you logged in. Enter your password in the Password field, or enter your PIN in the PIN field. To change the Host or Username, tap Cancel to access the login screen where you can edit those entries. After you log in successfully, the Patient List module is displayed. If you have access to only a single patient list, it is automatically selected for you.

​

Changing the Username or Host Fields (Reprovisioning the Device)

In some cases, you may want to change the values in the Username or Host fields. This is commonly referred to as reprovisioning the device for a new user or host. When you reprovision a device, it clears all user and patient data (including unsubmitted data such as charges or orders), but does not remove the Commure Pro application itself. It then downloads a fresh set of data for the new user or host. Below are some common cases when you might need reprovision the device by changing the Username or Host fields:

• You are a provider who works at more than one organization that uses Commure Pro. You will need to change the Host field, and possibly also the Username field, when you want to switch from one organization to another.
• The institution owns the device and would like to transfer it to a new user because the previous user has left. The Username field will need to be changed.
• You are an administrator who does frequent testing on multiple servers. You will need to change the Host field, and possibly also the Username field, when you want to switch from one server to another. You can reprovision the device for a new user and/or a new host directly on the Login screen, by following the instructions below.
• Changing the Username or Host Fields Using Basic Mode
• Changing the Username or Host Fields Using Advanced Mode Or as an alternate method, you could also use the Clear Data option (see Clearing Data from a Device) and then follow the steps in Logging in the First Time Using Basic Mode (Provisioning the Device) or Logging in the First Time Using Advanced Mode (Provisioning the Device).

You must have the physical device in hand in order to reprovision it or clear data.

​

Changing the Username or Host Fields Using Basic Mode

1. Select the Commure Pro icon . The Login screen is displayed and shows the last used values for Host and Username.
2. Determine which fields (Host and/or Username) need to change:
   • If the current user wants to sync to a different host (and their username is the same for both hosts), then the value in the Host field must be changed.
   1. Tap the Host field.
   2. When the Select Host screen appears, select the new host from the list of matches. (Or, if the host you want is not listed, tap OTHER in the lower right corner to enter the Host manually).
   3. When the Login screen reappears, enter the user’s password for the new host and then tap LOGIN
   • If the current user wants to sync to a different host (but their username is different for the other host), or if a different user wants to sync to a different host, then the values in both the Host and Username fields must be changed.
   1. Tap into the Username field and change the value.
   2. Tap the Host field.
   3. When the Select Host screen appears, select the new host from the list of matches. (Or, if the host you want is not listed, tap OTHER in the lower right corner to enter the Host manually).
   4. When the Login screen reappears, enter the user’s password for the new host, and then tap LOGIN
   • If a different user wants to sync to the current host, then the value in the Username field must be changed.
   1. Tap into the Username field and change the value.
   2. Tap into the Password field and enter the new user’s password, and then tap LOGIN The system authenticates the login information and following messages are displayed: “Provisioning… Logging in… Waiting for data… Downloading… Updating Data… Logging in…”
3. If your organization has enabled PIN authentication, the following prompt is now displayed: “Do you want to use a numeric PIN in place of a password for mobile device authentication?”
   • Select OK to immediately establish a numeric PIN that the provider can use to log into the Commure Pro application. If the provider’s password is a complex one that uses a combination of alpha, numeric, or special characters, they might find it easier to use a numeric-only PIN. Once a PIN is established, the provider can then use either the PIN or their password to log into the Commure Pro application (and easily switch between the two). See Establishing a PIN for Logging In for more information and instructions.
   • Select CANCEL to exit the dialog without establishing a PIN. If you are an administrator installing the application for a provider, you may want to choose CANCEL. The provider can establish a PIN later by selecting More > Settings > Manage PIN. The Patient List screen is displayed. The device is now ready for the provider to start using the application.

​

Changing the Username or Host Fields Using Advanced Mode

1. Select the Commure Pro icon . The Login screen is displayed. It shows the last used Host and Username.
2. Tap into the Host and/or Username field(s) and clear the current value in the field(s). Then enter the new value(s) for the field(s).
   • Host: Address of the Commure Pro Application Server. For example: generalhospital.commure.com

• Username: The provider’s Commure Pro username. The following message is displayed: “[Host or User Name]* Changed. Changing the* [host or user name]* will require this device to be reprovisioned. Do you want to continue?”*

3. Select CONTINUE.
4. In the Password field, enter the provider’s Commure Pro password.
5. Select the LOGIN button on the screen, or Go key (on the keyboard) .

The system authenticates the login information and following messages are displayed: “Provisioning. Logging in. Synchronizing.”

6. If PIN authentication has been enabled, follow the instructions in Step 2, in the section entitled Establishing a PIN for Logging In to possibly establish a PIN at this time. The Patient List screen is displayed. The device is now ready for the provider to start using the application. Please consult the appropriate Commure Pro quick reference card for instructions on using the application.

​

Establishing a PIN for Logging In

If your password is a complex one that contains a combination of alpha, numeric, or special characters, you might find it easier to use a numeric-only PIN. Once a PIN is established, you can then use either the PIN or your password to log into the Commure Pro application (and easily switch between the two). Please note that if you have multiple devices running the Commure Pro application, you must establish a PIN on each device. You may use the same or a different PIN on each device. PIN authentication is available only if it has been enabled by your administrator. If PIN authentication is enabled, then when you provision your device and log in for the very first time, the following prompt is immediately displayed: “Do you want to use a numeric PIN in place of a password for mobile device authentication?” If you respond OK to this prompt, the Create PIN screen is displayed and you can immediately establish your PIN (follow the instructions below starting at Step 2). If you CANCEL out of this dialog, you can establish your PIN later, by following the steps below:

1. Tap the More button and then select Settings > Manage PIN. The Create PIN screen is displayed.
2. Complete the following fields:
   • Enter Password: Enter your Commure Pro password (the same one you used to log into the application).
   • Enter New PIN: Enter a numeric PIN. Your organization may have specified a minimum and maximum number of digits for the PIN, and may also disallow PINs that are the same number repeated (for example: 1111), or that are sequential (for example: 1234 or 4321).
   • Enter New PIN Again: Enter the same PIN a second time.
3. Select SAVE at the bottom of the screen. The following message is displayed: “The PIN was successfully saved.”
4. Select OK to close the dialog, and then tap the Back button at the top of the screen to exit the Settings option. The PIN is now established and can be used to log into the Commure Pro application. See Logging In.

At any time you can change your PIN by repeating Steps 1 through 4 above. Or, if you wish to discontinue using a PIN, you can clear it:

1. Tap the More button then select Settings > Manage PIN. The Manage PIN screen is displayed.
2. Select DELETE PIN. The PIN is now cleared and you must use your password to log in.
3. Tap the Back button at the top of the screen to exit the Settings option. The PIN is now cleared and you must use your password to log in (or Fingerprint, if enabled).

Certain actions can affect your PIN:

• If you change your password, then the first time you attempt to log in after it is changed, you will be required to use your password to log in. After that, you can use your previously established PIN again.
• If you or an administrator perform any of the actions listed below, the PIN is cleared from the device and must be reestablished.
  • Change the Host or Username on the device’s Login screen.
  • Change your Username on the Physician Portal application, via Admin > User > General Settings (this will require you to also change the Username on the device’s Login screen).
  • Use the Clear Data option.
  • Remove the Commure Pro application from the device.

​

Establishing Fingerprint Authentication for Logging In or Signing Orders

Certain later model Android™ devices are equipped with a Fingerprint Authentication feature. When it is configured on a device, you can just touch your finger to a sensor, and the device reads your fingerprint to confirm your identity. This feature can be used to unlock your device from sleep mode, or it can be used within an application such as Commure Pro. If your administrator enables this feature for the Commure Pro application, then instead of entering a password or PIN, you can use your fingerprint to log into the Commure Pro application and/or to sign and submit orders in the Orders module. In order to use Fingerprint Authentication, your Android device must meet the requirements below:

• The device must be running Android OS 6 or later.
• The device must be a later model Android device that has a fingerprint sensor.
• The Fingerprint Authentication feature must be set up outside of the Commure Pro application before it can be used to log in or to sign and submit orders. To set it up, select Settings > Security > Fingerprint and then follow the on-screen instructions.

​

Logging Out

1. Tap the More button and then select Exit. A confirmation message appears.
2. Select Yes to logout. You are logged out of the application and the Commure Pro Login screen is displayed.
   • As long as the Login screen is displayed, the Commure Pro application continues to synchronize with the organization’s server in the background in order to retrieve the latest patient information. This means that when you log back in, the most current data is immediately downloaded to your device. To log in again, re-enter your password or PIN or use Fingerprint authentication.
   • If you press the Home key on your device from the Login screen or any other Commure Pro screen, the application is shut down and the device stops syncing.

​

When Your Device Times Out

After a period of inactivity, your device may automatically time out of the Commure Pro application and return to the Login screen. Your system administrator defines the amount of time required before the timeout takes effect. This feature protects patient confidentiality. Even when the device is timed out, it continues to synchronize with the organization’s server in the background in order to retrieve the latest patient information. This means that when you log in again, the most current data is immediately downloaded to your device. From the Login screen, you must re-enter your password or PIN, or use Fingerprint authentication in order to access Commure Pro again. Once you are logged in, you are returned to the last screen in your session prior to the timeout.