Use EAA Client

Use the EAA Client to check status, network type, run diagnostics, save and send logs for troubleshooting, synchronize it with EAA Management Portal, update to the latest version of the software, and perform a factory reset.

The EAA Client has a contextual menu which allows the user to perform different tasks. You can launch the configuration wizard to configure the EAA Client. You can also check network type, and status, or check diagnostics, saving and sending logs, and synchronize, or reset the EAA Client software.

EAA Client contextual menu

EAA Client has a menu which changes based on the context of the user's operation. When you right-click the EAA Client icon on your Windows desktop toolbar or the Mac menu bar, you see dynamic contextual menu to indicate the tasks that you can perform based on the contextual state.

Before you configure downloaded EAA Client with your organization's identity provider, the contextual menu shows Configure option in the menu. After configuration, Configure option changes to Login. After you log in to EAA Client application, the contextual menu shows Logout option. The functions of the EAA Client menu options are described in the table below.

Menu optionMenu function
EAA Client icon > Open EAA ClientOpens the EAA Client. You can run diagnostics, check network type, or status, save and send logs, or, synchronize, reset the client, and get alerts about any issues with the EAA Client.
EAA Client icon > ConfigureUse this to configure the EAA Client with the configuration wizard after installation. This loads all of the configuration information from the EAA Management Portal to the EAA Client software on the computer. Alternatively, if you have the EAA Client Settings window already open, you can also configure using the configure in status label.
EAA Client icon > LoginLog in to your EAA Client application. Alternatively, if you have the EAA Client Settings window already open, you can also log in using re-authenticate in status label.
EAA Client icon > Logout Log out of your EAA Client application. It terminates the session. If you also logged out of the IdP login portal, then the user is not longer authenticated with the application. This means the user must enter their login portal credentials, to login to EAA Client application. Logging out from only the EAA Client does not log you out of the IdP login portal.
EAA Client icon > QuitRemoves the EAA Client icon from the toolbar or menu bar and disables access to internal applications. To log in again, you need to launch the EAA Client application.

Use configuration wizard to configure the EAA Client

Configure EAA Client with the configuration wizard. When you install the EAA Client for the first time, it does not pull the necessary information from Enterprise Application Access. You need to configure your EAA Client.

  1. Right-click the EAA Client icon on the Windows desktop toolbar or the Mac menu bar.

  2. Click EAA Client icon > Configure.
    The configuration wizard opens.

  3. In the configuration wizard, enter your organization identity provider (IdP) hostname.

  4. Click Start.
    Identity provider's login portal page opens.

  5. Login to the IdP portal with your SSO credentials. For example, https://yourIdP.com.
    The EAA Client download icon appears in the top right corner.

  6. Click Configure.
    After configuration finishes, the authenticated message with the date and timestamp appears.

  7. Click OK.
    The EAA Client icon changes from not authenticated to connected state. This indicates that the EAA Client is connected to the EAA Management Portal, and all of the configuration information is sent from the EAA Management Portal to the EAA Client on the user's computer.

EAA Client icon states

Application stateIcon color and descriptionEAA Client icon
connected or authenticatedGreen check markEaa client on iconEaa client on icon
not connected, not authenticated, or not configuredRed exclamation markEaa client off iconEaa client off icon
trying to connect or trying to disconnect (transient state - while logging in or logging out)Three orange dotsEaa client off iconEaa client off icon

EAA Client Network types

Open the EAA Client to see the different types of network indicated by the EAA Client, based on the user's location.

Network typeIndication explanation
On-premisesUser is inside a trusted network, like a corporate IT network. This network type is possible when you enable trusted network in the identity provider (IdP), and user satisfies the trusted network policy. The user can override the trusted network settings on their computer inside EAA Client.
On-premises (using Proxy)User is inside a trusted network, like a corporate IT network and a proxy server is used. This network type is possible when you enable trusted network in the IdP, user satisfies the trusted network policy, and user has authenticated with the proxy server (with the correct proxy credentials). The user can override the trusted network settings on their computer inside EAA Client.
PublicUser is outside a trusted network, in a public network (like a cafe, or a hotel network). This network type is possible when you enable trusted network in the IdP, and the user does not satisfy the trusted network policy. Also, you can see this network type indication, when the trusted network feature is disabled in the IdP.
Public (using Proxy)When you enable a proxy server and authentication is done with the correct proxy credentials, EAA Client sends the traffic though the proxy server to reach the application server.
Captive portalUser is in a public network (like a cafe, or a hotel network) and connected to the captive portal page, but has not authenticated with the credentials. User is not connected to the Internet.
Not ConnectedUser has no internet connection.

EAA Client Status

The status field in the EAA Client shows different states to give you some key tool tips as described in the below table.

StatusDescription
Not ConfiguredWhen you open EAA Client just after you install it, it is in this state. Click Configure, to launch configuration wizard and configure the client.
AuthenticatedThe client is connected and successfully authenticated.
Not authenticatedAfter you log out of the client, it shows this status. Click Re-authenticate to log in to IdP portal and authenticate again.
Logging InYou are logging into the client.
Logging OutYou are logging out of the client.
ResettingYou are resetting the client.

Log in through the EAA Client Settings window

You can use the EAA Client settings window to log in to the application. If you have the EAA Client Settings window open, and the EAA Client icon is in Not authenticated status after you log out, you can log back into the EAA Client.

  1. In the EAA Client Settings window hover over Not authenticated status and click Re-authenticate. The status changes to Logging In and then to Not authenticated.
    The IdP login portal is launched. If the credentials exist in the cookies, the user is authenticated.
    The EAA Client status changes to Authenticated, and the EAA Client icon changes to authenticated state.

Configure EAA Client through the EAA Client settings window

Launch the configuration wizard from inside the EAA Client settings window and configure the client.

Prerequisite:
Open EAA Client from EAA Client icon > Open EAA Client.

If you have the EAA Client settings window open, and the EAA Client icon is in Not configured status after you install it, you can follow this procedure to configure the EAA Client. This pulls the configuration information from EAA Management Portal.

  1. Inside the EAA Client settings window, hover over the Not configured status and click Configure.
    The configuration wizard opens.

  2. In the configuration wizard, enter your organization identity provider (IdP) hostname.

  3. Click Start.
    Identity provider's login portal page opens.

  4. Login to the IdP portal with your SSO credentials. For example, https://yourIdP.com.
    The EAA Client download icon appears in the top right corner.

  5. Click Configure.
    After configuration finishes, the authenticated message with the date and timestamp appears.

  6. Click OK.
    The EAA Client icon changes from not authenticated to connected state. This indicates that the EAA Client is connected to the EAA Management Portal, and all of the configuration information is sent from the EAA Management Portal to the EAA Client on the user's computer.