Logging In with SAML

If SAML configurations are available, you can choose to log in with a configured SAML provider.

1. Open a supported browser and enter the Faspex hostname or IP address followed by /aspera/faspex in the browser URL. For example:

   http://faspex.asperasoft.com/aspera/faspex

   or

   http://198.51.100.24/aspera/faspex

   Note: For security reasons, Faspex versions 4.0.3 and later by default only allow login using the hostname that is configured in the faspex.yml configuration file (the hostname you designated during installation). If you try to log in to the application from an unlisted hostname or perform a GET request with an unlisted hostname, Faspex returns the error, "Invalid hostname". To access Faspex from an alternate hostname, follow the instructions in Configuring the Faspex Web Server.
2. Log in with your credentials.
   If SAML configurations are available, you can choose to log in with a configured SAML provider or with your Faspex user credentials.

   If your administrator configured Faspex to use a default SAML configuration, Faspex automatically redirects you to the SAML login page. Login with your SAML credentials or login locally by bypassing the redirect.

   If you need to login with your Faspex user credentials or if you need to log in using another SAML configuration, you can bypass the redirect by adding login?local=true to the end of the URL. For example: https://192.51.100.24/aspera/faspex/login?local=true.

3. If prompted, install IBM Aspera Connect.

   You must have the latest version of Connect installed to transfer packages using Faspex. Faspex prompts you to install the Connect Browser if you do not have it installed or if your version is not the latest. If you install Connect, refresh your browser to start using Connect.

   For more information, see Faspex and Connect.