TechIDAgent.macOS Setup

This is a subsection of the fourth step from the Install Instructions for TechIDManager.


4.4 TechIDAgent.macOS Install – Unique Accounts

These instructions explain how to install TechIDAgent, the TechIDManager PAM service, onto a macOS workstation.

This configuration grants every technician in your organization a unique account on a given workstation.

We will perform this configuration and installation process using the TechIDAgent.macOS Command-Line Interface (CLI). These written steps are intended to be followed from the workstation itself.

Should you need assistance installing TechIDAgent, don’t hesitate to contact us for help, or book installation assistance.


What to do
Expected Result
Download TechIDAgent
4.4.1

Download the latest TechIDAgent.macOS from https://techidmanager.com/releases.

techidagent.mac-X.Y.tgz downloaded to the workstation.


4.4.2

Locate techidagent.mac-X.Y.tgz and extract all files from the archive.

A directory containing the techidagent.mac-X.Y.pkg package, and various helper scripts.

Install TechIDAgent
4.4.3

Open a Terminal window within the newly created directory containing the package and scripts.

Run the following command to gain execution permissions on the install script:

chmod a+x install-techidagent.mac.sh

Then, run the install script with the following command:

sudo ./install-techidagent.mac.sh

Enter your administrator password when prompted. It will prompt twice – once before running as super user and once more to access the machine’s SecureToken when creating the service user.

A service account is created to manage accounts and credentials.

The TechIDAgent.macOS service is loaded and started.

Configure the Installation
4.4.4

Move into the directory containing the TechIDAgent.macOS CLI with:

cd /Library/Application\ Support/TechIDAgent/TechIDAgent.app/Contents/MacOS

Within this directory, link the installation to your organization with:

sudo ./techidagent.mac clientguid [ClientGuid]

(Replace [ClientGuid] with your organization’s ClientGuid)

You may further configure this installation here, as such:

sudo ./techidagent.mac {command} {arguments...}

Changes to TechIDAgent should apply within a few minutes.

Once bound to your ClientGuid, it will appear in TechIDPortal, on the Agents page.


Any questions? Need help? Contact support@ruffiansoftware.com or book a White Glove Install.