URL Handler

The URL handler for the Access Interface follows a specific format that allows you to circumvent using memorable names or identifiers for your URLs. These machine-generated URLs are found in daily interfaces such as dashboards, ticking and monitoring systems, and logs.

Important: Before installing the URL Handler, be sure you have performed a time sync.

Installation

Use the following command for the installation

scaleft://[<sft-username>@]<instance>/t/<team>/a/<target>/<access-method>?via=[<username>@]<bastion>

Parameters

Note: All information within [brackets] is optional.

• For <instance> use http://appAn abbreviation of application. Essentially, it is a web-based site used to perform any number of specific tasks, and requires authentication from end users by signing in..scaleft.com|app.scaleft.com.
• For <access-method> use ssh or rdp.
• The via section of the URL is optional and is only needed if there is no established preconfigured bastion configuration which is not required for most use cases. If there are multiple bastion configurations in the URL, multiple via parameters are required and must be in the correct order.
• For <target>, use any valid URL.

Examples

The following examples show sample installations for the URL handler.

• scaleft://app.scaleft.com/t/okta-demo-only/a/ubuntu-target/ssh
• scaleft://app.scaleft.com/t/okta-demo-only/a/ubuntu-target/ssh?via=ubuntu-bastion

Check for correct URL handling

The Advanced Server Access clientEssentially, a client is anything that talks to the Okta service. Within the traditional client-server model, Okta is the server. The client might be an agent, an Okta mobile app, or a browser plugin. logs clicks and the handling of the URL.

If you are on a Windows machine, the client logs are located in c:\users\<username>\appdata\local\scaleft\logs.

If you are using a Mac: the files are located in ~/Library/Logs/ScaleFT/sft/.