Citrix SSO for linux

Citrix User Help Center | https://help‑docs.citrix.com September 3, 2024

Contents

Citrix Secure Access client for Linux 2

Citrix SSO for linux

Citrix Secure Access client for Linux

August 29, 2024

Citrix Secure Access client for Linux is a VPN client soware managed by NetScaler Gateway that en‑

ables you to access corporate data and applications remotely.

Citrix End Point Analysis (EPA) client is a client soware managed by NetScaler Gateway. It checks the

endpoint criteria before granting access to corporate data through NetScaler Gateway. The Citrix EPA

client and Citrix Secure Access client are independent from each other.

You can install the Citrix EPA client only if your administrator has configured it. For administrator

specific instructions, see Citrix Secure Access client for Linux.

Important update:

We are updating our user interface and product documentation to the new NetScaler brand. You

might see Citrix and NetScaler references used interchangeably during this transition period.

Install Citrix Secure Access client and Citrix EPA client

You can install the Citrix Secure Access client and the Citrix EPA client using the following instruc‑

tions:

1. Open a web browser and entertheNetScalerGateway URL provided by your administrator. Aer

a few seconds, a download screen appears:

• Click the Download button to download the Citrix Secure Access client for Ubuntu 22.04.

• Click the Download for Ubuntu 18 button to download the Citrix Secure Access client for

Ubuntu 18.04 or Ubuntu 20.04.

The following screen appears for the Citrix Secure Access client download:

Citrix SSO for linux

The following screen appears for the Citrix EPA client download:

2. Once the download is complete, double‑click the file and install the Citrix Secure Access client

and Citrix EPA client.

The following screen appears when you double‑click the downloaded Citrix Secure Access

client:

Citrix SSO for linux

The following screen appears when you double‑click the downloaded Citrix EPA client:

If the Citrix secure Access client is already installed but not upgraded, you are prompted to upgrade

to the latest version. Click Yes to upgrade to the latest version as shown in the following screen:

This upgrade is not applicable to the Citrix EPA client.

Citrix SSO for linux

Notes:

• Ubuntu 20.04 or 22.04 users: If Citrix Secure Access client and Citrix EPA client are already

installed but not up to date, you must uninstall the current version of the clients before

upgrading to the latest version. This is because, unlike Ubuntu 18.04, you cannot replace

the current version of the clients with the latest version.

• On Ubuntu 20.x, if you download the Citrix Secure Access client from a Firefox browser and

then open it using the Open With option, then the installation might fail. This is because

Firefox downloads the client at a temporary location and the Citrix Secure Access client

installation fails from this location.

As a workaround, we recommend that you select the Save File option. This option down‑

loads the Citrix Secure Access client in the Downloads folder. You can then double‑click the

downloaded file and install the Citrix Secure Access client.

Use Citrix Secure Access client for Linux

Enter the NetScaler Gateway URL on your browser to authenticate with the Citrix Secure Access client.

Once the authentication is successful, the browser prompts you to launch the Citrix Secure Access

client.

• Select the Citrix Secure Access client icon on the taskbar and click Settings.

• The Connections tab displays details such as connection status, user information, tunneled

connections, and data usage.

Citrix SSO for linux

• The Configuration tab displays the NetScaler Gatewayinformation, an option to upload a client

certificate, and logging options.

Citrix SSO for linux

– Certificates: Navigate to this section to configure a client certificate. This step is required

only if your administrator has provided a client certificate to you to authenticate with

NetScaler Gateway.

Citrix SSO for linux

– Logging: Navigate to this section to capture the debug logs. Capturing debug logs is a

critical part of troubleshooting or reporting issues to Citrix Support.

Citrix SSO for linux

Alternatively, you can launch Citrix Secure Access client and click Logon. If you are a first time user,

you are prompted to provide either the NetScaler Gateway URL or your workspace URL.

Send logs

The log files that you send to your administrator are of the format nsgcepa.txt, nsepa.txt, and

nssslvpn.txt. These files are in the ~/.citrix/ directory. They capture the following details:

• Info: Prints the basic and error logs.

• Debug: Prints all the logs. We recommend that you select this option to collect the logs and

share with your administrator.

• Verbose: Prints the verbose logs including tunnel messages and configuration information.

Citrix SSO for linux

marks appearing herein are property of Cloud Soware Group, Inc. and/or one or more of its subsidiaries, and may be

registered with the U.S. Patent and Trademark Oice and in other countries. All other marks are the property of their

respective owner(s).