Set up credentials for running tests
Configure a service account so that Test Services runs tests under a fixed set of credentials rather than those of the person who starts the run. This page is for Test Services administrators who want consistent permissions for manual or scheduled tests, regardless of who triggers them.
Prerequisites
- You must have the Test Services Administrator role. (Credential settings are shaded for the Test Services User role.)
- You need the user name and password of the account you want tests to run under, validated in OpenLab Shared Services.
- (Optional) You need the Windows domain for the account if your site uses domain authentication.
By default, manual tests run under the credentials of the logged-in user, and scheduled tests run under the credentials of the user who created or last modified the schedule. The credentials you set here are shared with every Test Services instance connected to the same server.
The Credential Settings section is hidden on systems with no authentication configured, because every test already runs without login.
Configure a service account
You set the credentials for manual and scheduled tests separately, in the Credential Settings section of the Settings page. Configure either or both.
-
Click the Settings icon in the navigator.
-
Under Credential Settings, set the credentials for manual (ad hoc) tests:
- Leave Always use the following credentials for running user-initiated tests cleared to keep the default, where each manual test runs under the logged-in user's credentials.
- Select it to run all manual tests under a fixed account, then enter the account's Username and Password.
-
Set the credentials for scheduled tests:
- Leave Always use the following credentials for running scheduled tests cleared to keep the default, where each scheduled test runs under the credentials of the user who created or last modified the schedule.
- Select it to run all scheduled tests under a fixed account, then enter the account's Username and Password.
-
If a Domain field appears, select the domain for the account. (The field appears only when OpenLab Shared Services requires domain authentication.)
-
Click Save.
Test Services validates each enabled service account against OpenLab Shared Services. If validation fails, an error message appears next to the credential set that could not be verified.
How a service account appears in reports
When a service account runs a test, the Summary report and the test history record both the person who started the run and the account that ran it.
- The report shows Submitted by for the user who started the run and Executed by for the service account.
- The User column in the test history shows the account that actually ran the test.
You can switch between a service account and the default credentials at any time by changing the selection and clicking Save.
After a service account's password is changed in the domain or in OpenLab Shared Services, Test Services refreshes its access automatically, so you do not need to re-enter the password. You only need to update the credentials here if the account's user name changes.
On systems that use the OpenLab ECM 3.x storage backend, the service account password is stored separately and is not refreshed automatically. After the account's password changes, return to this page and save the credentials again; otherwise scheduled tests can stop running and manual tests report an ECM connection error.
See also
- Schedule tests: set up the automated runs that use the scheduled-test credentials.
- Set up email notifications: configure notifications on the same Settings page.
- Review the Summary report: see the Submitted by and Executed by fields a service account records.
- Roles and privileges: the administrator role required to change credential settings.
- About authentication: how Test Services validates credentials against OpenLab Shared Services.