Verified script execution for private locations

Private locations are an add-on feature for paid Synthetics accounts. For more information, contact your account representative or the New Relic sales desk.

Verified script execution allows you to secure your private minions, so that no one can assign scripted browsers or API tests to your minions without entering a pass phrase.

Pass phrase security

Your private minion's pass phrase is known only to you, and it is never stored in New Relic's collector. This restriction includes other users on your account and New Relic admins.

Because New Relic never stores your pass phrase, New Relic Support cannot recover or reset your pass phrase for you. If you forget your pass phrase, you will need to change it in the minion Overview page, and then update each monitor assigned to that private location.

Enable verified script execution

To enable verified script execution, you must enter a pass phrase in the minion Overview page, enable verified script execution for the associated private location, and enter the pass phrase at each monitor assigned to that location:

  1. In your web browser, navigate to the minion Overview page at http://MINION_IP_ADDRESS (for example, http://1.2.3.4).
  2. Select the pencil pencil icon, then select Advanced settings (optional).
  3. Select the Verified script execution checkbox. Type a pass phrase and record that pass phrase in a secure place. Select Save configuration.

  4. Go to synthetics.newrelic.com > Private locations > (select a private location). Select the pencil pencil icon, then select the Verified script execution checkbox. Select Save.
  5. From the Synthetics UI, select a monitor assigned to that location. Then select Settings > General.
  6. From the list of Private locations, select your location and type your pass phrase. Select Save changes.
  7. Repeat steps 5 and 6 for each monitor you want to assign to your location.

The Private locations index includes a VSE column. A lock lock icon indicates that verified script execution has been set up for that location.

Change your pass phrase

To change your pass phrase, enter the new pass phrase in the minion Overview page. Then update the pass phrase in the settings for each monitor assigned to that location.

  1. In your web browser, navigate to the minion Overview page at http://MINION_IP_ADDRESS (for example, http://1.2.3.4).
  2. Select the pencil pencil icon, and then select Advanced settings (optional).
  3. Type a pass phrase and record that pass phrase in a secure place. Select Save configuration.
  4. Go to synthetics.newrelic.com > (assigned monitor) > Settings > General.
  5. From the list of Private locations, select your location and type your new pass phrase. Select Save changes.
  6. Repeat steps 4 and 5 for each monitor assigned to your location.

Disable verified script execution

To disable verified script execution, you must disable the feature in the minion Overview page, and then turn it off in your private location settings.

  1. In your web browser, navigate to the minion Overview page at http://MINION_IP_ADDRESS (for example, http://1.2.3.4).
  2. Select the pencil pencil icon, then select Advanced settings (optional).
  3. Clear the Verified script execution checkbox, and select Save configuration.
  4. Go to synthetics.newrelic.com > Private locations > (select a private location). Clear the Verified script execution checkbox, and select Save.

For more help

Additional documentation resources include:

Recommendations for learning more: