XecureAccess Client Configuration Setup

This guide explains how to install and configure the XecureAccess client across multiple operating systems, including Windows, Ubuntu, RPM-based Linux distributions (Fedora, RHEL, CentOS), and Arch Linux. It provides administrators and users with a unified reference for deploying the client, connecting it with the PAM server, and ensuring secure access to protected applications.

The instructions cover platform-specific installation methods such as .deb and .rpm packages, script-based installations for Arch Linux, and standard installers for Windows. Each section walks through the required setup steps, PAM server configuration, and the procedures needed to verify proper installation or perform a clean removal when required.

RPM
Arch Linux
Ubuntu
Windows

Installation Steps

Step 1: Download the Installation File

Log in to the PAM Dashboard.
Navigate to Resources >> My Resources.
Locate the download icon and click to download the .zip file.
Save the file to your preferred location.

Step 2: Extract the Archive

Navigate to the download location.
Right-click on the .zip file and select Extract Here.

Alternatively, use terminal: unzip filename.zip

Step 3: Install the .rpm Package

Option A: Terminal Installation

Open Terminal
Navigate to the extracted file location: cd/path/to/extracted/files
Run the installation command: sudo dnf install filename.rpm

Privileged Access Management Admin Handbook: Terminal Installation

Enter your password when prompted
Wait for the installation to complete

Option B: GUI Installation

Open your file manager
Navigate to the location of the .deb file
Right-click on the .deb file
Select Open with AppCenter (or Software Install)

Privileged Access Management Admin Handbook: GUI Installation

Click Install and enter your password when prompted.

Step 4: Give Permission

Run this on terminal: sudo chmod -R 777 /opt/XecureAccess/

Privileged Access Management Admin Handbook: Give Permissions

Step 5: Configure XecureAccess

Launch the XecureAccess Application from your applications menu
You'll see a configuration form with the following fields:

PAM SERVER URL
Secret Key

Obtaining Your Secret Key:

Return to the PAM Dashboard
Click on your Personal Profile
Look for the Generate Secret Key option
Click to generate a new secret key
Copy the generated key

Complete the Configuration:

Paste the domain name in the Domain Name field
Paste the copied secret key in the Secret Key field
Click Submit

Step 6: Access Your Application

Once the configuration is submitted successfully, you can now access your web application through XecureAccess.

Uninstall Steps

Run these commands on the terminal:

sudo dnf remove filename
sudo rm -rf ~/.config/Xecureaccess
sudo rm -rf /opt/XecureAccess

Verification:

rpm -qa | grep -i xecure

You should see nothing.

Installation Steps

Step 1: Download the Installation File

Log in to the PAM Dashboard
Navigate to Resources >> My Resources
Locate the download icon and click to download the .zip file
Save the file to your preferred location

Step 2: Extract the Archive

Navigate to the download location
Right-click on the .zip file and select Extract Here

Alternatively, use terminal: unzip filename.zip

Step 3: Run the following on terminal (where you extracted the zip file)

tar -xf XecureAccess-2.0.0.tar
cd XecureAccess-2.0.0/

Step 4: Install the .arch Package

Option A: Terminal Installation

Open Terminal
Navigate to the extracted file location: cd /path/to/extracted/files
Run the installation commands:

chmod +x install.sh
sudo ./install.sh

Enter your password when prompted
Wait for the installation to complete

Step 5: Give Permission

Run this on terminal: sudo chmod -R 777 /opt/XecureAccess/

Step 6: Configure XecureAccess

Launch the XecureAccess Application from your applications menu
You'll see a configuration form with the following fields:

PAM SERVER URL
Secret Key

Obtaining Your Secret Key:

Return to the PAM Dashboard
Click on your Personal Profile
Look for the Generate Secret Key option
Click to generate a new secret key
Copy the generated key

Complete the Configuration:

Paste the domain name in the Domain Name field
Paste the copied secret key in the Secret Key field
Click Submit

Step 7: Access Your Application

Once the configuration is submitted successfully, you can now access your web application through XecureAccess.

Uninstallation Step

Go to the folder where you extracted the zip file and run this command:

sudo ./uninstaller.arch.sh

Installation Steps

Step 1: Download the Installation File

Log in to the PAM Dashboard.
Navigate to Resources >> My Resources.
Locate the download icon and click to download the .zip file.
Save the file to your preferred location.

Step 2: Extract the Archive

Navigate to the download location.
Right-click on the .zip file and select Extract Here.

Alternatively, use terminal: unzip filename.zip

Step 3: Install the .deb Package

Option A: Terminal Installation

Open Terminal.
Navigate to the extracted file location: cd /path/to/extracted/files
Run the installation command: sudo dpkg -i filename.deb

Privileged Access Management Admin Handbook: install .deb Package

Enter your password when prompted.
Wait for the installation to complete.

Option B: GUI Installation

Open your file manager.
Navigate to the location of the .deb file.
Right-click on the .deb file.
Select Open with AppCenter (or Software Install).

Privileged Access Management Admin Handbook: Installation .deb File

Click Install and enter your password when prompted.

Step 4: Configure XecureAccess

Launch the XecureAccess Application from your applications menu.
You'll see a configuration form with the following fields:

PAM SERVER URL
Secret Key

Obtaining Your Secret Key:

Return to the PAM Dashboard.
Click on your Personal Profile.
Look for the Generate Secret Key option.
Click to generate a new secret key.
Copy the generated key.

Complete the Configuration:

Paste the domain name in the Domain Name field.
Paste the copied secret key in the Secret Key field.
Click Submit.

Step 5: Access Your Application

Once the configuration is submitted successfully, you can now access your web application through XecureAccess.

Uninstall Steps

Run these commands on the terminal:

sudo apt purge filename
sudo rm -rf ~/.config/Xecureaccess
sudo rm -rf /opt/XecureAccess

Verification:

dpkg -l | grep -i xecure

Installation Steps

For Windows:

Download this agent application.

Step 2: Extract the Archive

Navigate to the download location.
Right-click on the .zip file and select Extract Here.

Step 3: Run the Installer

Open the extracted folder.
Locate XecureAccess-Desktop.exe.
Right-click the file and select Run as administrator.
The installer will launch and display the Welcome screen.
Select the appropriate installation option (e.g., current user or all users).
Click Next to proceed with the installation.

Privileged Access Management Admin Handbook: XecureAccess Installation

Now Choose the Destination Location for the agent installation. If you prefer to continue with the Default Location, simply click the Install Button.

Privileged Access Management Admin Handbook: Destination Folder

Finally, the agent has been installed on your computer by Setup. Now just click the Finish Button.

Privileged Access Management Admin Handbook: Complete XecureAccess Setup

Go to the PAM dashboard, navigate to the resource you added, and try to access the resource.

Note:

While accessing the resource, if the screen shown below appears, complete the XecureAccess configuration from this section.

Open XecureAccess-Desktop app

Privileged Access Management Admin Handbook: Open XecureAccess Desktop App

The configuration screen has the following fields:

PAM Server URL — Enter your organization's PAM server URL.
Secret Key — Obtain from PAM Dashboard: go to Personal Profile >> Web app agent secret key, click Generate Key, then copy and paste it here.

Privileged Access Management Admin Handbook: Web App Agent Secret Key

After filling in the details, this page will show:

Privileged Access Management Admin Handbook: Device Registration Complete

Try accessing the web application resource again. You should now be able to access it successfully.

Contents

XecureAccess Client Configuration Setup

Installation Steps

Step 1: Download the Installation File

Step 2: Extract the Archive

Step 3: Install the .rpm Package

Step 4: Give Permission

Step 5: Configure XecureAccess

Step 6: Access Your Application

Uninstall Steps

Installation Steps

Step 1: Download the Installation File

Step 2: Extract the Archive

Step 3: Run the following on terminal (where you extracted the zip file)

Step 4: Install the .arch Package

Step 5: Give Permission

Step 6: Configure XecureAccess

Step 7: Access Your Application

Uninstallation Step

Installation Steps

Step 1: Download the Installation File

Step 2: Extract the Archive

Step 3: Install the .deb Package

Step 4: Configure XecureAccess

Step 5: Access Your Application

Uninstall Steps

Installation Steps

For Windows:

Step 2: Extract the Archive

Step 3: Run the Installer

Note: