Set up instance for Headless Browser in Microsoft Windows

Step 6 in the Microsoft Windows setup for the ServiceNow® Headless Browser for ATF: Set up your instance so it can support the Headless Browser.

Before you begin

Complete Step 5: Add secrets to Docker for Headless Browser setup in Microsoft Windows.

Role required: admin on your ServiceNow instance and local administrator on the host machine.

This task: Now that you have configured the host machine, you will set up the instance so that it successfully communicates and authenticates with the host machine.

Procedure

  1. Create user:
    1. Navigate to All > User Administration > Users and select New.
    2. Create a user - User ID, which can be whatever you want, as well as a user name and password. The password should be the same as the one you created for your Docker Secret container.
    3. Add the role atf_test_designer for this user. To learn more, see the User Roles section in the Exploring Automated Test Framework topic.
  2. Create certificate:
    1. Navigate to System Definition > Certificates to open the sys_ certificate table. Create a new certificate (the name can be whatever you prefer):
    2. Select the Attach (paper clip) icon to attach the keystore file you saved earlier to this record.
    3. Select Submit.
    4. Click Validate certificate and confirm that the success message displays.
  3. Create protocol profile:
    1. Navigate to System Security > Protocol Profiles to open the sys_protocol_profile table. Create a new protocol profile record:
      Option Description
      Protocol One word, lowercase: “docker”
      Default port 2376 (or the one you chose to use)
      Keystore Docker host keystore
    2. Select Submit.
  4. Create a Docker spoke connection:
    1. Navigate to Connections & Credentials > Connection & Credential Aliases to open the sys_alias table.
    2. Select the alias with the name Docker.
    3. Under the Connections related list, select New.
    4. Fill in these fields:
      • Name: Any text you prefer
      • Credential field: Leave blank
    5. Select the URL Builder check box.
    6. Select the Mutual authentication check box.
    7. In the Protocol profile field, select the protocol profile you created earlier.
    8. In the Host field, add the IP address or Host name of your server.
    9. Select Submit.
    The Connection URL is automatically created by the system.
  5. Modify properties:
    • com.glide.communications.httpclient.verify_hostname: false
    • com.glide.communications.trustmanager_trust_all: true
    Warning: By default, the com.glide.communications.trustmanager_trust_all property is set to false. The ServiceNow AI Platform trusts only certificates that it can verify against the JVM certificate store. Self-signed and enterprise-signed certificates are not trusted.

    You need to do this only when using self-signed certificates. To learn more, see Generate certificates for Headless Browser setup for Microsoft Windows.