AppConfig for Epic Rover (Request)

reon
Contributor

I'm being assigned to find out AppConfig for Epic Rover App, so we can deploy the App with server URL and path.

There's not much information online, and seems like most app developers are not aware of this feature at all.

Ranting aside, anyone has anything related to share?
Thanks in advanced

26 REPLIES 26

adam_mahmud
New Contributor III
New Contributor III

Hey @reon!

Epic supports Apple’s Managed App Configuration for all of their iOS apps! Reach out to me at Adam (dot) Mahmud (@) Jamf (dot) com.

Adam
Jamf Healthcare

dvasquez
Valued Contributor

We do this for our Epic apps and the app configs are generated by our in house epic team. Epic does support this. Good luck!

Do you have onsite epic engineers or access to the Epic User Web?

Thanks.

reon
Contributor

Hi @adam.mahmud, I've dropped you an email, thanks in advance

reon
Contributor

Hey @dvasquez, mind to share the AppConfig for Epic Rover with me?

dvasquez
Valued Contributor

The app config is for our environment specifically. It is a string.

I will see if I am able to do that.

Dominic

reon
Contributor

@dvasquez Hi Dominic, are you able to share your AppConfig with me? you can masked out sensitive info like URL. I just want to know the variable names

dlbrabb
New Contributor III

Just like @dvasquez mentioned, this string is specific to your Epic environment. But here's what our Epic Rover App Config looks like.
fd278b0f7b254d928d82f8fefec809b0

reon
Contributor

@dlbrabb thanks!! will try that out!

reon
Contributor

@dlbrabb sadly, still doesn't work on me.
53c3a87a2293465cb67edf0d980c1f4b

43cf288eec664551bab8171dde936aef

dlbrabb
New Contributor III

@reon Did you include the "epicrover://handheld/config/" in the string? I don't see it, but maybe it's blacked out?!?!?

dlbrabb
New Contributor III

You should be able to get a link from Epic, that will give you the Canto, Haiku, and Rover configurations.
Should look something like this:

https://*.epichosted.com/mobileconfigs/MobileConfigsProduction.html

Once you get this link, you can hover over the links and see the app config strings.

dvasquez
Valued Contributor

I am sorry for the late reply: here is an example of our as @dlbrabb mentioned:

Configuration Key: EpicMobileConfigurationURL
Value Type: String
Configuration Value: epiccanto://handheld/config/a0I5gduEPo1cD%2flz*V7MWx5k%3d

If you still need help I will try and contact our Epic staff to see what department is responsible for building App configurations.

Hope this helps.

kyletoburen
New Contributor II

When you apply a Rover configuration with the AppConfig, you will NOT see it in settings, under Rover. It is only available in the Rover app. This is a Rover limitation.

You have to follow the instructions in the Haiku, Canto, and Rover Fundamentals Setup and Support Guide from the Epic Galaxy documentation site. The large section called “Haiku, Canto, and Rover Setup: Essentials” explains it all.
https://galaxy.epic.com/Redirect.aspx?DocumentID=100019671

You have to use the windows application called “MobileConfigurationTool.exe” to generate the specific handheld config string for your specific environment. That string is then placed in the AppConfig section of Jamf. Again explained in that Galaxy document. I create different apps in Jamf and associate different configs for different purposes. On the analyst devices I include multiple environments for the system analyst to choose from, for testing. On production devices, they only get the one production environment.
I have also created a webclip to a webpage that has all of these config strings in them, so that a tech or analyst can manually add these. I have had success making them into QR Codes to apply whatever config, too.
A google search on Haiku configuration, will bring up many hospitals that publish external links with these configs in the webpage.
It was a lot of trial and error, but it works swell at our site.

iDobbins
New Contributor II

Hello, did anyone get this to work? I already have the config file as we have mulitple MDMs in our environment. I'm missing the way JAMF would push it out to the devices for Rover. If anyone could share your file (minus your enterprise information) that would be awesome. We're looking potentially to move everything to JAMF, but need to validate that this works. Thanks everyone!

adam_mahmud
New Contributor III
New Contributor III

Hi @reon, @iDobbins, @kyletoburen, @ejboyd, @dvasquez,

Just to followup on this thread, should Jamf Pro admins looking to deploy Epic Rover that stumble upon it:

  • Reach out to your internal Epic team, and have them access the "Haiku, Canto, and Rover Fundamentals Setup and Support Guide" documentation from Epic Sherlock.
  • This explains how they can generate the unique URL to provide you to use in AppConfig.

