Setup Autify Connect

To use Autify Connect to run tests on your private environment, you will need to do the following:

1. Create a Scenario against your private application
2. Configure Autify Connect from the Workspace Settings page
3. Install Autify Connect Client to your system
4. Configure your Test Plan
5. Run the Test Plan

Let's look at each step in detail.

1. Create a Scenario against your private application

Create a scenario for the private application you wish to test. This can be done using Autify Recorder, just as you would to create a scenario for a public application.

2. Configure Autify Connect from the Workspace Settings page

Create an Access Point

1. Navigate to your Workspace Settings page and find the Autify Connect section
   

2. Click the "Add" button and input a name for the Access Point. An Access Point is an identifier that is associated with a unique key that will be used by your Autify Connect Client.
   

3. Click the "Create" button. An Access Point Key will be displayed. Please keep it in a secure place, as this will be required when you set up Autify Connect Client in a later step.

3. Install Autify Connect Client on your system

Download Autify Connect Client

Stand-alone binaries

Download Autify Connect Client for the platform you’ll be using, and follow the instruction provided for each OS.

Docker Image

We also have Docker image in the ECR Public Gallery on AWS. If using Docker images is more suitable for your operation, please give it a try:
https://gallery.ecr.aws/autifyhq/autifyconnect

How to use Docker Image

1. Use "--key" option

docker run --platform=linux/amd64 public.ecr.aws/autifyhq/autifyconnect:latest --key=[Access Point Key ]

2. Set environment variable（AUTIFY_CONNECT_KEY）

docker run --platform=linux/amd64 --env AUTIFY_CONNECT_KEY public.ecr.aws/autifyhq/autifyconnect:latest

Install Autify Connect Client

Linux / macOS

1. Unzip the file you downloaded.

2. Run the following command to see if it shows the help dialog. If it didn’t work you may have downloaded the app for a different environment.

   ./autifyconnect -h
   

3. Replace xxxxxx with the key of an access point and run the command. Your Autify Connect Client will establish a connection to Autify Connect Server so that it's ready to run tests.

   ./autifyconnect --key xxxxxx
   

Windows

1. Unzip the file you downloaded.

   If you see warning message during the download please ignore it and continue to download.

   For Chrome, click the allow icon right side of Discard button, then you will see the “Keep” option.

   

2. Launch cmd, powershell or windows terminal(store app) and execute the following command to see the option commands

   autifyconnect -h
   

   

   Note: when executing the client app, Windows Defender may show a protection notification or block the execution.

   

   In that case, you need to add the Connect Client to the exclusion list

   

3. Replace xxxxxx with the key of an access point and run the command. Your Autify Connect Client will establish a connection to Autify Connect Server so that it's ready to run tests.

   autifyconnect --key xxxxxx
   

4. Configure your Test Plan

1. Go to the test plan details page and click the ”Edit” button next to “Test scenarios”

   

2. You can find a field to configure an access point on the right side of the page. Select the access point you created.

   

3. Add the scenarios you created for private applications to the test plan.

5. Run the Test Plan

1. Launch Autify Connect Client on your system. Make sure that the connection with Autify Connect Server is successfully established.

   

2. Run the test plan from Test Plan page.

   

3. When a request is made from Autify Connect Server to the application through Autify Connect Client, details are output to the log if the client has been launched with -V option.

   

4. Once the test is complete, review the result. Note that your Access Point used for the test is displayed under "Autify Connect".