Overview

This article walks you through installing the Umango embedded app onto an HP Multi-Function Device (MFD). HP devices expose their OXPd web services over HTTPS using a self-signed certificate, which most browsers (and operating systems) reject by default. This creates a hurdle that may require some manual intervention. Before any install tool can talk to the device, you must first teach your browser to trust that certificate.

The recommended browser for the certificate-exception flow is Mozilla Firefox, which provides a straightforward, per-site exception process.

Before you begin

What you will need

• Firefox browser — required for the certificate-exception workaround.
• Umango account access — you must be logged in to Umango in Firefox.
• HP device details:
  • Device IP address (e.g. 192.168.86.193)
  • Device serial number (printed on the device or visible in the EWS)
  • HP device admin username (typically admin)
  • HP device admin password
• Network access — your workstation must be able to reach the device on TCP port 7627 (the HP OXPd web-services port).
• (For Methods 1 or 2) The Umango browser extension installed and pinned to the Firefox toolbar.
• (For Method 3 only) The HP OXPd Button Manager utility — available from Umango Support.

Step 1 — Create a certificate exception in Firefox

This step is required for installation methods 1 or 2 and must be repeated for each HP device you intend to install onto.

Open Firefox and navigate to the HP device's OXPd DeviceInfoService URL, replacing {DeviceIp} with your device's IP address:

https://{DeviceIp}:7627/hp/device/webservices/OXPd/DeviceInfoService

For example, for a device at 192.168.86.193:

https://192.168.86.193:7627/hp/device/webservices/OXPd/DeviceInfoService

Firefox will display the security warning "Be careful. Something doesn't look right.":

To create the certificate exception:

1. Click Advanced.
2. Click Accept the Risk and Continue (or Proceed to {IpAddress} (Risky), depending on Firefox version).

Firefox will now permanently remember the exception for this device. You should see a small XML/SOAP response page — that's normal and confirms the device is reachable.

Step 2 — Create the device entry in Umango

To use the preferred install method (Method 1), the device must first exist in the Umango Managed Devices list. In most cases this happens automatically if the device is on the same network as a running Umango instance, it will be auto-discovered within a few minutes.

If the device does not appear automatically, add it manually:

1. In Umango, navigate to Devices and click Force Discovery.
2. In the Device Discovery dialog, switch to the Manual Entry tab.
3. Complete the device information:
   • Device Brand — HP
   • IP Address — the device's IP
   • Serial Number — the HP serial number
   • Device Model Name — e.g. HP LaserJet MFP M430
4. Click Submit.

Method 1 — Install from the Managed Devices screen (recommended)

With the device showing in Managed Devices, this is the simplest and most reliable install path. Try it first.

1. Navigate to the Managed Devices screen in Umango.
2. Locate the row for the HP device you want to install onto.
3. Tick the checkbox at the left of that row to select the device.
4. Click the Install App button in the toolbar above the list.
5. If the admin credentials are not the factory default, enter the password using the Device Password button.

Method 2 — Install from the browser extension popup

If Method 1 fails, the Umango browser extension contains a hidden Device App Manager that performs the install with slightly different plumbing. With the Firefox certificate exception still in place and Umango logged in:

1. Click the Umango browser extension icon in the Firefox toolbar to open the popup.
2. In the popup, click the Umango logo (the small colored circle) five times in quick succession. This unlocks the Device App Manager.

The full Device App Manager UI will now appear. Complete the form:

When all fields are completed, click Install App. The extension will push the Umango button onto the device.

If this method also fails, proceed to Method 3.

Method 3 — Install via HP OXPd Button Manager (last resort)

If both Umango install paths fail, you can install using the standalone HP OXPd Button Manager utility, available from Umango Support. This tool talks to the device's OXPd interface directly and gives you finer control over the installed button (custom icon, alternative URI, region-specific Umango cloud).

Step-by-step

1. Launch OXPd Button Manager.
2. In the Connect to the Device section, enter:
   • Hostname or IP — the device's IP address (e.g. 192.168.86.193).
   • Admin Password — the HP device administrator password.
3. Click Retrieve Button Data to populate the existing buttons list. Any previously installed Umango button will appear here.
4. In the Edit Button Details section, enter the following:

   Field	Value
   Button ID (UUID)	Click Generate a New UUID for a new install, or keep the existing UUID when updating.
   Button Title (en-US)	Umango
   Button Description (en-US)	Umango connected to server https://{your-tenant}.{region}.umango.cloud
   Button URI (Web App URL)	https://{your-tenant}.{region}.umango.cloud/mfd/init/hp/{DeviceSerial}
   HTTP User Name / Password	Leave blank unless your deployment requires HTTP basic auth.
   Initial Request Query String	user=$AUTHUSER_USERNAME$&redirect=true

5. (Optional) Click Browse next to the icon preview to upload the Umango SVG icon supplied by Umango Support. SVG is preferred for crisp scaling on all panel sizes; PNG/BMP/JPG are also accepted via Advanced.
6. Click Add/Update Button to push the button to the device.

After installation — assigning jobs

Once the Umango button is installed on the device, you can assign workflows / jobs to it from Umango as normal. If the device wasn't already in Managed Devices when you installed (for example you used Method 2 or Method 3 against a device Umango didn't yet know about), follow the Step 2 instructions to add it manually so it can be managed.

Troubleshooting