Connecting the Agent to a CTERA Portal
  • 11 Jul 2023
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Connecting the Agent to a CTERA Portal

  • Dark
    Light
  • PDF

Article Summary

Users logging on to a PC running a CTERA Agent, with CAC, Common Access Card, are automatically and transparently authenticated to the CTERA Portal. Single sign-on (SSO) to the CTERA Portal must be defined in Microsoft Active Directory, using the Kerberos protocol. When validating the CTERA Portal certificate, certificate revocation checking is performed using CAPI/OSB revocation checks.

To connect to a CTERA Portal:

  1. Click the CTERA Agent tray icon, image.png, in the taskbar.
    The Welcome to CTERA Agent window is displayed.
    image.png
    Note

    If the CTERA Agent tray icon is hidden, click the up-arrow in the notification area of the taskbar to display hidden icons.

  2. Enter the CTERA Portal's DNS name or IP address.
    Alternatively, if you want to configure CTERA Agent to connect to the CTERA Portal via a proxy:
    Note

    If the CTERA Portal does not have a valid certificate installed, a warning is displayed to the end user when logging the agent into the portal, offering the option to proceed anyway.
    image.png

  3. Click Continue.
    The sign-in window is displayed unless single sign-on (SSO) has been defined configured and you then use SSO to access the CTERA Agent.
    image.png
  4. Enter your username and password for accessing the CTERA Portal and click Sign in.
    A message that the login was successful is displayed, the CTERA Agent tray icon changes to image.png and the CTERA Agent window is displayed.
    image.png

Setting Up Connection Via a Web Proxy

CTERA Agent supports HTTPS proxies that support the CONNECT method. If you want CTERA Agent to connect to the CTERA Portal via a proxy, you can configure the proxy before you sign into CTERA Agent.

The following proxy authentication schemes are supported:

  • Basic
  • NTLM
  • NTLMv2
Note

Using a proxy auto-config (PAC) file is not supported.

To set up a connection to the CTERA Portal via a web proxy:

  1. In the Welcome to CTERA Agent window, click Advanced.
    image.png

  2. Select an option from the Proxy Settings dropdown list.
    Use HTTP Proxy – CTERA Agent uses the proxy you configure to connect to the CTERA Portal server:
    Address – The address of the proxy server.
    Port – The proxy server port number.
    Proxy server requires a password – The proxy server requires authentication via a username and password.

    • Username – The username for authenticating to the proxy server.
    • Password – The password.

    Auto – CTERA Agent attempts to automatically determine your proxy settings according to your Windows settings. Automatic proxy detection is based on the system-wide proxy settings, which are not the same as the browser settings.

    • In 64-bit Windows versions prior to Windows 8, configure the system proxy settings using this command: %WINDIR%\SysWOW64\netsh winhttp set proxy <settings>
    • In all other Windows versions, configure the system proxy settings using the following command: netsh winhttp set proxy <settings>
  3. Click Save.

Note

The proxy settings set in the Advanced window are saved as the default proxy settings. If you connect not using these proxy settings and then use the proxy settings again, these default settings are displayed.


Was this article helpful?