Securing the communication with the remote Mac computer

When UFT One connects to a remote Mac computer, it can access Safari and perform steps on Web applications running in Safari. Therefore, it is important to secure this connection, to prevent inappropriate access to your Mac and Web pages that the Mac can access.

When UFT One communicates with the Mac, UFT One acts as a client and the Micro Focus UFT Agent Safari extension acts as a server. You can secure this communication on different levels.

Set up client authentication by defining a passphrase

UFT One uses a passphrase for initiating a connection with a Mac computer. The Mac computer accepts the connection request only if the passphrase included in the request matches the passphrase defined on the Mac side.

In the UFT One:

Define a passphrase in the Tools > Options > GUI Testing > Remote Connection pane. For details, see Remote Connection Pane (Options Dialog Box > GUI Testing Tab).

On the Mac:

Define the same passphrase in the Micro Focus UFT Agent Safari extension's preferences.

UFT One version 2022 and later: Define the same passphrase in the Micro Focus UFT Agent Safari extension's preferences.

UFT One version 2021 R1 and earlier: Define the same passphrase in the UFT Connection Agent's preferences.

By default, the passphrase is empty. To provide better security, provide a passphrase that is long, complicated, and difficult to guess.

You can define the same passphrase on multiple instances of UFT One and of the Safari extension, on the same computer, or in different user account on the same computer. This way, you can set up a group of computers that all share the same passphrase and are used for similar testing purposes (like a virtual lab).

Back to top

Secure the communication using SSL

To secure the communication using SSL, define the SSL settings both in UFT One and on the Mac computer.

On the Mac:

UFT One version 2022 and later: Set the following in the Micro Focus UFT Agent Safari extension preferences.

UFT One version 2021 R1 and earlier: Set the following in the UFT Connection Agent preferences.

  • Specify whether communications with this agent must take place over SSL connections (Use SSL)

  • If they must, then:

    • Specify the path to an SSL certificate file for the server to use for the communication. (Chain certificate files are also supported)

    • Specify the path to the SSL private key file that matches the certificate.

In UFT One:

  • In the Tools > Options > GUI Testing > Remote Connection pane, specify the path to an SSL CA certificate file that UFT One can use to validate the SSL certificate provided by the server. (Certificate bundles are also supported.)

    UFT One uses the CA certificate file for certificate validation only on connections initiated using SSL.

  • When defining the details for a specific remote connection, you specify whether the connection should use SSL. This can be done in the Remote Connection dialog box, in the Record and Run settings (on a per-test basis), or using the RemoteConnection utility method in a test step. For details, see Connect to a remote Mac computer.

  • For a connection to succeed:

    UFT One version 2022 and later: The Use SSL option must have the same value in UFT One and the Micro Focus UFT Agent Safari extension.

    UFT One version 2021 R1 and earlier: The Use SSL option must have the same value in UFT One and the UFT Connection Agent.

    At different times, UFT One can connect to different Micro Focus UFT Agent Safari extensions, by using different Mac or port numbers.

Back to top