Unifyia User Client - macOS

The Unifyia User Client v2.2.2 is an application running as a macOS service. It supports the Unifyia platform v2.0.3. It facilitates interactions with various types of card readers to execute requested operations on the connected identity devices. Serving as an intermediary service, it connects the Unifyia platform with the associated card readers, enabling the execution of card-related actions. Unifyia User Client supports interaction with only the PCSC Card Readers - Contact and Contactless.

Software Distribution

The installation files for macOS are packaged as Unifyia_User_Client_ 2.2.2.pkg. You will find the application in the Device Client > Mac folder in the software distribution packages shared with you.

Supported Browsers

  • Google Chrome
  • Safari Browser

Supported macOS Versions

  • MAC Apple M2 14 version
  • MAC Intel 13 version

Supported Functions

To install, read, and write PCSC - Contact and Contactless Cards

Supported Devices

The Unifyia Client is compatible with all PCSC Card Readers - Contact and Contactless.

Prerequisites

The following are the prerequisites for the macOS Unifyia Client.

  • Minimum RAM: 2GB
  • Supported macOS Configurations:
    • Intel processors
    • Apple M1 & M2 silicon

Install Client

NOTE
If you have already installed the client service, ensure to uninstall the old versions before installing the latest version.

This section will walk you through the process of installing the Client service meant for users on macOS. On your local machine, download and extract the Client application that was shared with you. Follow the installation instructions for your operating system.

  1. Download the Unifyia_User_Client_ 2.2.2.pkg installer from the Device Client folder shared with you to your local machine, from where you are accessing the Unifyia platform.
  2. Double-click on the .pkg file and follow the default setup process on the installer wizard.
  3. You cannot choose your installation directory. So, the default installation home path is /opt/Unifyia where you can find bin, lib, log, and script folders.
  4. Check the box to confirm that you have read and agreed to the terms and conditions.
  5. Select Install.
  6. The setup wizard installs the Client.
  7. Select Finishonce the installation is completed.
  8. You will be prompted for your password to install the software. Enter your password and click Install Software.
  9. A security prompt will appear twice, asking for your password. Ensure to accept the changes to the System Certificate Trust settings by providing your password. This ensures that the certificate is imported to the Keychain Access and that the client and the platform connect over a secure network. Select Update Settings.
  10. After a successful installation, you will see a message indicating that the installation is complete. The client service is up and running.
  11. The installation will create the folder Unifyia. You can also find the folder manually by navigating to the path: Finder > Go > Computer > Macintosh HD > Opt >
    12. NOTE
    If the Opt folder is not visible or cannot be found, try using the shortcut keys command+shift+. to reveal hidden folders.
  12. When you reboot the system or shut down the system, the service will not start automatically.
  13. If the Unifyia platform is unable to detect the client service, then stop and start the service. To start or stop the service manually, open a terminal, navigate to the path opt/Unifyia/script, and run the below commands.

You have successfully installed the Client service, which can now be found in the list of local services on your machine.

Uninstall Client

Follow the below steps to uninstall the Client application on a MAC machine.

  1. Open a terminal.
  2. Navigate to the path /opt/Unifyia/script and run the below command.
    3.  // To start the service
sudo ./startStop.sh start

Troubleshooting

Pre and post-installation issues

The log files for the pre and post-installation issues are found in the temp files. For a resolution, send the log file to the support team.

Service is unavailable or unresponsive

You need to determine whether the service is active if the Client service is not responding and appears to be down. Take the actions listed below.

  • Press Command Key + Space, and type Activity Monitor.
  • Search for UnifyiaService. Select Quit Process to stop the service if it is already running and try restarting. Open the command line interface. Navigate to the path /opt/Unifyia/script and type the below command.
    •  // To start the service  
sudo ./startStop.sh start

If the issue persists, navigate to the tmp folder on your local machine and share the unifyia_postinstall log file with the Unifyia support team.

Card Reader Issues

If a card is inserted into one of the below card readers, the device client detects it. However, if you remove and then reinsert the card, the device client does not recognize it.

  • Hamster Pro Duo SC PIV - Model: XU20SCA
  • ACR39U-UF Model: ACR39

Disconnect the card reader from the system and reconnect it. This will reset the connection and the card will be detected.


Back Next
On this page