AppConfig for Epic Rover (Request)

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

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.

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

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

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

I will see if I am able to do that.

Dominic

@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

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

@dlbrabb thanks!! will try that out!

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

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

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.

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.

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.

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!

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.

<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

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.

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

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.

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.

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

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>

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).

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.

Good information here. Awesome to read it.