Skip to main content
Skip table of contents

Quick start for vendors

Target audience: Vendors.

This guide provides you with information on:

  • how to create a SAFEQ Cloud tenant for your customer.
  • how to set up YSoft OMNI Bridge for your customer. This is only needed in the Edge printing scenario.

Creating a new tenant (customer)

  1. Log in to SAFEQ Cloud web UI using your vendor account.
  2. Click Create new and select Account.
  3. Fill in the following information:
    • Name – Set a name for the new customer.
    • Domains – The format is <customer>.<region>.ysoft.cloud

      • customer – Replace with the subdomain of the customer account in SAFEQ Cloud.
      • region – Data region. This must match with the region where your vendor account was created.
    • Application name – This name will be displayed when you hover over the tab with SAFEQ Cloud Web UI in your browser.
    • Default language – Select a language from the menu.
    • Default paper size – Select paper size from the menu.
    • OEM Logo – Upload a file with the customer's logo.
  4. Click Save.
  5. In the newly created tenant, go to Users and Access > Users.
  6. Click the edit icon next to the Admin account.
  7. Fill in the email address and the password for the Customer admin account. Click Save.
  8. If SAFEQ Cloud is hosted by you as the vendor or by the customer as on-premise solution, enter the license key that you have obtained for the customer in the License section of SAFEQ Cloud Web UI.
  9. Inform the Customer admin of the password and the address of the Web UI. If you have agreed with the customer to do the configuration for them, log out from your vendor account, log in with the Customer admin account, and continue to Quick start for admins.

Setting up OMNI Bridge

This step is necessary only in the edge printing scenario.

In the edge printing scenario, perform the following steps to set up an OMNI Bridge for your customer:

Preparing your YSoft OMNI Bridge

Requirements

YSoft Partner Portal account

You will need a Partner Portal account to authorize your YSoft OMNI Bridge during the setup process. If you don't have an account, you can obtain it in the following ways:

  1. If someone in your organization already has access to Partner Portal and has permission to create accounts, ask this person to create an account for you.
  2. Ask the YSoft Regional Sales Manager (RSM) responsible for your organization to create an account for you.
  3. Request access from YSoft Partner Portal team – send the request to partner.portal@ysoft.com.
The YSoft OMNI Bridge address has to be reserved.

You can do the following:

  • Reserve an IP address for the YSoft OMNI Bridge MAC address.

    After your OMNI Bridge receives an IP address from DHCP, reserve this IP address in your DHCP server/router for the MAC2 address of your OMNI Bridge. You can find the MAC2 address on the sticker at the back of the OMNI Bridge and also on its packaging box.


  • Assign a domain name for YSoft OMNI Bridge in the local DNS.
  • Configure the network manually on the device (YSoft OMNI Bridge).

    During the initial setup, the IP address of the OMNI Bridge is set to DHCP. If you want to change the IP address to static, you must run the initial setup again until the device verification code is displayed. Changing the IP address during the initial setup of the OMNI Bridge may cause problems with the device. The IP address should be changed after the initial setup is completed.

For information on how to configure the network manually on the device, see OMNI Bridge operation manual section Network.

NTP server must be available for the YSoft OMNI Bridge device.
  • If you have your own NTP server or have a specific NTP server already allowed in your firewall, allow traffic from YSoft OMNI Bridge to your NTP server. Make sure your NTP server is properly specified in your local DHCP server.
  • If the NTP address is not obtained via DHCP, YSoft OMNI Bridge defaults to Google NTP servers. Create a firewall rule to allow UDP traffic on port 123 to these servers: time1.google.com, time2.google.com, time3.google.com, and time4.google.com.
  • Change the NTP server manually on the device (YSoft OMNI Bridge).

To configure the NTP server manually on the device, do the following:

  1. Press 0 to enter the service menu.
  2. Enter PIN and press ▶.
  3. Select Time settings and press 0.
  4. Select Set NTP servers and press 0.
  5. Select Add new NTP server and press 0.
  6. Enter your NTP server and press ▶.
  7. Press ▶ to save your changes.
Network connectivity
IoT Hub

The following connectivity to IoT Hub is required:

Firewall rules

The following external domains and their communication ports must be allowed in your network firewall for the edge devices to function correctly.

