Customize the download URL for EAA Client

An Enterprise Application Access Client (EAA) administrator can customize the download URL for the EAA Client in the user portal to enable validation, and also control the release of the EAA software version. If the administrator does not specify any URL it will default to the Akamai download location.

An Enterprise Application Access Client (EAA) administrator might want to control the version of the EAA software that’s distributed to the end users, or they might want to test the new version before rolling it into their production environment. You can download the EAA software package on a separate web server and use a customizable download URL location to point to the web server. The EAA IT administrator can provide this URL to the organization. Employees will download the version of the EAA software that has been tested, qualified by the EAA IT administrator, rather than the latest version of EAA software available on the default Akamai download location.

This involves these steps:
  1. Download the EAA Client binaries and upload to your web server.
  2. Update EAA management portal with the custom download URL.

Download the EAA Client binaries and upload to your web server

  1. Download the latest version of the EAA Client installation binaries.
    https://eaaclientdownloads.akamai-access.com/eaaclientdistro/EAAClient-<version_number>-osx-installer.app.zip
    https://eaaclientdownloads.akamai-access.com/eaaclientdistro/EAAClient-<version_number>-osx-installer.dmg
    https://eaaclientdownloads.akamai-access.com/eaaclientdistro/EAAClient-<version_number>-x64-windows-installer.exe
    https://eaaclientdownloads.akamai-access.com/eaaclientdistro/EAAClient-<version_number>-x86-windows-installer.exe
    Note: <version_number> is a string representing the version of the file. It is composed of Major, Minor, Patch, and Release_Code_identifier elements.

    If the executable is, for example, EAAClient-1.3.0.c8e634ee-windows-installer.exe, the version number is 1.3.0.c8e634ee.

    The corresponding values are:
    • Major = 1
    • Minor = 3
    • Patch = 0
    • Release_Code_identifier = c8e634ee

    <version_number> is composed of Major.Minor.Patch.Release_Code_identifier.

    Everytime there is a new patch release, the Patch, Release_Code_identifier will change.

    Everytime there is a new minor release, the Minor, Patch, and Release_Code_identifier will change.

    Everytime there is a new major release, the Major, Minor, Patch, and Release_Code_identifier will change.

    So for this example, the downloaded files will be:

    https://eaaclientdownloads.akamai-access.com/eaaclientdistro/EAAClient-3.0.c8e634ee-osx-installer.app.zip
    https://eaaclientdownloads.akamai-access.com/eaaclientdistro/EAAClient-3.0.c8e634ee-osx-installer.dmg
    https://eaaclientdownloads.akamai-access.com/eaaclientdistro/EAAClient-3.0.c8e634ee-x64-windows-installer.exe
    https://eaaclientdownloads.akamai-access.com/eaaclientdistro/EAAClient-3.0.c8e634ee-x86-windows-installer.exe
  2. Create a folder on your local web server. For example, create a eaaclient_distribution folder
    https://eaaclientdownloads.yourcompany.com/eaaclient_distribution/
  3. Upload the EAA Client installation packages to the folder.
  4. Create a symbolic link to point to the latest EAA Client packages to EAAClient-i386.exe, EAAClient-x64.exe, and EAAClient.dmg, using a ln command:
    ln -s EAAClient-<version_number>-x86-windows-installer.exe EAAClient-i386.exe
    ln -s EAAClient-<version_number>-x64-windows-installer.exe EAAClient-x64.exe 
    ln -s EAAClient-<version_number>-osx-installer.dmg EAAClient.dmg

    For future releases, upload the new release packages to the same folder. Update the symbolic links to EAAClient-i386.exe, EAAClient-x64.exe, and EAAClient.dmg, when you want to distribute to users of your organization.

Example

For this example, it is:
ln -s EAAClient-1.3.0.c8e634ee-x86-windows-installer.exe EAAClient-i386.exe
ln -s EAAClient-1.3.0.c8e634ee-x64-windows-installer.exe EAAClient-x64.exe 
ln -s EAAClient-1.3.0.c8e634ee-osx-installer.dmg EAAClient.dmg

Update EAA management portal with custom download URL

Update the EAA Management portal with the custom download URL for your organization.

  1. Log in to the Enterprise Application Access Management Portal.
  2. From the top menu bar, click Identity > Identity Providers.
  3. Locate the identity provider that you want to configure and click Settings > CUSTOMIZATION.
  4. In the EAA Client download URL field, enter the directory URL where the files are located. For this example, https://eaaclientdownloads.yourcompany.com/eaaclient_distribution/
  5. Click Save and go to MultiFactor and Advanced Settings to make and save any other changes.
  6. Click Save and go to Deployment.

Next steps

Deploy the identity provider