Set up instance for Headless Browser in Linux
- UpdatedFeb 1, 2024
- 2 minutes to read
- Washington DC
- Automated Test Framework
Step 5 in the Linux 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 Linux
Role required: admin on your ServiceNow instance and local administrator on the host machine.
This task: Set up the instance so that it successfully communicates and authenticates with the host machine.
Procedure
-
Create user:
- Navigate to User Administration > Users and select New.
- 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.
- Add the role atf_test_designer for this user. (To learn more, see the User Roles section in the Test your apps with the ATF topic.)
-
Create certificate:
- Navigate to System Definition > Certificates to open the sys_ certificate
table. Create a new certificate (the name can be whatever you prefer):
- Type: Java Key Store
- Password: Password for the keystore that you created in Step 1 (Generate certificates for Headless Browser setup for Linux).
- Select the Attach (paper clip) icon to attach the keystore file you saved earlier to this record.
- Select Submit.
- Click Validate certificate and confirm that the success message displays.
- Navigate to System Definition > Certificates to open the sys_ certificate
table. Create a new certificate (the name can be whatever you prefer):
-
Create protocol profile:
- 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 - Select Submit.
- Navigate to System Security > Protocol Profiles to open the sys_protocol_profile
table. Create a new protocol profile record:
-
Create a Docker spoke connection:
- Navigate to Connections & Credentials > Connection & Credential Aliases to open the sys_alias table.
- Select the alias with the name Docker.
- Under the Connections related list, select New.
- Fill in these fields:
- Name: Any text you prefer
- Credential field: Leave blank
- Select the URL Builder check box.
- Select the Mutual authentication check box.
- In the Protocol profile field, select the protocol profile you created earlier.
- In the Host field, add the IP address or Host name of your server.
- Select Submit.
-
Modify properties:
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. To learn more, see the Certificate trust (instance security hardening) topic.Note: You need to do this only when using self-signed certificates. To learn more, see Generate certificates for Headless Browser setup for Linux.
com.glide.communications.httpclient.verify_hostname
: falsecom.glide.communications.trustmanager_trust_all
: true