mcr.microsoft.com443Microsoft Container Registry
*.data.mcr.microsoft.com443Data endpoint providing content delivery
*.cdn.azcr.io443Deploy modules from the Marketplace to devices
global.azure-devices-provisioning.net443Device Provisioning Service access (optional)
*.azurecr.io443Personal and third-party container registries
*.blob.core.windows.net443Download Azure Container Registry image deltas from blob storage
*.azure-devices.net5671, 8883, 4431IoT Hub access
*.docker.io443Docker Hub access (optional)

*.ysoft.cloud


443Partner Portal
*.ysoft.cloud443SAFEQ Cloud Primary
*.google.comUDP 123NTP server (time{1-12}.google.com) or any chosen NTP server

Security

Physical security

We recommend you to keep your OMNI Bridge in a physically secure area to prevent unauthorized access or theft. The OMNI Bridge has strong overall security, but its internal storage which contains print data and meta data (including user information) is not encrypted on HW level.

Changing the manager password

If you wish to change the manager password for your OMNI Bridge, see OMNI Bridge operation manual section Change manager password. We strongly recommend changing the password only after the enrollment of the device in your SAFEQ Cloud is complete.

Setup

Plugging the device in

To set up YSoft OMNI Bridge, do the following:

  1. Unpack the YSoft OMNI Bridge device.

  2. Plug an Ethernet cable into network port 2 and note down its MAC address.



  3. Make sure you have reserved an IP address for the MAC address of your YSoft OMNI Bridge. For more information, see section Requirements above.

    Do not change the assigned IP address! If the address changes, the device must be reconfigured.

  4. Make sure your YSoft OMNI Bridge has access to an NTP server. For more information, see section Requirements above.
  5. Attach the power supply. YSoft OMNI Bridge will start to initialize. This process usually takes several minutes, but it can take a longer time for the device to download the necessary modules and configure itself.

    Do not turn the power during the initialization process off.

  6. When the OMNI Bridge is ready, it will show an eight-letter device verification code and its LED light will be orange.

    The code expires after 10 minutes and a new code is generated.

    If the device code is too small for you to read:

    1. On the Device status screen, press ▶ two times. 
    2. This will take you to the Module status screen. Press 0.
    3. You will see the device code displayed in bigger letters.

      When the OMNI Bridge is ready, it will show an eight-letter device verification code and its LED light will be orange.

      The code expires after 10 minutes and a new code is generated.

Adding the device in SAFEQ Cloud Web UI

  1. Log in to SAFEQ Cloud Web UI.
  2. Go to Infrastructure > Endpoints.
  3. Click Add edge device.
  4. Fill in the following:
    • Serial number – You can find it on the sticker at the back of the device.
    • Device code – The eight-letter device verification code which your OMNI Bridge displays after the initialization phase.
  5. In API access key, select the API key you wish to use for the registration of the device.

  6. Click OK.
  7. To authorize the device, a new tab with Partner Portal login will open in your browser. Enter your Partner Portal credentials.

  8. Grant the requested permissions by clicking Yes.

  9. You will see the newly added device in Endpoints. Select it and click Authorize selected.



    You can see the device details by clicking the link icon next to server. You can authorize the device from the details view as well.

  10. The device will continue downloading and installing modules. The process may take up to 10 minutes. When finished, the LED will turn blue.

    Startup of the necessary services can take more than 10 minutes, depending on which services were configured. The service state is not visible in the Web UI. You can only monitor it in server siteapp.log. Note that service startup also happens after each reboot or software update of the OMNI Bridge.

    The embedded terminals connected to your OMNI Bridge may be slower to respond during your first interaction (such as logging in at the MFD) as the components may still be loading.

Performing secondary gateway mapping

After all the modules are downloaded, perform the secondary gateway mapping as described in Secondary Gateway mapping.

Adding services to your OMNI Bridge

As a minimum, add the following services to your OMNI Bridge so that it can function as a gateway:

  • Converter
  • Storage
  • Documentoutput

For how to do that, see Services.


Optional services:

  • Add Api if you plan to use Gateway storage rather than Local storage or Cloud.
  • Add Authentication if you need the edge device to connect to Active Directory or Microsoft Entra ID directly. Otherwise, the cloud instance of the Authentication service will be used.
  • Add Terminalclient if you plan to use the legacy embedded terminals.
  • Add other services according to your needs.
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.