3b918cc80af84b23a9a96e473e81468d

<dict>
<key>EpicMobileConfigurationURL</key>
<string>epicrover://handheld/config/INSERT-UNIQUE-CUSTOMER-URL-HERE</string>
<key>mdmIdentifier</key>

<string>$UDID</string>
</dict>

@reon - Does this solve your initial question? Thanks in advance!

Adam
Jamf Healthcare

ericjboyd
Contributor

We’ve been successfully using this for over 4 years now.
We even have multiple apps set up with different managed app configs, so we can deploy tst, POC and trn to those specific devices that need it.

dvasquez
Valued Contributor

Hey, Adam, hey all,

That made it really easy. I was looking for the set .xml at the following URL to see if that information would be helpful:

Not sure if anyone has used this page but it was helpful in setting a ServerDomain app config setting for Cisco Jabber:

http://d2e3kgnhdeg083.cloudfront.net/

Rover was not there but it was simple to use your snippet and then export another to make sure we had it right.

Here is a little background on the URL I posted, good luck:

https://krypted.com/jamf/using-managed-app-config-jamf-pro/

Thanks,
Dom

user-InvyXbPlMZ
New Contributor

Hello Adam.mahmud and everyone, I'm Jay here and new to Jamf and having similar issue as others in pushing down EPIC Rover with environment preconfigured. Below is the the plist im trying, no errors when saving however when launch Rover it still shows no env. configured.
Already tried remove rover app and re-pushed.

6224fd164fb348acb1d06c95cd55be0b

kyletoburen
New Contributor II

66f5208edfb64ea0867e1ac897e61f15
We found our issue was that the Techs were choosing an external Visitor network to start the Prestage deploy. When Rover was done installing, they would launch it, without moving to an internal network. The Rover appconfig would not download until Rover was exited (swiped up) and the device was connected to the internal network. Then launching Rover would download the configs. If Rover was still in the background, when connecting to internal network, it would still show No Env error message.
Also, the Certs to connect to the server, where the encrypted path for Rover was, is the same Certs in our internal WiFi profile, maybe that had to be connected for the appconfig to load correctly, too.
We use only the Key and String in our AppConfig. The Epic "MobileConfigurationTool" is finicky and non-intuitive, but you can add multiple environments, then the user can tap on the environment banner at top and choose an environment from a drop down before logging in. Our Non-Prod appconfig includes all our environments to choose from.
It really sounds like a call to the Epic Tech Support to make sure all the ducks are in a bush.
bda59357d5544a4396559ea27ee328d6

could you share how you configured for Multiple environments? I have tried just putting Multiple Keys/Strings and it didnt seem to work. 

iDobbins
New Contributor II
I don't think you can do multiple environments within one Epic Rover configuration. What we did was add Epic Rover (mobile app) and provided different configurations within the AppConfig.

are you saying you did something like this? and did this enable you to use the drop down to switch between environments? I attempted something like this and it didn't work for me.

<dict>
<key>EpicMobileConfigurationURL</key>
<string>epicrover://handheld/config/INSERT-UNIQUE-CUSTOMER-URL-HERE</string>
<key>EpicMobileConfigurationURL</key>
<string>epicrover://handheld/config/INSERT-UNIQUE-CUSTOMER-URL-HERE</string>
<key>EpicMobileConfigurationURL</key>
<string>epicrover://handheld/config/INSERT-UNIQUE-CUSTOMER-URL-HERE</string>

</dict>

 

kyletoburen
New Contributor II

The multiple environments have to be configured in the Epic MobileConfigurationTool.exe program.  You can have multiple environments in the Config tool.  You can have only one entry in the Rover appconfig in Jamf.  When Rover starts, it reaches out to the one server that is in the appconfig to load the econfig file, that is why only one entry can be in there.  But, the Dropdown menu at the Rover login screen can load the environment you want before you log in.

 

We have only two Rover Apps deployed from Jamf.  One with only the Production environment for the general clinical deployments. And one with all the non-prod environments (we don’t want nurses messing around with choosing random environments).

 

Rover Multiple Environments2.png

Rover config drop down on Device.PNG

thank you! That was that missing piece I needed. I have now got my hands on the tool from our Epic analyst and created new files to use.

dvasquez
Valued Contributor

Good information here. Awesome to read it. 

jriker
New Contributor

Anyone know if there is a way to disable the manual server/path details under Settings > Haiku for example?  Have some cute users who are trying to override their approved environments and go places they shouldn't or shouldn't with the devices they were given.